Webhooks
ModelsExpand Collapse
MessageEventV2 { id, chat, direction, 14 more } Unified payload for message webhooks when using webhook_version: "2026-02-03".
This schema is used for message.sent, message.received, message.delivered, and message.read
events when the subscription URL includes ?version=2026-02-03.
Key differences from V1 (2025-01-01):
direction: “inbound” or “outbound” instead of is_from_me booleansender_handle: Full handle object for the senderchat: Nested object with id, is_group, and owner_handle- Message fields (
id, parts, effect, etc.) are at the top level, not nested in message
Timestamps indicate the message state:
message.sent: sent_at set, delivered_at=null, read_at=nullmessage.received: sent_at set, delivered_at=null, read_at=nullmessage.delivered: sent_at set, delivered_at set, read_at=nullmessage.read: sent_at set, delivered_at set, read_at set
Unified payload for message webhooks when using webhook_version: "2026-02-03".
This schema is used for message.sent, message.received, message.delivered, and message.read
events when the subscription URL includes ?version=2026-02-03.
Key differences from V1 (2025-01-01):
direction: “inbound” or “outbound” instead ofis_from_mebooleansender_handle: Full handle object for the senderchat: Nested object withid,is_group, andowner_handle- Message fields (
id,parts,effect, etc.) are at the top level, not nested inmessage
Timestamps indicate the message state:
message.sent: sent_at set, delivered_at=null, read_at=nullmessage.received: sent_at set, delivered_at=null, read_at=nullmessage.delivered: sent_at set, delivered_at set, read_at=nullmessage.read: sent_at set, delivered_at set, read_at set
chat: Chat { id, health_status, is_group, owner_handle } Chat information
Chat information
health_status: HealthStatus { doc_url, status, updated_at } [BETA] Current health for a chat. Always present — chats start at HEALTHY and may shift based on engagement and delivery signals on the conversation. Many AT_RISK or CRITICAL chats on a single line increase the risk of line flagging.
Switch on status to surface chat and line health in your UI — the enum is the long-term contract. Each status carries a doc_url that deep-links to the relevant section of the Chat Health guide. To gate a send, act on the response rather than the status: a 403 is the authoritative answer.
See the Chat Health guide for what each status means and how to react.
[BETA] Current health for a chat. Always present — chats start at HEALTHY and may shift based on engagement and delivery signals on the conversation. Many AT_RISK or CRITICAL chats on a single line increase the risk of line flagging.
Switch on status to surface chat and line health in your UI — the enum is the long-term contract. Each status carries a doc_url that deep-links to the relevant section of the Chat Health guide. To gate a send, act on the response rather than the status: a 403 is the authoritative answer.
See the Chat Health guide for what each status means and how to react.
status: "HEALTHY" | "AT_RISK" | "CRITICAL" | "OPTED_OUT"Current health bucket for the chat. See the Chat Health guide for what each value means and how to react. doc_url deep-links to the relevant section.
OPTED_OUT — the recipient sent STOP, UNSUBSCRIBE, OPTOUT, CANCEL, END, or QUIT.
The keyword must be the whole trimmed message, never part of a longer one: STOP counts, please stop
does not. Most keywords must match exactly, including case. OPT OUT is the exception — it matches in any
casing, with or without the space or a hyphen, so opt out, Opt-Out and optout all count. It clears as
soon as they reply again: any later message from them that is not itself an opt-out keyword opts them back
in immediately — a reply in any conversation with you counts, the same way the block does.
OPTED_OUT marks only the conversation the keyword arrived in. The block below is wider than the mark, so
a conversation still reading HEALTHY can be blocked as well — gate on the 403, not on the status.
Group threads are never marked and are never blocked.
Linq enforces this: while a recipient is opted out, every send to them is rejected with 403 (error code
2024) before the message is queued, across every chat and every line on your account. Nothing is
delivered, including a final courtesy message — to send one, set override_optout: true on that single
request.
Current health bucket for the chat. See the Chat Health guide for what each value means and how to react. doc_url deep-links to the relevant section.
OPTED_OUT — the recipient sent STOP, UNSUBSCRIBE, OPTOUT, CANCEL, END, or QUIT.
The keyword must be the whole trimmed message, never part of a longer one: STOP counts, please stop
does not. Most keywords must match exactly, including case. OPT OUT is the exception — it matches in any
casing, with or without the space or a hyphen, so opt out, Opt-Out and optout all count. It clears as
soon as they reply again: any later message from them that is not itself an opt-out keyword opts them back
in immediately — a reply in any conversation with you counts, the same way the block does.
OPTED_OUT marks only the conversation the keyword arrived in. The block below is wider than the mark, so
a conversation still reading HEALTHY can be blocked as well — gate on the 403, not on the status.
Group threads are never marked and are never blocked.
Linq enforces this: while a recipient is opted out, every send to them is rejected with 403 (error code
2024) before the message is queued, across every chat and every line on your account. Nothing is
delivered, including a final courtesy message — to send one, set override_optout: true on that single
request.
Your phone number’s handle. Always has is_me=true.
Your phone number’s handle. Always has is_me=true.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
line_type?: "iMessage" | "RCS"The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
direction: "inbound" | "outbound"Message direction - “outbound” if sent by you, “inbound” if received
Message direction - “outbound” if sent by you, “inbound” if received
parts: Array<SchemasTextPartResponse { type, value, inline_stickers, 4 more } | SchemasMediaPartResponse { id, filename, mime_type, 3 more } | SchemasLinkPartResponse { type, value } | 2 more>Message parts (text and/or media)
Message parts (text and/or media)
SchemasTextPartResponse { type, value, inline_stickers, 4 more } A text message part
A text message part
Stickers placed inside the text, in the order they appear in value. null when the
part has none.
Set on messages sent with inline_stickers. An inline sticker received over iMessage
currently arrives as a separate media part.
Stickers placed inside the text, in the order they appear in value. null when the
part has none.
Set on messages sent with inline_stickers. An inline sticker received over iMessage
currently arrives as a separate media part.
DEPRECATED: Use mentions instead. Handle (E.164 phone number or Apple ID email)
of the first mention on this part. A part may carry several mentions; this
field shows only the first in value order, so it cannot be used to determine
whether a given participant was mentioned. null when the part carries no mention.
DEPRECATED: Use mentions[].range instead. Character range [start, end) in
value highlighted as the first mention only. null when the range was
omitted (the whole value is highlighted) or the part carries no mention.
Characters are measured as UTF-16 code units. Most characters count as 1; some emoji count as 2.
mentions?: Array<Mention> | nullEvery mention on this part, in the order they appear in value. null when the
part carries no mention. A part can carry several mentions of different people —
check is_me to tell whether this line was one of them.
Only iMessage carries mentions. On a received message this is populated when the
sender was on iMessage; SMS and RCS have no way to mark a mention, so a message
from an SMS or RCS participant arrives as plain text with mentions null, even in
a group where other participants are on iMessage.
Every mention on this part, in the order they appear in value. null when the
part carries no mention. A part can carry several mentions of different people —
check is_me to tell whether this line was one of them.
Only iMessage carries mentions. On a received message this is populated when the
sender was on iMessage; SMS and RCS have no way to mark a mention, so a message
from an SMS or RCS participant arrives as plain text with mentions null, even in
a group where other participants are on iMessage.
Text decorations applied to character ranges in the value
Text decorations applied to character ranges in the value
Character range [start, end) in the value string where the decoration applies.
start is inclusive, end is exclusive.
Characters are measured as UTF-16 code units. Most characters count as 1; some emoji count as 2.
SchemasIMessageAppPartResponse { app, layout, type, 2 more } An iMessage app card part.
An iMessage app card part.
The handle that sent this message
The handle that sent this message
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
line_type?: "iMessage" | "RCS"The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
When the message was delivered. Null if not yet delivered.
When the sending device was first seen for this sender (the message time for a newly seen device). Absent for SMS/RCS and for outbound messages.
device_status?: "first_contact" | "known" | "new" | nullThe device a sender used, relative to devices we’ve seen from them before. first_contact = their first device (first message we’ve seen from this sender); known = a device we’ve seen before; new = a device we have NOT seen for a sender who already had one (the account/SIM-takeover signal).
The device a sender used, relative to devices we’ve seen from them before. first_contact = their first device (first message we’ve seen from this sender); known = a device we’ve seen before; new = a device we have NOT seen for a sender who already had one (the account/SIM-takeover signal).
Deprecatedpreferred_service?: "iMessage" | "SMS" | "RCS" | "auto" | nullPreferred messaging service type. Includes “auto” for default fallback behavior.
Preferred messaging service type. Includes “auto” for default fallback behavior.
Present only when this message was recovered by reconciliation rather than delivered live, and set to the time of that recovery. The field is omitted entirely for normally-delivered messages, which is the overwhelming majority. When present, expect sent_at to be substantially earlier than delivery of this event: the message is genuine but is arriving late and out of real-time order, so treat it as history rather than as a live inbound (for example, suppress auto-replies).
MessagePayload { id, created_at, delivered_at, 12 more } Message content nested within webhook events
Message content nested within webhook events
When the sending device was first seen for this sender (the message time for a newly seen device). Absent for SMS/RCS and for outbound messages.
device_status?: "first_contact" | "known" | "new" | nullThe device a sender used, relative to devices we’ve seen from them before. first_contact = their first device (first message we’ve seen from this sender); known = a device we’ve seen before; new = a device we have NOT seen for a sender who already had one (the account/SIM-takeover signal).
The device a sender used, relative to devices we’ve seen from them before. first_contact = their first device (first message we’ve seen from this sender); known = a device we’ve seen before; new = a device we have NOT seen for a sender who already had one (the account/SIM-takeover signal).
parts?: Array<SchemasTextPartResponse { type, value, inline_stickers, 4 more } | SchemasMediaPartResponse { id, filename, mime_type, 3 more } | SchemasLinkPartResponse { type, value } | 2 more>Message content parts (text and/or media)
Message content parts (text and/or media)
SchemasTextPartResponse { type, value, inline_stickers, 4 more } A text message part
A text message part
Stickers placed inside the text, in the order they appear in value. null when the
part has none.
Set on messages sent with inline_stickers. An inline sticker received over iMessage
currently arrives as a separate media part.
Stickers placed inside the text, in the order they appear in value. null when the
part has none.
Set on messages sent with inline_stickers. An inline sticker received over iMessage
currently arrives as a separate media part.
DEPRECATED: Use mentions instead. Handle (E.164 phone number or Apple ID email)
of the first mention on this part. A part may carry several mentions; this
field shows only the first in value order, so it cannot be used to determine
whether a given participant was mentioned. null when the part carries no mention.
DEPRECATED: Use mentions[].range instead. Character range [start, end) in
value highlighted as the first mention only. null when the range was
omitted (the whole value is highlighted) or the part carries no mention.
Characters are measured as UTF-16 code units. Most characters count as 1; some emoji count as 2.
mentions?: Array<Mention> | nullEvery mention on this part, in the order they appear in value. null when the
part carries no mention. A part can carry several mentions of different people —
check is_me to tell whether this line was one of them.
Only iMessage carries mentions. On a received message this is populated when the
sender was on iMessage; SMS and RCS have no way to mark a mention, so a message
from an SMS or RCS participant arrives as plain text with mentions null, even in
a group where other participants are on iMessage.
Every mention on this part, in the order they appear in value. null when the
part carries no mention. A part can carry several mentions of different people —
check is_me to tell whether this line was one of them.
Only iMessage carries mentions. On a received message this is populated when the
sender was on iMessage; SMS and RCS have no way to mark a mention, so a message
from an SMS or RCS participant arrives as plain text with mentions null, even in
a group where other participants are on iMessage.
Text decorations applied to character ranges in the value
Text decorations applied to character ranges in the value
Character range [start, end) in the value string where the decoration applies.
start is inclusive, end is exclusive.
Characters are measured as UTF-16 code units. Most characters count as 1; some emoji count as 2.
SchemasIMessageAppPartResponse { app, layout, type, 2 more } An iMessage app card part.
An iMessage app card part.
Present only when this message was recovered by reconciliation rather than delivered live, and set to the time of that recovery. The field is omitted entirely for normally-delivered messages, which is the overwhelming majority. When present, expect sent_at to be substantially earlier than delivery of this event: the message is genuine but is arriving late and out of real-time order, so treat it as history rather than as a live inbound (for example, suppress auto-replies).
ReactionEventBase { is_from_me, reaction_type, chat_id, 9 more }
Whether this reaction was from the owner of the phone number (true) or from someone else (false)
Type of reaction. Standard iMessage tapbacks are love, like, dislike, laugh, emphasize, question.
Custom emoji reactions have type “custom” with the actual emoji in the custom_emoji field.
Sticker reactions have type “sticker” with sticker attachment details in the sticker field.
Type of reaction. Standard iMessage tapbacks are love, like, dislike, laugh, emphasize, question. Custom emoji reactions have type “custom” with the actual emoji in the custom_emoji field. Sticker reactions have type “sticker” with sticker attachment details in the sticker field.
The actual emoji when reaction_type is “custom”. Null for standard tapbacks.
DEPRECATED: Use from_handle instead. Phone number or email address of the person who added/removed the reaction.
The person who added/removed the reaction as a full handle object
The person who added/removed the reaction as a full handle object
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
line_type?: "iMessage" | "RCS"The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
Identifier for this reaction. Pass it to
PATCH /v3/messages/{messageId}/reactions/{reactionId} to move a sticker.
Stickers stack, so this is what distinguishes one sticker from another on the
same message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
SchemasTextPartResponse { type, value, inline_stickers, 4 more } A text message part
A text message part
Stickers placed inside the text, in the order they appear in value. null when the
part has none.
Set on messages sent with inline_stickers. An inline sticker received over iMessage
currently arrives as a separate media part.
Stickers placed inside the text, in the order they appear in value. null when the
part has none.
Set on messages sent with inline_stickers. An inline sticker received over iMessage
currently arrives as a separate media part.
DEPRECATED: Use mentions instead. Handle (E.164 phone number or Apple ID email)
of the first mention on this part. A part may carry several mentions; this
field shows only the first in value order, so it cannot be used to determine
whether a given participant was mentioned. null when the part carries no mention.
DEPRECATED: Use mentions[].range instead. Character range [start, end) in
value highlighted as the first mention only. null when the range was
omitted (the whole value is highlighted) or the part carries no mention.
Characters are measured as UTF-16 code units. Most characters count as 1; some emoji count as 2.
mentions?: Array<Mention> | nullEvery mention on this part, in the order they appear in value. null when the
part carries no mention. A part can carry several mentions of different people —
check is_me to tell whether this line was one of them.
Only iMessage carries mentions. On a received message this is populated when the
sender was on iMessage; SMS and RCS have no way to mark a mention, so a message
from an SMS or RCS participant arrives as plain text with mentions null, even in
a group where other participants are on iMessage.
Every mention on this part, in the order they appear in value. null when the
part carries no mention. A part can carry several mentions of different people —
check is_me to tell whether this line was one of them.
Only iMessage carries mentions. On a received message this is populated when the
sender was on iMessage; SMS and RCS have no way to mark a mention, so a message
from an SMS or RCS participant arrives as plain text with mentions null, even in
a group where other participants are on iMessage.
Text decorations applied to character ranges in the value
Text decorations applied to character ranges in the value
Character range [start, end) in the value string where the decoration applies.
start is inclusive, end is exclusive.
Characters are measured as UTF-16 code units. Most characters count as 1; some emoji count as 2.
MessageSentWebhookEvent { api_version, created_at, data, 5 more } Complete webhook payload for message.sent events (2026-02-03 format)
Complete webhook payload for message.sent events (2026-02-03 format)
Unified payload for message webhooks when using webhook_version: "2026-02-03".
This schema is used for message.sent, message.received, message.delivered, and message.read
events when the subscription URL includes ?version=2026-02-03.
Key differences from V1 (2025-01-01):
direction: “inbound” or “outbound” instead of is_from_me booleansender_handle: Full handle object for the senderchat: Nested object with id, is_group, and owner_handle- Message fields (
id, parts, effect, etc.) are at the top level, not nested in message
Timestamps indicate the message state:
message.sent: sent_at set, delivered_at=null, read_at=nullmessage.received: sent_at set, delivered_at=null, read_at=nullmessage.delivered: sent_at set, delivered_at set, read_at=nullmessage.read: sent_at set, delivered_at set, read_at set
Unified payload for message webhooks when using webhook_version: "2026-02-03".
This schema is used for message.sent, message.received, message.delivered, and message.read
events when the subscription URL includes ?version=2026-02-03.
Key differences from V1 (2025-01-01):
direction: “inbound” or “outbound” instead ofis_from_mebooleansender_handle: Full handle object for the senderchat: Nested object withid,is_group, andowner_handle- Message fields (
id,parts,effect, etc.) are at the top level, not nested inmessage
Timestamps indicate the message state:
message.sent: sent_at set, delivered_at=null, read_at=nullmessage.received: sent_at set, delivered_at=null, read_at=nullmessage.delivered: sent_at set, delivered_at set, read_at=nullmessage.read: sent_at set, delivered_at set, read_at set
chat: Chat { id, health_status, is_group, owner_handle } Chat information
Chat information
health_status: HealthStatus { doc_url, status, updated_at } [BETA] Current health for a chat. Always present — chats start at HEALTHY and may shift based on engagement and delivery signals on the conversation. Many AT_RISK or CRITICAL chats on a single line increase the risk of line flagging.
Switch on status to surface chat and line health in your UI — the enum is the long-term contract. Each status carries a doc_url that deep-links to the relevant section of the Chat Health guide. To gate a send, act on the response rather than the status: a 403 is the authoritative answer.
See the Chat Health guide for what each status means and how to react.
[BETA] Current health for a chat. Always present — chats start at HEALTHY and may shift based on engagement and delivery signals on the conversation. Many AT_RISK or CRITICAL chats on a single line increase the risk of line flagging.
Switch on status to surface chat and line health in your UI — the enum is the long-term contract. Each status carries a doc_url that deep-links to the relevant section of the Chat Health guide. To gate a send, act on the response rather than the status: a 403 is the authoritative answer.
See the Chat Health guide for what each status means and how to react.
status: "HEALTHY" | "AT_RISK" | "CRITICAL" | "OPTED_OUT"Current health bucket for the chat. See the Chat Health guide for what each value means and how to react. doc_url deep-links to the relevant section.
OPTED_OUT — the recipient sent STOP, UNSUBSCRIBE, OPTOUT, CANCEL, END, or QUIT.
The keyword must be the whole trimmed message, never part of a longer one: STOP counts, please stop
does not. Most keywords must match exactly, including case. OPT OUT is the exception — it matches in any
casing, with or without the space or a hyphen, so opt out, Opt-Out and optout all count. It clears as
soon as they reply again: any later message from them that is not itself an opt-out keyword opts them back
in immediately — a reply in any conversation with you counts, the same way the block does.
OPTED_OUT marks only the conversation the keyword arrived in. The block below is wider than the mark, so
a conversation still reading HEALTHY can be blocked as well — gate on the 403, not on the status.
Group threads are never marked and are never blocked.
Linq enforces this: while a recipient is opted out, every send to them is rejected with 403 (error code
2024) before the message is queued, across every chat and every line on your account. Nothing is
delivered, including a final courtesy message — to send one, set override_optout: true on that single
request.
Current health bucket for the chat. See the Chat Health guide for what each value means and how to react. doc_url deep-links to the relevant section.
OPTED_OUT — the recipient sent STOP, UNSUBSCRIBE, OPTOUT, CANCEL, END, or QUIT.
The keyword must be the whole trimmed message, never part of a longer one: STOP counts, please stop
does not. Most keywords must match exactly, including case. OPT OUT is the exception — it matches in any
casing, with or without the space or a hyphen, so opt out, Opt-Out and optout all count. It clears as
soon as they reply again: any later message from them that is not itself an opt-out keyword opts them back
in immediately — a reply in any conversation with you counts, the same way the block does.
OPTED_OUT marks only the conversation the keyword arrived in. The block below is wider than the mark, so
a conversation still reading HEALTHY can be blocked as well — gate on the 403, not on the status.
Group threads are never marked and are never blocked.
Linq enforces this: while a recipient is opted out, every send to them is rejected with 403 (error code
2024) before the message is queued, across every chat and every line on your account. Nothing is
delivered, including a final courtesy message — to send one, set override_optout: true on that single
request.
Your phone number’s handle. Always has is_me=true.
Your phone number’s handle. Always has is_me=true.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
line_type?: "iMessage" | "RCS"The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
direction: "inbound" | "outbound"Message direction - “outbound” if sent by you, “inbound” if received
Message direction - “outbound” if sent by you, “inbound” if received
parts: Array<SchemasTextPartResponse { type, value, inline_stickers, 4 more } | SchemasMediaPartResponse { id, filename, mime_type, 3 more } | SchemasLinkPartResponse { type, value } | 2 more>Message parts (text and/or media)
Message parts (text and/or media)
SchemasTextPartResponse { type, value, inline_stickers, 4 more } A text message part
A text message part
Stickers placed inside the text, in the order they appear in value. null when the
part has none.
Set on messages sent with inline_stickers. An inline sticker received over iMessage
currently arrives as a separate media part.
Stickers placed inside the text, in the order they appear in value. null when the
part has none.
Set on messages sent with inline_stickers. An inline sticker received over iMessage
currently arrives as a separate media part.
DEPRECATED: Use mentions instead. Handle (E.164 phone number or Apple ID email)
of the first mention on this part. A part may carry several mentions; this
field shows only the first in value order, so it cannot be used to determine
whether a given participant was mentioned. null when the part carries no mention.
DEPRECATED: Use mentions[].range instead. Character range [start, end) in
value highlighted as the first mention only. null when the range was
omitted (the whole value is highlighted) or the part carries no mention.
Characters are measured as UTF-16 code units. Most characters count as 1; some emoji count as 2.
mentions?: Array<Mention> | nullEvery mention on this part, in the order they appear in value. null when the
part carries no mention. A part can carry several mentions of different people —
check is_me to tell whether this line was one of them.
Only iMessage carries mentions. On a received message this is populated when the
sender was on iMessage; SMS and RCS have no way to mark a mention, so a message
from an SMS or RCS participant arrives as plain text with mentions null, even in
a group where other participants are on iMessage.
Every mention on this part, in the order they appear in value. null when the
part carries no mention. A part can carry several mentions of different people —
check is_me to tell whether this line was one of them.
Only iMessage carries mentions. On a received message this is populated when the
sender was on iMessage; SMS and RCS have no way to mark a mention, so a message
from an SMS or RCS participant arrives as plain text with mentions null, even in
a group where other participants are on iMessage.
Text decorations applied to character ranges in the value
Text decorations applied to character ranges in the value
Character range [start, end) in the value string where the decoration applies.
start is inclusive, end is exclusive.
Characters are measured as UTF-16 code units. Most characters count as 1; some emoji count as 2.
SchemasIMessageAppPartResponse { app, layout, type, 2 more } An iMessage app card part.
An iMessage app card part.
The handle that sent this message
The handle that sent this message
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
line_type?: "iMessage" | "RCS"The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
When the message was delivered. Null if not yet delivered.
When the sending device was first seen for this sender (the message time for a newly seen device). Absent for SMS/RCS and for outbound messages.
device_status?: "first_contact" | "known" | "new" | nullThe device a sender used, relative to devices we’ve seen from them before. first_contact = their first device (first message we’ve seen from this sender); known = a device we’ve seen before; new = a device we have NOT seen for a sender who already had one (the account/SIM-takeover signal).
The device a sender used, relative to devices we’ve seen from them before. first_contact = their first device (first message we’ve seen from this sender); known = a device we’ve seen before; new = a device we have NOT seen for a sender who already had one (the account/SIM-takeover signal).
Deprecatedpreferred_service?: "iMessage" | "SMS" | "RCS" | "auto" | nullPreferred messaging service type. Includes “auto” for default fallback behavior.
Preferred messaging service type. Includes “auto” for default fallback behavior.
Present only when this message was recovered by reconciliation rather than delivered live, and set to the time of that recovery. The field is omitted entirely for normally-delivered messages, which is the overwhelming majority. When present, expect sent_at to be substantially earlier than delivery of this event: the message is genuine but is arriving late and out of real-time order, so treat it as history rather than as a live inbound (for example, suppress auto-replies).
MessageReceivedWebhookEvent { api_version, created_at, data, 5 more } Complete webhook payload for message.received events (2026-02-03 format)
Complete webhook payload for message.received events (2026-02-03 format)
Unified payload for message webhooks when using webhook_version: "2026-02-03".
This schema is used for message.sent, message.received, message.delivered, and message.read
events when the subscription URL includes ?version=2026-02-03.
Key differences from V1 (2025-01-01):
direction: “inbound” or “outbound” instead of is_from_me booleansender_handle: Full handle object for the senderchat: Nested object with id, is_group, and owner_handle- Message fields (
id, parts, effect, etc.) are at the top level, not nested in message
Timestamps indicate the message state:
message.sent: sent_at set, delivered_at=null, read_at=nullmessage.received: sent_at set, delivered_at=null, read_at=nullmessage.delivered: sent_at set, delivered_at set, read_at=nullmessage.read: sent_at set, delivered_at set, read_at set
Unified payload for message webhooks when using webhook_version: "2026-02-03".
This schema is used for message.sent, message.received, message.delivered, and message.read
events when the subscription URL includes ?version=2026-02-03.
Key differences from V1 (2025-01-01):
direction: “inbound” or “outbound” instead ofis_from_mebooleansender_handle: Full handle object for the senderchat: Nested object withid,is_group, andowner_handle- Message fields (
id,parts,effect, etc.) are at the top level, not nested inmessage
Timestamps indicate the message state:
message.sent: sent_at set, delivered_at=null, read_at=nullmessage.received: sent_at set, delivered_at=null, read_at=nullmessage.delivered: sent_at set, delivered_at set, read_at=nullmessage.read: sent_at set, delivered_at set, read_at set
chat: Chat { id, health_status, is_group, owner_handle } Chat information
Chat information
health_status: HealthStatus { doc_url, status, updated_at } [BETA] Current health for a chat. Always present — chats start at HEALTHY and may shift based on engagement and delivery signals on the conversation. Many AT_RISK or CRITICAL chats on a single line increase the risk of line flagging.
Switch on status to surface chat and line health in your UI — the enum is the long-term contract. Each status carries a doc_url that deep-links to the relevant section of the Chat Health guide. To gate a send, act on the response rather than the status: a 403 is the authoritative answer.
See the Chat Health guide for what each status means and how to react.
[BETA] Current health for a chat. Always present — chats start at HEALTHY and may shift based on engagement and delivery signals on the conversation. Many AT_RISK or CRITICAL chats on a single line increase the risk of line flagging.
Switch on status to surface chat and line health in your UI — the enum is the long-term contract. Each status carries a doc_url that deep-links to the relevant section of the Chat Health guide. To gate a send, act on the response rather than the status: a 403 is the authoritative answer.
See the Chat Health guide for what each status means and how to react.
status: "HEALTHY" | "AT_RISK" | "CRITICAL" | "OPTED_OUT"Current health bucket for the chat. See the Chat Health guide for what each value means and how to react. doc_url deep-links to the relevant section.
OPTED_OUT — the recipient sent STOP, UNSUBSCRIBE, OPTOUT, CANCEL, END, or QUIT.
The keyword must be the whole trimmed message, never part of a longer one: STOP counts, please stop
does not. Most keywords must match exactly, including case. OPT OUT is the exception — it matches in any
casing, with or without the space or a hyphen, so opt out, Opt-Out and optout all count. It clears as
soon as they reply again: any later message from them that is not itself an opt-out keyword opts them back
in immediately — a reply in any conversation with you counts, the same way the block does.
OPTED_OUT marks only the conversation the keyword arrived in. The block below is wider than the mark, so
a conversation still reading HEALTHY can be blocked as well — gate on the 403, not on the status.
Group threads are never marked and are never blocked.
Linq enforces this: while a recipient is opted out, every send to them is rejected with 403 (error code
2024) before the message is queued, across every chat and every line on your account. Nothing is
delivered, including a final courtesy message — to send one, set override_optout: true on that single
request.
Current health bucket for the chat. See the Chat Health guide for what each value means and how to react. doc_url deep-links to the relevant section.
OPTED_OUT — the recipient sent STOP, UNSUBSCRIBE, OPTOUT, CANCEL, END, or QUIT.
The keyword must be the whole trimmed message, never part of a longer one: STOP counts, please stop
does not. Most keywords must match exactly, including case. OPT OUT is the exception — it matches in any
casing, with or without the space or a hyphen, so opt out, Opt-Out and optout all count. It clears as
soon as they reply again: any later message from them that is not itself an opt-out keyword opts them back
in immediately — a reply in any conversation with you counts, the same way the block does.
OPTED_OUT marks only the conversation the keyword arrived in. The block below is wider than the mark, so
a conversation still reading HEALTHY can be blocked as well — gate on the 403, not on the status.
Group threads are never marked and are never blocked.
Linq enforces this: while a recipient is opted out, every send to them is rejected with 403 (error code
2024) before the message is queued, across every chat and every line on your account. Nothing is
delivered, including a final courtesy message — to send one, set override_optout: true on that single
request.
Your phone number’s handle. Always has is_me=true.
Your phone number’s handle. Always has is_me=true.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
line_type?: "iMessage" | "RCS"The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
direction: "inbound" | "outbound"Message direction - “outbound” if sent by you, “inbound” if received
Message direction - “outbound” if sent by you, “inbound” if received
parts: Array<SchemasTextPartResponse { type, value, inline_stickers, 4 more } | SchemasMediaPartResponse { id, filename, mime_type, 3 more } | SchemasLinkPartResponse { type, value } | 2 more>Message parts (text and/or media)
Message parts (text and/or media)
SchemasTextPartResponse { type, value, inline_stickers, 4 more } A text message part
A text message part
Stickers placed inside the text, in the order they appear in value. null when the
part has none.
Set on messages sent with inline_stickers. An inline sticker received over iMessage
currently arrives as a separate media part.
Stickers placed inside the text, in the order they appear in value. null when the
part has none.
Set on messages sent with inline_stickers. An inline sticker received over iMessage
currently arrives as a separate media part.
DEPRECATED: Use mentions instead. Handle (E.164 phone number or Apple ID email)
of the first mention on this part. A part may carry several mentions; this
field shows only the first in value order, so it cannot be used to determine
whether a given participant was mentioned. null when the part carries no mention.
DEPRECATED: Use mentions[].range instead. Character range [start, end) in
value highlighted as the first mention only. null when the range was
omitted (the whole value is highlighted) or the part carries no mention.
Characters are measured as UTF-16 code units. Most characters count as 1; some emoji count as 2.
mentions?: Array<Mention> | nullEvery mention on this part, in the order they appear in value. null when the
part carries no mention. A part can carry several mentions of different people —
check is_me to tell whether this line was one of them.
Only iMessage carries mentions. On a received message this is populated when the
sender was on iMessage; SMS and RCS have no way to mark a mention, so a message
from an SMS or RCS participant arrives as plain text with mentions null, even in
a group where other participants are on iMessage.
Every mention on this part, in the order they appear in value. null when the
part carries no mention. A part can carry several mentions of different people —
check is_me to tell whether this line was one of them.
Only iMessage carries mentions. On a received message this is populated when the
sender was on iMessage; SMS and RCS have no way to mark a mention, so a message
from an SMS or RCS participant arrives as plain text with mentions null, even in
a group where other participants are on iMessage.
Text decorations applied to character ranges in the value
Text decorations applied to character ranges in the value
Character range [start, end) in the value string where the decoration applies.
start is inclusive, end is exclusive.
Characters are measured as UTF-16 code units. Most characters count as 1; some emoji count as 2.
SchemasIMessageAppPartResponse { app, layout, type, 2 more } An iMessage app card part.
An iMessage app card part.
The handle that sent this message
The handle that sent this message
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
line_type?: "iMessage" | "RCS"The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
When the message was delivered. Null if not yet delivered.
When the sending device was first seen for this sender (the message time for a newly seen device). Absent for SMS/RCS and for outbound messages.
device_status?: "first_contact" | "known" | "new" | nullThe device a sender used, relative to devices we’ve seen from them before. first_contact = their first device (first message we’ve seen from this sender); known = a device we’ve seen before; new = a device we have NOT seen for a sender who already had one (the account/SIM-takeover signal).
The device a sender used, relative to devices we’ve seen from them before. first_contact = their first device (first message we’ve seen from this sender); known = a device we’ve seen before; new = a device we have NOT seen for a sender who already had one (the account/SIM-takeover signal).
Deprecatedpreferred_service?: "iMessage" | "SMS" | "RCS" | "auto" | nullPreferred messaging service type. Includes “auto” for default fallback behavior.
Preferred messaging service type. Includes “auto” for default fallback behavior.
Present only when this message was recovered by reconciliation rather than delivered live, and set to the time of that recovery. The field is omitted entirely for normally-delivered messages, which is the overwhelming majority. When present, expect sent_at to be substantially earlier than delivery of this event: the message is genuine but is arriving late and out of real-time order, so treat it as history rather than as a live inbound (for example, suppress auto-replies).
MessageReadWebhookEvent { api_version, created_at, data, 5 more } Complete webhook payload for message.read events (2026-02-03 format)
Complete webhook payload for message.read events (2026-02-03 format)
Unified payload for message webhooks when using webhook_version: "2026-02-03".
This schema is used for message.sent, message.received, message.delivered, and message.read
events when the subscription URL includes ?version=2026-02-03.
Key differences from V1 (2025-01-01):
direction: “inbound” or “outbound” instead of is_from_me booleansender_handle: Full handle object for the senderchat: Nested object with id, is_group, and owner_handle- Message fields (
id, parts, effect, etc.) are at the top level, not nested in message
Timestamps indicate the message state:
message.sent: sent_at set, delivered_at=null, read_at=nullmessage.received: sent_at set, delivered_at=null, read_at=nullmessage.delivered: sent_at set, delivered_at set, read_at=nullmessage.read: sent_at set, delivered_at set, read_at set
Unified payload for message webhooks when using webhook_version: "2026-02-03".
This schema is used for message.sent, message.received, message.delivered, and message.read
events when the subscription URL includes ?version=2026-02-03.
Key differences from V1 (2025-01-01):
direction: “inbound” or “outbound” instead ofis_from_mebooleansender_handle: Full handle object for the senderchat: Nested object withid,is_group, andowner_handle- Message fields (
id,parts,effect, etc.) are at the top level, not nested inmessage
Timestamps indicate the message state:
message.sent: sent_at set, delivered_at=null, read_at=nullmessage.received: sent_at set, delivered_at=null, read_at=nullmessage.delivered: sent_at set, delivered_at set, read_at=nullmessage.read: sent_at set, delivered_at set, read_at set
chat: Chat { id, health_status, is_group, owner_handle } Chat information
Chat information
health_status: HealthStatus { doc_url, status, updated_at } [BETA] Current health for a chat. Always present — chats start at HEALTHY and may shift based on engagement and delivery signals on the conversation. Many AT_RISK or CRITICAL chats on a single line increase the risk of line flagging.
Switch on status to surface chat and line health in your UI — the enum is the long-term contract. Each status carries a doc_url that deep-links to the relevant section of the Chat Health guide. To gate a send, act on the response rather than the status: a 403 is the authoritative answer.
See the Chat Health guide for what each status means and how to react.
[BETA] Current health for a chat. Always present — chats start at HEALTHY and may shift based on engagement and delivery signals on the conversation. Many AT_RISK or CRITICAL chats on a single line increase the risk of line flagging.
Switch on status to surface chat and line health in your UI — the enum is the long-term contract. Each status carries a doc_url that deep-links to the relevant section of the Chat Health guide. To gate a send, act on the response rather than the status: a 403 is the authoritative answer.
See the Chat Health guide for what each status means and how to react.
status: "HEALTHY" | "AT_RISK" | "CRITICAL" | "OPTED_OUT"Current health bucket for the chat. See the Chat Health guide for what each value means and how to react. doc_url deep-links to the relevant section.
OPTED_OUT — the recipient sent STOP, UNSUBSCRIBE, OPTOUT, CANCEL, END, or QUIT.
The keyword must be the whole trimmed message, never part of a longer one: STOP counts, please stop
does not. Most keywords must match exactly, including case. OPT OUT is the exception — it matches in any
casing, with or without the space or a hyphen, so opt out, Opt-Out and optout all count. It clears as
soon as they reply again: any later message from them that is not itself an opt-out keyword opts them back
in immediately — a reply in any conversation with you counts, the same way the block does.
OPTED_OUT marks only the conversation the keyword arrived in. The block below is wider than the mark, so
a conversation still reading HEALTHY can be blocked as well — gate on the 403, not on the status.
Group threads are never marked and are never blocked.
Linq enforces this: while a recipient is opted out, every send to them is rejected with 403 (error code
2024) before the message is queued, across every chat and every line on your account. Nothing is
delivered, including a final courtesy message — to send one, set override_optout: true on that single
request.
Current health bucket for the chat. See the Chat Health guide for what each value means and how to react. doc_url deep-links to the relevant section.
OPTED_OUT — the recipient sent STOP, UNSUBSCRIBE, OPTOUT, CANCEL, END, or QUIT.
The keyword must be the whole trimmed message, never part of a longer one: STOP counts, please stop
does not. Most keywords must match exactly, including case. OPT OUT is the exception — it matches in any
casing, with or without the space or a hyphen, so opt out, Opt-Out and optout all count. It clears as
soon as they reply again: any later message from them that is not itself an opt-out keyword opts them back
in immediately — a reply in any conversation with you counts, the same way the block does.
OPTED_OUT marks only the conversation the keyword arrived in. The block below is wider than the mark, so
a conversation still reading HEALTHY can be blocked as well — gate on the 403, not on the status.
Group threads are never marked and are never blocked.
Linq enforces this: while a recipient is opted out, every send to them is rejected with 403 (error code
2024) before the message is queued, across every chat and every line on your account. Nothing is
delivered, including a final courtesy message — to send one, set override_optout: true on that single
request.
Your phone number’s handle. Always has is_me=true.
Your phone number’s handle. Always has is_me=true.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
line_type?: "iMessage" | "RCS"The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
direction: "inbound" | "outbound"Message direction - “outbound” if sent by you, “inbound” if received
Message direction - “outbound” if sent by you, “inbound” if received
parts: Array<SchemasTextPartResponse { type, value, inline_stickers, 4 more } | SchemasMediaPartResponse { id, filename, mime_type, 3 more } | SchemasLinkPartResponse { type, value } | 2 more>Message parts (text and/or media)
Message parts (text and/or media)
SchemasTextPartResponse { type, value, inline_stickers, 4 more } A text message part
A text message part
Stickers placed inside the text, in the order they appear in value. null when the
part has none.
Set on messages sent with inline_stickers. An inline sticker received over iMessage
currently arrives as a separate media part.
Stickers placed inside the text, in the order they appear in value. null when the
part has none.
Set on messages sent with inline_stickers. An inline sticker received over iMessage
currently arrives as a separate media part.
DEPRECATED: Use mentions instead. Handle (E.164 phone number or Apple ID email)
of the first mention on this part. A part may carry several mentions; this
field shows only the first in value order, so it cannot be used to determine
whether a given participant was mentioned. null when the part carries no mention.
DEPRECATED: Use mentions[].range instead. Character range [start, end) in
value highlighted as the first mention only. null when the range was
omitted (the whole value is highlighted) or the part carries no mention.
Characters are measured as UTF-16 code units. Most characters count as 1; some emoji count as 2.
mentions?: Array<Mention> | nullEvery mention on this part, in the order they appear in value. null when the
part carries no mention. A part can carry several mentions of different people —
check is_me to tell whether this line was one of them.
Only iMessage carries mentions. On a received message this is populated when the
sender was on iMessage; SMS and RCS have no way to mark a mention, so a message
from an SMS or RCS participant arrives as plain text with mentions null, even in
a group where other participants are on iMessage.
Every mention on this part, in the order they appear in value. null when the
part carries no mention. A part can carry several mentions of different people —
check is_me to tell whether this line was one of them.
Only iMessage carries mentions. On a received message this is populated when the
sender was on iMessage; SMS and RCS have no way to mark a mention, so a message
from an SMS or RCS participant arrives as plain text with mentions null, even in
a group where other participants are on iMessage.
Text decorations applied to character ranges in the value
Text decorations applied to character ranges in the value
Character range [start, end) in the value string where the decoration applies.
start is inclusive, end is exclusive.
Characters are measured as UTF-16 code units. Most characters count as 1; some emoji count as 2.
SchemasIMessageAppPartResponse { app, layout, type, 2 more } An iMessage app card part.
An iMessage app card part.
The handle that sent this message
The handle that sent this message
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
line_type?: "iMessage" | "RCS"The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
When the message was delivered. Null if not yet delivered.
When the sending device was first seen for this sender (the message time for a newly seen device). Absent for SMS/RCS and for outbound messages.
device_status?: "first_contact" | "known" | "new" | nullThe device a sender used, relative to devices we’ve seen from them before. first_contact = their first device (first message we’ve seen from this sender); known = a device we’ve seen before; new = a device we have NOT seen for a sender who already had one (the account/SIM-takeover signal).
The device a sender used, relative to devices we’ve seen from them before. first_contact = their first device (first message we’ve seen from this sender); known = a device we’ve seen before; new = a device we have NOT seen for a sender who already had one (the account/SIM-takeover signal).
Deprecatedpreferred_service?: "iMessage" | "SMS" | "RCS" | "auto" | nullPreferred messaging service type. Includes “auto” for default fallback behavior.
Preferred messaging service type. Includes “auto” for default fallback behavior.
Present only when this message was recovered by reconciliation rather than delivered live, and set to the time of that recovery. The field is omitted entirely for normally-delivered messages, which is the overwhelming majority. When present, expect sent_at to be substantially earlier than delivery of this event: the message is genuine but is arriving late and out of real-time order, so treat it as history rather than as a live inbound (for example, suppress auto-replies).
MessageDeliveredWebhookEvent { api_version, created_at, data, 5 more } Complete webhook payload for message.delivered events (2026-02-03 format)
Complete webhook payload for message.delivered events (2026-02-03 format)
Unified payload for message webhooks when using webhook_version: "2026-02-03".
This schema is used for message.sent, message.received, message.delivered, and message.read
events when the subscription URL includes ?version=2026-02-03.
Key differences from V1 (2025-01-01):
direction: “inbound” or “outbound” instead of is_from_me booleansender_handle: Full handle object for the senderchat: Nested object with id, is_group, and owner_handle- Message fields (
id, parts, effect, etc.) are at the top level, not nested in message
Timestamps indicate the message state:
message.sent: sent_at set, delivered_at=null, read_at=nullmessage.received: sent_at set, delivered_at=null, read_at=nullmessage.delivered: sent_at set, delivered_at set, read_at=nullmessage.read: sent_at set, delivered_at set, read_at set
Unified payload for message webhooks when using webhook_version: "2026-02-03".
This schema is used for message.sent, message.received, message.delivered, and message.read
events when the subscription URL includes ?version=2026-02-03.
Key differences from V1 (2025-01-01):
direction: “inbound” or “outbound” instead ofis_from_mebooleansender_handle: Full handle object for the senderchat: Nested object withid,is_group, andowner_handle- Message fields (
id,parts,effect, etc.) are at the top level, not nested inmessage
Timestamps indicate the message state:
message.sent: sent_at set, delivered_at=null, read_at=nullmessage.received: sent_at set, delivered_at=null, read_at=nullmessage.delivered: sent_at set, delivered_at set, read_at=nullmessage.read: sent_at set, delivered_at set, read_at set
chat: Chat { id, health_status, is_group, owner_handle } Chat information
Chat information
health_status: HealthStatus { doc_url, status, updated_at } [BETA] Current health for a chat. Always present — chats start at HEALTHY and may shift based on engagement and delivery signals on the conversation. Many AT_RISK or CRITICAL chats on a single line increase the risk of line flagging.
Switch on status to surface chat and line health in your UI — the enum is the long-term contract. Each status carries a doc_url that deep-links to the relevant section of the Chat Health guide. To gate a send, act on the response rather than the status: a 403 is the authoritative answer.
See the Chat Health guide for what each status means and how to react.
[BETA] Current health for a chat. Always present — chats start at HEALTHY and may shift based on engagement and delivery signals on the conversation. Many AT_RISK or CRITICAL chats on a single line increase the risk of line flagging.
Switch on status to surface chat and line health in your UI — the enum is the long-term contract. Each status carries a doc_url that deep-links to the relevant section of the Chat Health guide. To gate a send, act on the response rather than the status: a 403 is the authoritative answer.
See the Chat Health guide for what each status means and how to react.
status: "HEALTHY" | "AT_RISK" | "CRITICAL" | "OPTED_OUT"Current health bucket for the chat. See the Chat Health guide for what each value means and how to react. doc_url deep-links to the relevant section.
OPTED_OUT — the recipient sent STOP, UNSUBSCRIBE, OPTOUT, CANCEL, END, or QUIT.
The keyword must be the whole trimmed message, never part of a longer one: STOP counts, please stop
does not. Most keywords must match exactly, including case. OPT OUT is the exception — it matches in any
casing, with or without the space or a hyphen, so opt out, Opt-Out and optout all count. It clears as
soon as they reply again: any later message from them that is not itself an opt-out keyword opts them back
in immediately — a reply in any conversation with you counts, the same way the block does.
OPTED_OUT marks only the conversation the keyword arrived in. The block below is wider than the mark, so
a conversation still reading HEALTHY can be blocked as well — gate on the 403, not on the status.
Group threads are never marked and are never blocked.
Linq enforces this: while a recipient is opted out, every send to them is rejected with 403 (error code
2024) before the message is queued, across every chat and every line on your account. Nothing is
delivered, including a final courtesy message — to send one, set override_optout: true on that single
request.
Current health bucket for the chat. See the Chat Health guide for what each value means and how to react. doc_url deep-links to the relevant section.
OPTED_OUT — the recipient sent STOP, UNSUBSCRIBE, OPTOUT, CANCEL, END, or QUIT.
The keyword must be the whole trimmed message, never part of a longer one: STOP counts, please stop
does not. Most keywords must match exactly, including case. OPT OUT is the exception — it matches in any
casing, with or without the space or a hyphen, so opt out, Opt-Out and optout all count. It clears as
soon as they reply again: any later message from them that is not itself an opt-out keyword opts them back
in immediately — a reply in any conversation with you counts, the same way the block does.
OPTED_OUT marks only the conversation the keyword arrived in. The block below is wider than the mark, so
a conversation still reading HEALTHY can be blocked as well — gate on the 403, not on the status.
Group threads are never marked and are never blocked.
Linq enforces this: while a recipient is opted out, every send to them is rejected with 403 (error code
2024) before the message is queued, across every chat and every line on your account. Nothing is
delivered, including a final courtesy message — to send one, set override_optout: true on that single
request.
Your phone number’s handle. Always has is_me=true.
Your phone number’s handle. Always has is_me=true.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
line_type?: "iMessage" | "RCS"The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
direction: "inbound" | "outbound"Message direction - “outbound” if sent by you, “inbound” if received
Message direction - “outbound” if sent by you, “inbound” if received
parts: Array<SchemasTextPartResponse { type, value, inline_stickers, 4 more } | SchemasMediaPartResponse { id, filename, mime_type, 3 more } | SchemasLinkPartResponse { type, value } | 2 more>Message parts (text and/or media)
Message parts (text and/or media)
SchemasTextPartResponse { type, value, inline_stickers, 4 more } A text message part
A text message part
Stickers placed inside the text, in the order they appear in value. null when the
part has none.
Set on messages sent with inline_stickers. An inline sticker received over iMessage
currently arrives as a separate media part.
Stickers placed inside the text, in the order they appear in value. null when the
part has none.
Set on messages sent with inline_stickers. An inline sticker received over iMessage
currently arrives as a separate media part.
DEPRECATED: Use mentions instead. Handle (E.164 phone number or Apple ID email)
of the first mention on this part. A part may carry several mentions; this
field shows only the first in value order, so it cannot be used to determine
whether a given participant was mentioned. null when the part carries no mention.
DEPRECATED: Use mentions[].range instead. Character range [start, end) in
value highlighted as the first mention only. null when the range was
omitted (the whole value is highlighted) or the part carries no mention.
Characters are measured as UTF-16 code units. Most characters count as 1; some emoji count as 2.
mentions?: Array<Mention> | nullEvery mention on this part, in the order they appear in value. null when the
part carries no mention. A part can carry several mentions of different people —
check is_me to tell whether this line was one of them.
Only iMessage carries mentions. On a received message this is populated when the
sender was on iMessage; SMS and RCS have no way to mark a mention, so a message
from an SMS or RCS participant arrives as plain text with mentions null, even in
a group where other participants are on iMessage.
Every mention on this part, in the order they appear in value. null when the
part carries no mention. A part can carry several mentions of different people —
check is_me to tell whether this line was one of them.
Only iMessage carries mentions. On a received message this is populated when the
sender was on iMessage; SMS and RCS have no way to mark a mention, so a message
from an SMS or RCS participant arrives as plain text with mentions null, even in
a group where other participants are on iMessage.
Text decorations applied to character ranges in the value
Text decorations applied to character ranges in the value
Character range [start, end) in the value string where the decoration applies.
start is inclusive, end is exclusive.
Characters are measured as UTF-16 code units. Most characters count as 1; some emoji count as 2.
SchemasIMessageAppPartResponse { app, layout, type, 2 more } An iMessage app card part.
An iMessage app card part.
The handle that sent this message
The handle that sent this message
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
line_type?: "iMessage" | "RCS"The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
When the message was delivered. Null if not yet delivered.
When the sending device was first seen for this sender (the message time for a newly seen device). Absent for SMS/RCS and for outbound messages.
device_status?: "first_contact" | "known" | "new" | nullThe device a sender used, relative to devices we’ve seen from them before. first_contact = their first device (first message we’ve seen from this sender); known = a device we’ve seen before; new = a device we have NOT seen for a sender who already had one (the account/SIM-takeover signal).
The device a sender used, relative to devices we’ve seen from them before. first_contact = their first device (first message we’ve seen from this sender); known = a device we’ve seen before; new = a device we have NOT seen for a sender who already had one (the account/SIM-takeover signal).
Deprecatedpreferred_service?: "iMessage" | "SMS" | "RCS" | "auto" | nullPreferred messaging service type. Includes “auto” for default fallback behavior.
Preferred messaging service type. Includes “auto” for default fallback behavior.
Present only when this message was recovered by reconciliation rather than delivered live, and set to the time of that recovery. The field is omitted entirely for normally-delivered messages, which is the overwhelming majority. When present, expect sent_at to be substantially earlier than delivery of this event: the message is genuine but is arriving late and out of real-time order, so treat it as history rather than as a live inbound (for example, suppress auto-replies).
MessageFailedWebhookEvent { api_version, created_at, data, 5 more } Complete webhook payload for message.failed events
Complete webhook payload for message.failed events
data: Data { code, failed_at, chat_id, 5 more } Error details for message.failed webhook events.
See WebhookErrorCode for the full error code reference.
In rare cases the message can still be delivered after this event fires — a message.delivered webhook for the same message ID may follow.
Error details for message.failed webhook events. See WebhookErrorCode for the full error code reference.
In rare cases the message can still be delivered after this event fires — a message.delivered webhook for the same message ID may follow.
Error codes in webhook failure events. The possible set varies by event: message.failed and poll.failed can carry 3007, 4001, 4002, 4005, 4006, 4007, or 4008; the group update failure events (chat.group_name_update_failed, chat.group_icon_update_failed) carry 3007 or 4001; chat.background_update_failed carries 1005, 2011, 4001, or 5002.
Opaque diagnostic code identifying the specific failure class within code.
Values are not enumerated and may change without notice — log it and include
it in support requests, but do not branch on it.
Deprecatedpreferred_service?: "iMessage" | "SMS" | "RCS" | "auto" | nullPreferred messaging service type. Includes “auto” for default fallback behavior.
Preferred messaging service type. Includes “auto” for default fallback behavior.
MessageEditedWebhookEvent { api_version, created_at, data, 5 more } Complete webhook payload for message.edited events (2026-02-03 format only)
Complete webhook payload for message.edited events (2026-02-03 format only)
data: Data { id, chat, direction, 4 more } Payload for message.edited events (2026-02-03 format).
Describes which part of a message was edited and when. Only text parts can be edited.
Only available for subscriptions using webhook_version: "2026-02-03".
Payload for message.edited events (2026-02-03 format).
Describes which part of a message was edited and when. Only text parts can be edited.
Only available for subscriptions using webhook_version: "2026-02-03".
chat: Chat { id, health_status, is_group, owner_handle } Chat context
Chat context
health_status: HealthStatus { doc_url, status, updated_at } [BETA] Current health for a chat. Always present — chats start at HEALTHY and may shift based on engagement and delivery signals on the conversation. Many AT_RISK or CRITICAL chats on a single line increase the risk of line flagging.
Switch on status to surface chat and line health in your UI — the enum is the long-term contract. Each status carries a doc_url that deep-links to the relevant section of the Chat Health guide. To gate a send, act on the response rather than the status: a 403 is the authoritative answer.
See the Chat Health guide for what each status means and how to react.
[BETA] Current health for a chat. Always present — chats start at HEALTHY and may shift based on engagement and delivery signals on the conversation. Many AT_RISK or CRITICAL chats on a single line increase the risk of line flagging.
Switch on status to surface chat and line health in your UI — the enum is the long-term contract. Each status carries a doc_url that deep-links to the relevant section of the Chat Health guide. To gate a send, act on the response rather than the status: a 403 is the authoritative answer.
See the Chat Health guide for what each status means and how to react.
status: "HEALTHY" | "AT_RISK" | "CRITICAL" | "OPTED_OUT"Current health bucket for the chat. See the Chat Health guide for what each value means and how to react. doc_url deep-links to the relevant section.
OPTED_OUT — the recipient sent STOP, UNSUBSCRIBE, OPTOUT, CANCEL, END, or QUIT.
The keyword must be the whole trimmed message, never part of a longer one: STOP counts, please stop
does not. Most keywords must match exactly, including case. OPT OUT is the exception — it matches in any
casing, with or without the space or a hyphen, so opt out, Opt-Out and optout all count. It clears as
soon as they reply again: any later message from them that is not itself an opt-out keyword opts them back
in immediately — a reply in any conversation with you counts, the same way the block does.
OPTED_OUT marks only the conversation the keyword arrived in. The block below is wider than the mark, so
a conversation still reading HEALTHY can be blocked as well — gate on the 403, not on the status.
Group threads are never marked and are never blocked.
Linq enforces this: while a recipient is opted out, every send to them is rejected with 403 (error code
2024) before the message is queued, across every chat and every line on your account. Nothing is
delivered, including a final courtesy message — to send one, set override_optout: true on that single
request.
Current health bucket for the chat. See the Chat Health guide for what each value means and how to react. doc_url deep-links to the relevant section.
OPTED_OUT — the recipient sent STOP, UNSUBSCRIBE, OPTOUT, CANCEL, END, or QUIT.
The keyword must be the whole trimmed message, never part of a longer one: STOP counts, please stop
does not. Most keywords must match exactly, including case. OPT OUT is the exception — it matches in any
casing, with or without the space or a hyphen, so opt out, Opt-Out and optout all count. It clears as
soon as they reply again: any later message from them that is not itself an opt-out keyword opts them back
in immediately — a reply in any conversation with you counts, the same way the block does.
OPTED_OUT marks only the conversation the keyword arrived in. The block below is wider than the mark, so
a conversation still reading HEALTHY can be blocked as well — gate on the 403, not on the status.
Group threads are never marked and are never blocked.
Linq enforces this: while a recipient is opted out, every send to them is rejected with 403 (error code
2024) before the message is queued, across every chat and every line on your account. Nothing is
delivered, including a final courtesy message — to send one, set override_optout: true on that single
request.
The handle that owns this chat (your phone number)
The handle that owns this chat (your phone number)
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
line_type?: "iMessage" | "RCS"The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
direction: "outbound" | "inbound"“outbound” if you sent the original message, “inbound” if you received it
“outbound” if you sent the original message, “inbound” if you received it
The handle that sent (and edited) this message
The handle that sent (and edited) this message
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
line_type?: "iMessage" | "RCS"The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
True when the edited message is on a zero-day-retention line. Behavior differs by direction: on an outbound edit, part.text is empty — you already saw the real edited text once, synchronously, in the edit API response, and Linq never persists it. On an inbound edit, part.text is still the real text as received; zero-day-retention only means Linq never persists it.
ReactionAddedWebhookEvent { api_version, created_at, data, 5 more } Complete webhook payload for reaction.added events
Complete webhook payload for reaction.added events
Payload for reaction.added webhook events
Payload for reaction.added webhook events
Whether this reaction was from the owner of the phone number (true) or from someone else (false)
Type of reaction. Standard iMessage tapbacks are love, like, dislike, laugh, emphasize, question.
Custom emoji reactions have type “custom” with the actual emoji in the custom_emoji field.
Sticker reactions have type “sticker” with sticker attachment details in the sticker field.
Type of reaction. Standard iMessage tapbacks are love, like, dislike, laugh, emphasize, question. Custom emoji reactions have type “custom” with the actual emoji in the custom_emoji field. Sticker reactions have type “sticker” with sticker attachment details in the sticker field.
The actual emoji when reaction_type is “custom”. Null for standard tapbacks.
DEPRECATED: Use from_handle instead. Phone number or email address of the person who added/removed the reaction.
The person who added/removed the reaction as a full handle object
The person who added/removed the reaction as a full handle object
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
line_type?: "iMessage" | "RCS"The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
Identifier for this reaction. Pass it to
PATCH /v3/messages/{messageId}/reactions/{reactionId} to move a sticker.
Stickers stack, so this is what distinguishes one sticker from another on the
same message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
ReactionRemovedWebhookEvent { api_version, created_at, data, 5 more } Complete webhook payload for reaction.removed events
Complete webhook payload for reaction.removed events
Payload for reaction.removed webhook events
Payload for reaction.removed webhook events
Whether this reaction was from the owner of the phone number (true) or from someone else (false)
Type of reaction. Standard iMessage tapbacks are love, like, dislike, laugh, emphasize, question.
Custom emoji reactions have type “custom” with the actual emoji in the custom_emoji field.
Sticker reactions have type “sticker” with sticker attachment details in the sticker field.
Type of reaction. Standard iMessage tapbacks are love, like, dislike, laugh, emphasize, question. Custom emoji reactions have type “custom” with the actual emoji in the custom_emoji field. Sticker reactions have type “sticker” with sticker attachment details in the sticker field.
The actual emoji when reaction_type is “custom”. Null for standard tapbacks.
DEPRECATED: Use from_handle instead. Phone number or email address of the person who added/removed the reaction.
The person who added/removed the reaction as a full handle object
The person who added/removed the reaction as a full handle object
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
line_type?: "iMessage" | "RCS"The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
Identifier for this reaction. Pass it to
PATCH /v3/messages/{messageId}/reactions/{reactionId} to move a sticker.
Stickers stack, so this is what distinguishes one sticker from another on the
same message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
PollReceivedWebhookEvent { api_version, created_at, data, 5 more } Complete webhook payload for poll.received events
Complete webhook payload for poll.received events
data: Data { chat, created_at, direction, 7 more } Payload for poll.received — a poll created by someone else and delivered to your line.
Carries the full poll snapshot (options, no voters yet) at receipt time.
Payload for poll.received — a poll created by someone else and delivered to your line. Carries the full poll snapshot (options, no voters yet) at receipt time.
chat: Chat { id, is_group, owner_handle } Chat info for poll webhook events.
Chat info for poll webhook events.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
line_type?: "iMessage" | "RCS"The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
poll: Poll { options, total_voters }
options: Array<Option>
The participant who added this option (poll creator for the initial options; whoever
added later ones). On a poll.updated this differs from the event’s sender_handle
whenever a remote participant added the option. Null when unknown.
The participant who added this option (poll creator for the initial options; whoever
added later ones). On a poll.updated this differs from the event’s sender_handle
whenever a remote participant added the option. Null when unknown.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
line_type?: "iMessage" | "RCS"The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The line that created the poll (is_me=false for an inbound poll).
The line that created the poll (is_me=false for an inbound poll).
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
line_type?: "iMessage" | "RCS"The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
True when your line has zero-day-retention enabled. Unlike other poll webhooks, option text here is still the real, unstripped text as received — Linq never persists it in the database, but this webhook fires from the live inbound event, not a database read, so this is the one place it’s shown.
PollSentWebhookEvent { api_version, created_at, data, 5 more } Complete webhook payload for poll.sent events
Complete webhook payload for poll.sent events
data: Data { chat, created_at, direction, 9 more } Payload for poll.sent, poll.delivered, and poll.read webhook events. Timestamps indicate
state (null = not yet happened): sent → sent_at; delivered → +delivered_at; read → +read_at.
Payload for poll.sent, poll.delivered, and poll.read webhook events. Timestamps indicate state (null = not yet happened): sent → sent_at; delivered → +delivered_at; read → +read_at.
chat: Chat { id, is_group, owner_handle } Chat info for poll webhook events.
Chat info for poll webhook events.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
line_type?: "iMessage" | "RCS"The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
poll: Poll { options, total_voters }
options: Array<Option>
The participant who added this option (poll creator for the initial options; whoever
added later ones). On a poll.updated this differs from the event’s sender_handle
whenever a remote participant added the option. Null when unknown.
The participant who added this option (poll creator for the initial options; whoever
added later ones). On a poll.updated this differs from the event’s sender_handle
whenever a remote participant added the option. Null when unknown.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
line_type?: "iMessage" | "RCS"The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The handle that sent the poll.
The handle that sent the poll.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
line_type?: "iMessage" | "RCS"The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
True when this poll was sent on a zero-day-retention line. Every option’s text is empty in that case — Linq never persists poll option text, so there is nothing to include here. The real text was only ever shown once, synchronously, in the API response when the poll was created or added to.
PollDeliveredWebhookEvent { api_version, created_at, data, 5 more } Complete webhook payload for poll.delivered events
Complete webhook payload for poll.delivered events
data: Data { chat, created_at, direction, 9 more } Payload for poll.sent, poll.delivered, and poll.read webhook events. Timestamps indicate
state (null = not yet happened): sent → sent_at; delivered → +delivered_at; read → +read_at.
Payload for poll.sent, poll.delivered, and poll.read webhook events. Timestamps indicate state (null = not yet happened): sent → sent_at; delivered → +delivered_at; read → +read_at.
chat: Chat { id, is_group, owner_handle } Chat info for poll webhook events.
Chat info for poll webhook events.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
line_type?: "iMessage" | "RCS"The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
poll: Poll { options, total_voters }
options: Array<Option>
The participant who added this option (poll creator for the initial options; whoever
added later ones). On a poll.updated this differs from the event’s sender_handle
whenever a remote participant added the option. Null when unknown.
The participant who added this option (poll creator for the initial options; whoever
added later ones). On a poll.updated this differs from the event’s sender_handle
whenever a remote participant added the option. Null when unknown.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
line_type?: "iMessage" | "RCS"The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The handle that sent the poll.
The handle that sent the poll.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
line_type?: "iMessage" | "RCS"The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
True when this poll was sent on a zero-day-retention line. Every option’s text is empty in that case — Linq never persists poll option text, so there is nothing to include here. The real text was only ever shown once, synchronously, in the API response when the poll was created or added to.
PollReadWebhookEvent { api_version, created_at, data, 5 more } Complete webhook payload for poll.read events
Complete webhook payload for poll.read events
data: Data { chat, created_at, direction, 9 more } Payload for poll.sent, poll.delivered, and poll.read webhook events. Timestamps indicate
state (null = not yet happened): sent → sent_at; delivered → +delivered_at; read → +read_at.
Payload for poll.sent, poll.delivered, and poll.read webhook events. Timestamps indicate state (null = not yet happened): sent → sent_at; delivered → +delivered_at; read → +read_at.
chat: Chat { id, is_group, owner_handle } Chat info for poll webhook events.
Chat info for poll webhook events.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
line_type?: "iMessage" | "RCS"The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
poll: Poll { options, total_voters }
options: Array<Option>
The participant who added this option (poll creator for the initial options; whoever
added later ones). On a poll.updated this differs from the event’s sender_handle
whenever a remote participant added the option. Null when unknown.
The participant who added this option (poll creator for the initial options; whoever
added later ones). On a poll.updated this differs from the event’s sender_handle
whenever a remote participant added the option. Null when unknown.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
line_type?: "iMessage" | "RCS"The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The handle that sent the poll.
The handle that sent the poll.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
line_type?: "iMessage" | "RCS"The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
True when this poll was sent on a zero-day-retention line. Every option’s text is empty in that case — Linq never persists poll option text, so there is nothing to include here. The real text was only ever shown once, synchronously, in the API response when the poll was created or added to.
PollUpdatedWebhookEvent { api_version, created_at, data, 5 more } Complete webhook payload for poll.updated events
Complete webhook payload for poll.updated events
data: Data { added_options, chat, direction, 4 more } Payload for poll.updated (option(s) added — add-only).
Payload for poll.updated (option(s) added — add-only).
added_options: Array<AddedOption>Only the options this update added — never the ones the poll already had. Fetch the poll to read its full option set.
Only the options this update added — never the ones the poll already had. Fetch the poll to read its full option set.
The participant who added this option (poll creator for the initial options; whoever
added later ones). On a poll.updated this differs from the event’s sender_handle
whenever a remote participant added the option. Null when unknown.
The participant who added this option (poll creator for the initial options; whoever
added later ones). On a poll.updated this differs from the event’s sender_handle
whenever a remote participant added the option. Null when unknown.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
line_type?: "iMessage" | "RCS"The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
chat: Chat { id, is_group, owner_handle } Chat info for poll webhook events.
Chat info for poll webhook events.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
line_type?: "iMessage" | "RCS"The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
Your line — the one that received or sent this update. Always present. On an inbound
update this is NOT who added the option: use added_options[].creator_handle for
that, which will be the remote participant.
Your line — the one that received or sent this update. Always present. On an inbound
update this is NOT who added the option: use added_options[].creator_handle for
that, which will be the remote participant.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
line_type?: "iMessage" | "RCS"The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
True when zero-day-retention applies to this update. Behavior differs by direction: on an inbound update, added_options[].text is the real text a participant just added; on an outbound update, it is empty — you already saw the real text once, synchronously, in the API response when you made the add, and this webhook is built from a database read, which never stored it.
PollFailedWebhookEvent { api_version, created_at, data, 5 more } Complete webhook payload for poll.failed events
Complete webhook payload for poll.failed events
data: Data { chat, direction, error, 6 more } Payload for poll.failed — an outbound poll (or poll action) that failed to send. Carries the
poll snapshot at failure time plus the error and when it failed.
Payload for poll.failed — an outbound poll (or poll action) that failed to send. Carries the poll snapshot at failure time plus the error and when it failed.
chat: Chat { id, is_group, owner_handle } Chat info for poll webhook events.
Chat info for poll webhook events.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
line_type?: "iMessage" | "RCS"The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
error: Error { code, message }
Error codes in webhook failure events. The possible set varies by event: message.failed and poll.failed can carry 3007, 4001, 4002, 4005, 4006, 4007, or 4008; the group update failure events (chat.group_name_update_failed, chat.group_icon_update_failed) carry 3007 or 4001; chat.background_update_failed carries 1005, 2011, 4001, or 5002.
poll: Poll { options, total_voters }
options: Array<Option>
The participant who added this option (poll creator for the initial options; whoever
added later ones). On a poll.updated this differs from the event’s sender_handle
whenever a remote participant added the option. Null when unknown.
The participant who added this option (poll creator for the initial options; whoever
added later ones). On a poll.updated this differs from the event’s sender_handle
whenever a remote participant added the option. Null when unknown.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
line_type?: "iMessage" | "RCS"The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
Null on failure (the send never landed).
Null on failure (the send never landed).
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
line_type?: "iMessage" | "RCS"The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
PollVoteAddedWebhookEvent { api_version, created_at, data, 5 more } Complete webhook payload for poll.vote.added events
Complete webhook payload for poll.vote.added events
data: Data { chat, direction, message_id, 4 more } Payload for poll.vote.added and poll.vote.removed (one option toggled).
Payload for poll.vote.added and poll.vote.removed (one option toggled).
chat: Chat { id, is_group, owner_handle } Chat info for poll webhook events.
Chat info for poll webhook events.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
line_type?: "iMessage" | "RCS"The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The voter — always present.
The voter — always present.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
line_type?: "iMessage" | "RCS"The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
True when this poll is on a zero-day-retention line. Votes are unaffected by zero-day-retention — a vote choice is always persisted and delivered regardless — this flag is informational only, telling you why this poll’s other webhooks (poll.sent, poll.updated, etc.) may carry empty option text.
PollVoteRemovedWebhookEvent { api_version, created_at, data, 5 more } Complete webhook payload for poll.vote.removed events
Complete webhook payload for poll.vote.removed events
data: Data { chat, direction, message_id, 4 more } Payload for poll.vote.added and poll.vote.removed (one option toggled).
Payload for poll.vote.added and poll.vote.removed (one option toggled).
chat: Chat { id, is_group, owner_handle } Chat info for poll webhook events.
Chat info for poll webhook events.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
line_type?: "iMessage" | "RCS"The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The voter — always present.
The voter — always present.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
line_type?: "iMessage" | "RCS"The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
True when this poll is on a zero-day-retention line. Votes are unaffected by zero-day-retention — a vote choice is always persisted and delivered regardless — this flag is informational only, telling you why this poll’s other webhooks (poll.sent, poll.updated, etc.) may carry empty option text.
PollReactionAddedWebhookEvent { api_version, created_at, data, 5 more } Complete webhook payload for poll.reaction.added events
Complete webhook payload for poll.reaction.added events
Payload for poll.reaction.added — a reaction on a poll message. Same shape as
reaction.added; message_id is the poll-definition message’s ID. Poll reactions are
stickers, which iMessage cannot remove, so there is no removal counterpart.
Payload for poll.reaction.added — a reaction on a poll message. Same shape as
reaction.added; message_id is the poll-definition message’s ID. Poll reactions are
stickers, which iMessage cannot remove, so there is no removal counterpart.
Whether this reaction was from the owner of the phone number (true) or from someone else (false)
Type of reaction. Standard iMessage tapbacks are love, like, dislike, laugh, emphasize, question.
Custom emoji reactions have type “custom” with the actual emoji in the custom_emoji field.
Sticker reactions have type “sticker” with sticker attachment details in the sticker field.
Type of reaction. Standard iMessage tapbacks are love, like, dislike, laugh, emphasize, question. Custom emoji reactions have type “custom” with the actual emoji in the custom_emoji field. Sticker reactions have type “sticker” with sticker attachment details in the sticker field.
The actual emoji when reaction_type is “custom”. Null for standard tapbacks.
DEPRECATED: Use from_handle instead. Phone number or email address of the person who added/removed the reaction.
The person who added/removed the reaction as a full handle object
The person who added/removed the reaction as a full handle object
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
line_type?: "iMessage" | "RCS"The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
Identifier for this reaction. Pass it to
PATCH /v3/messages/{messageId}/reactions/{reactionId} to move a sticker.
Stickers stack, so this is what distinguishes one sticker from another on the
same message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
ParticipantAddedWebhookEvent { api_version, created_at, data, 5 more } Complete webhook payload for participant.added events
Complete webhook payload for participant.added events
data: Data { handle, added_at, chat_id, participant } Payload for participant.added webhook events
Payload for participant.added webhook events
DEPRECATED: Use participant instead. Handle (phone number or email address) of the added participant.
The added participant as a full handle object
The added participant as a full handle object
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
line_type?: "iMessage" | "RCS"The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
ParticipantRemovedWebhookEvent { api_version, created_at, data, 5 more } Complete webhook payload for participant.removed events
Complete webhook payload for participant.removed events
data: Data { handle, chat_id, participant, removed_at } Payload for participant.removed webhook events
Payload for participant.removed webhook events
DEPRECATED: Use participant instead. Handle (phone number or email address) of the removed participant.
The removed participant as a full handle object
The removed participant as a full handle object
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
line_type?: "iMessage" | "RCS"The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
ChatCreatedWebhookEvent { api_version, created_at, data, 5 more } Complete webhook payload for chat.created events
Complete webhook payload for chat.created events
data: Data { id, created_at, display_name, 5 more } Payload for chat.created webhook events. Matches GET /v3/chats/{chatId} response.
Payload for chat.created webhook events. Matches GET /v3/chats/{chatId} response.
Display name for the chat. Defaults to a comma-separated list of recipient handles. Can be updated for group chats.
List of chat participants with full handle details. Always contains at least two handles (your phone number and the other participant).
List of chat participants with full handle details. Always contains at least two handles (your phone number and the other participant).
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
line_type?: "iMessage" | "RCS"The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
health_status: HealthStatus { doc_url, status, updated_at } [BETA] Current health for a chat. Always present — chats start at HEALTHY and may shift based on engagement and delivery signals on the conversation. Many AT_RISK or CRITICAL chats on a single line increase the risk of line flagging.
Switch on status to surface chat and line health in your UI — the enum is the long-term contract. Each status carries a doc_url that deep-links to the relevant section of the Chat Health guide. To gate a send, act on the response rather than the status: a 403 is the authoritative answer.
See the Chat Health guide for what each status means and how to react.
[BETA] Current health for a chat. Always present — chats start at HEALTHY and may shift based on engagement and delivery signals on the conversation. Many AT_RISK or CRITICAL chats on a single line increase the risk of line flagging.
Switch on status to surface chat and line health in your UI — the enum is the long-term contract. Each status carries a doc_url that deep-links to the relevant section of the Chat Health guide. To gate a send, act on the response rather than the status: a 403 is the authoritative answer.
See the Chat Health guide for what each status means and how to react.
status: "HEALTHY" | "AT_RISK" | "CRITICAL" | "OPTED_OUT"Current health bucket for the chat. See the Chat Health guide for what each value means and how to react. doc_url deep-links to the relevant section.
OPTED_OUT — the recipient sent STOP, UNSUBSCRIBE, OPTOUT, CANCEL, END, or QUIT.
The keyword must be the whole trimmed message, never part of a longer one: STOP counts, please stop
does not. Most keywords must match exactly, including case. OPT OUT is the exception — it matches in any
casing, with or without the space or a hyphen, so opt out, Opt-Out and optout all count. It clears as
soon as they reply again: any later message from them that is not itself an opt-out keyword opts them back
in immediately — a reply in any conversation with you counts, the same way the block does.
OPTED_OUT marks only the conversation the keyword arrived in. The block below is wider than the mark, so
a conversation still reading HEALTHY can be blocked as well — gate on the 403, not on the status.
Group threads are never marked and are never blocked.
Linq enforces this: while a recipient is opted out, every send to them is rejected with 403 (error code
2024) before the message is queued, across every chat and every line on your account. Nothing is
delivered, including a final courtesy message — to send one, set override_optout: true on that single
request.
Current health bucket for the chat. See the Chat Health guide for what each value means and how to react. doc_url deep-links to the relevant section.
OPTED_OUT — the recipient sent STOP, UNSUBSCRIBE, OPTOUT, CANCEL, END, or QUIT.
The keyword must be the whole trimmed message, never part of a longer one: STOP counts, please stop
does not. Most keywords must match exactly, including case. OPT OUT is the exception — it matches in any
casing, with or without the space or a hyphen, so opt out, Opt-Out and optout all count. It clears as
soon as they reply again: any later message from them that is not itself an opt-out keyword opts them back
in immediately — a reply in any conversation with you counts, the same way the block does.
OPTED_OUT marks only the conversation the keyword arrived in. The block below is wider than the mark, so
a conversation still reading HEALTHY can be blocked as well — gate on the 403, not on the status.
Group threads are never marked and are never blocked.
Linq enforces this: while a recipient is opted out, every send to them is rejected with 403 (error code
2024) before the message is queued, across every chat and every line on your account. Nothing is
delivered, including a final courtesy message — to send one, set override_optout: true on that single
request.
ChatGroupNameUpdatedWebhookEvent { api_version, created_at, data, 5 more } Complete webhook payload for chat.group_name_updated events
Complete webhook payload for chat.group_name_updated events
data: Data { chat_id, updated_at, changed_by_handle, 2 more } Payload for chat.group_name_updated webhook events
Payload for chat.group_name_updated webhook events
The handle who made the change.
The handle who made the change.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
line_type?: "iMessage" | "RCS"The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
ChatGroupIconUpdatedWebhookEvent { api_version, created_at, data, 5 more } Complete webhook payload for chat.group_icon_updated events
Complete webhook payload for chat.group_icon_updated events
data: Data { chat_id, updated_at, changed_by_handle, 2 more } Payload for chat.group_icon_updated webhook events
Payload for chat.group_icon_updated webhook events
The handle who made the change.
The handle who made the change.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
line_type?: "iMessage" | "RCS"The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
ChatGroupNameUpdateFailedWebhookEvent { api_version, created_at, data, 5 more } Complete webhook payload for chat.group_name_update_failed events
Complete webhook payload for chat.group_name_update_failed events
data: Data { chat_id, error_code, failed_at } Error details for chat.group_name_update_failed webhook events.
See WebhookErrorCode for the full error code reference.
Error details for chat.group_name_update_failed webhook events. See WebhookErrorCode for the full error code reference.
Error codes in webhook failure events. The possible set varies by event: message.failed and poll.failed can carry 3007, 4001, 4002, 4005, 4006, 4007, or 4008; the group update failure events (chat.group_name_update_failed, chat.group_icon_update_failed) carry 3007 or 4001; chat.background_update_failed carries 1005, 2011, 4001, or 5002.
ChatGroupIconUpdateFailedWebhookEvent { api_version, created_at, data, 5 more } Complete webhook payload for chat.group_icon_update_failed events
Complete webhook payload for chat.group_icon_update_failed events
data: Data { chat_id, error_code, failed_at } Error details for chat.group_icon_update_failed webhook events.
See WebhookErrorCode for the full error code reference.
Error details for chat.group_icon_update_failed webhook events. See WebhookErrorCode for the full error code reference.
Error codes in webhook failure events. The possible set varies by event: message.failed and poll.failed can carry 3007, 4001, 4002, 4005, 4006, 4007, or 4008; the group update failure events (chat.group_name_update_failed, chat.group_icon_update_failed) carry 3007 or 4001; chat.background_update_failed carries 1005, 2011, 4001, or 5002.
ChatTypingIndicatorStartedWebhookEvent { api_version, created_at, data, 5 more } Complete webhook payload for chat.typing_indicator.started events
Complete webhook payload for chat.typing_indicator.started events
data: Data { chat_id, actor_handle } Payload for chat.typing_indicator.started webhook events
Payload for chat.typing_indicator.started webhook events
Who is typing.
Who is typing.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
line_type?: "iMessage" | "RCS"The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
ChatTypingIndicatorStoppedWebhookEvent { api_version, created_at, data, 5 more } Complete webhook payload for chat.typing_indicator.stopped events
Complete webhook payload for chat.typing_indicator.stopped events
data: Data { chat_id, actor_handle } Payload for chat.typing_indicator.stopped webhook events
Payload for chat.typing_indicator.stopped webhook events
Who stopped typing.
Who stopped typing.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
line_type?: "iMessage" | "RCS"The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
ChatBackgroundUpdatedWebhookEvent { api_version, created_at, data, 5 more } Complete webhook payload for chat.background_updated events
Complete webhook payload for chat.background_updated events
data: Data { chat, actor_handle, background } Payload for chat.background_updated webhook events.
Payload for chat.background_updated webhook events.
chat: Chat { id, is_group, owner_handle } Chat information
Chat information
Your phone number’s handle. Always has is_me=true.
Your phone number’s handle. Always has is_me=true.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
line_type?: "iMessage" | "RCS"The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
Who changed it. is_me is true when your own number set it.
Who changed it. is_me is true when your own number set it.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
Messaging service type. Where this names the transport a message used,
it is per-message: a chat’s own service can differ from a message in
it, and Apple can downgrade an individual message.
line_type?: "iMessage" | "RCS"The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
The kind of line: iMessage for an iMessage-capable line, RCS for an
RCS-only line, which sends RCS and SMS but never iMessage. Same values as
the type parameter on GET /v3/available_number. A property of the line
itself, so unlike service it does not change with the conversation:
an iMessage-capable line can still carry an RCS or SMS conversation.
background?: Background | nullA chat transcript background. Fields are populated per type.
A chat transcript background. Fields are populated per type.
Photo: a hosted URL for the background image, whether you set it or a
participant did. Apple stores the image, not the URL it came from, so the
image is re-hosted and this is our URL rather than the one you supplied.
null only if the image could not be hosted.
ChatBackgroundUpdateFailedWebhookEvent { api_version, created_at, data, 5 more } Complete webhook payload for chat.background_update_failed events
Complete webhook payload for chat.background_update_failed events
data: Data { chat_id, error_code, failed_at } Error details for chat.background_update_failed webhook events.
See WebhookErrorCode for the full error code reference.
Error details for chat.background_update_failed webhook events. See WebhookErrorCode for the full error code reference.
Error codes in webhook failure events. The possible set varies by event: message.failed and poll.failed can carry 3007, 4001, 4002, 4005, 4006, 4007, or 4008; the group update failure events (chat.group_name_update_failed, chat.group_icon_update_failed) carry 3007 or 4001; chat.background_update_failed carries 1005, 2011, 4001, or 5002.
ContactCardReceivedWebhookEvent { api_version, created_at, data, 5 more } Complete webhook payload for contact_card.received events
Complete webhook payload for contact_card.received events
data: Data { first_name, last_name, owner_handle, 2 more } Payload for contact_card.received webhook events.
A contact belongs to a line, not to an individual chat. You receive one event per person who
shares their contact, regardless of how many chats they have in common with your line.
The event fires again whenever the shared contact’s name or media changes.
Payload for contact_card.received webhook events.
A contact belongs to a line, not to an individual chat. You receive one event per person who shares their contact, regardless of how many chats they have in common with your line.
The event fires again whenever the shared contact’s name or media changes.
URL of the contact’s media, served from cdn.linqapp.com. null when the
contact shared no media, and also when media was shared but could not be
retrieved — this field does not distinguish the two.
Download the media and store it yourself. The URL may be signed and expire, in as little as 45 minutes, and altering its query string invalidates it immediately.
PhoneNumberStatusUpdatedWebhookEvent { api_version, created_at, data, 5 more } Complete webhook payload for phone_number.status_updated events
Complete webhook payload for phone_number.status_updated events
data: Data { changed_at, new_reputation, new_status, 3 more } Payload for phone_number.status_updated webhook events
Payload for phone_number.status_updated webhook events
PhoneNumberAssignedWebhookEvent { api_version, created_at, data, 5 more } Complete webhook payload for phone_number.assigned events
Complete webhook payload for phone_number.assigned events
PhoneNumberReleasedWebhookEvent { api_version, created_at, data, 5 more } Complete webhook payload for phone_number.released events
Complete webhook payload for phone_number.released events
PhoneNumberLineTypeUpdatedWebhookEvent { api_version, created_at, data, 5 more } Complete webhook payload for phone_number.line_type_updated events
Complete webhook payload for phone_number.line_type_updated events
ConnectionCreatedWebhookEvent { api_version, created_at, data, 5 more }
data: Data { id, amount, checkout_url, 17 more } The payment request, as returned by
GET /v3/payment_requests/{paymentRequestId}.
The payment request, as returned by
GET /v3/payment_requests/{paymentRequestId}.
What was charged at checkout, in the currency’s minor
units. In subscription mode this is the first invoice’s
total — all items after any discounts are applied.
URL the recipient opens to pay
(https://zero.linqapp.com/pay/{slug}?session=...).
discount?: Discount { coupon, label, promotion_code } Subscription mode — the discount Stripe applied, read back
from the coupon. Absent when none was applied.
Subscription mode — the discount Stripe applied, read back from the coupon. Absent when none was applied.
mode?: "payment" | "subscription"Whether the request collected a one-time charge or started a subscription.
Whether the request collected a one-time charge or started a subscription.
natural?: Natural { payment_request_id, transaction_id } Natural-rail join keys, present when rail: natural.
Natural-rail join keys, present when rail: natural.
stripe?: Stripe { customer_id, payment_intent_id, subscription_id } Ids of the Stripe objects on your connected account — join
keys into your own Stripe Dashboard/API. Manage a
subscription’s post-checkout lifecycle with subscription_id.
Ids of the Stripe objects on your connected account — join
keys into your own Stripe Dashboard/API. Manage a
subscription’s post-checkout lifecycle with subscription_id.
ConnectionRevokedWebhookEvent { api_version, created_at, data, 5 more }
data: Data { id, amount, checkout_url, 17 more } The payment request, as returned by
GET /v3/payment_requests/{paymentRequestId}.
The payment request, as returned by
GET /v3/payment_requests/{paymentRequestId}.
What was charged at checkout, in the currency’s minor
units. In subscription mode this is the first invoice’s
total — all items after any discounts are applied.
URL the recipient opens to pay
(https://zero.linqapp.com/pay/{slug}?session=...).
discount?: Discount { coupon, label, promotion_code } Subscription mode — the discount Stripe applied, read back
from the coupon. Absent when none was applied.
Subscription mode — the discount Stripe applied, read back from the coupon. Absent when none was applied.
mode?: "payment" | "subscription"Whether the request collected a one-time charge or started a subscription.
Whether the request collected a one-time charge or started a subscription.
natural?: Natural { payment_request_id, transaction_id } Natural-rail join keys, present when rail: natural.
Natural-rail join keys, present when rail: natural.
stripe?: Stripe { customer_id, payment_intent_id, subscription_id } Ids of the Stripe objects on your connected account — join
keys into your own Stripe Dashboard/API. Manage a
subscription’s post-checkout lifecycle with subscription_id.
Ids of the Stripe objects on your connected account — join
keys into your own Stripe Dashboard/API. Manage a
subscription’s post-checkout lifecycle with subscription_id.
LocationSharingStartedWebhookEvent { api_version, created_at, data, 5 more }
data: Data { began_at, chat_id, ends_at, 2 more }
When location sharing started. Always present: falls back to when the share was first observed if the device reported no start time.
The chat this share was first sent to. Location sharing is per-contact rather than per-chat, so the location may also be visible in other chats with the same handle; this identifies where the share originated and does not change if the contact later shares into another chat. Null when the originating chat could not be determined.
LocationSharingStoppedWebhookEvent { api_version, created_at, data, 5 more }
data: Data { began_at, chat_id, ended_at, 2 more }
When the sharing session started, matching began_at on its started event. Always present.
The chat the ended share was first sent to, matching the chat_id on its started event. Sharing always stops for the contact as a whole, never for a single chat, so this is the session’s origin rather than the chat it stopped in. Null when the originating chat could not be determined.
PaymentAuthorizedWebhookEvent { api_version, created_at, data, 5 more }
data: Data { id, amount, checkout_url, 17 more } The payment request, as returned by
GET /v3/payment_requests/{paymentRequestId}.
The payment request, as returned by
GET /v3/payment_requests/{paymentRequestId}.
What was charged at checkout, in the currency’s minor
units. In subscription mode this is the first invoice’s
total — all items after any discounts are applied.
URL the recipient opens to pay
(https://zero.linqapp.com/pay/{slug}?session=...).
discount?: Discount { coupon, label, promotion_code } Subscription mode — the discount Stripe applied, read back
from the coupon. Absent when none was applied.
Subscription mode — the discount Stripe applied, read back from the coupon. Absent when none was applied.
mode?: "payment" | "subscription"Whether the request collected a one-time charge or started a subscription.
Whether the request collected a one-time charge or started a subscription.
natural?: Natural { payment_request_id, transaction_id } Natural-rail join keys, present when rail: natural.
Natural-rail join keys, present when rail: natural.
stripe?: Stripe { customer_id, payment_intent_id, subscription_id } Ids of the Stripe objects on your connected account — join
keys into your own Stripe Dashboard/API. Manage a
subscription’s post-checkout lifecycle with subscription_id.
Ids of the Stripe objects on your connected account — join
keys into your own Stripe Dashboard/API. Manage a
subscription’s post-checkout lifecycle with subscription_id.
PaymentCanceledWebhookEvent { api_version, created_at, data, 5 more }
data: Data { id, amount, checkout_url, 17 more } The payment request, as returned by
GET /v3/payment_requests/{paymentRequestId}.
The payment request, as returned by
GET /v3/payment_requests/{paymentRequestId}.
What was charged at checkout, in the currency’s minor
units. In subscription mode this is the first invoice’s
total — all items after any discounts are applied.
URL the recipient opens to pay
(https://zero.linqapp.com/pay/{slug}?session=...).
discount?: Discount { coupon, label, promotion_code } Subscription mode — the discount Stripe applied, read back
from the coupon. Absent when none was applied.
Subscription mode — the discount Stripe applied, read back from the coupon. Absent when none was applied.
mode?: "payment" | "subscription"Whether the request collected a one-time charge or started a subscription.
Whether the request collected a one-time charge or started a subscription.
natural?: Natural { payment_request_id, transaction_id } Natural-rail join keys, present when rail: natural.
Natural-rail join keys, present when rail: natural.
stripe?: Stripe { customer_id, payment_intent_id, subscription_id } Ids of the Stripe objects on your connected account — join
keys into your own Stripe Dashboard/API. Manage a
subscription’s post-checkout lifecycle with subscription_id.
Ids of the Stripe objects on your connected account — join
keys into your own Stripe Dashboard/API. Manage a
subscription’s post-checkout lifecycle with subscription_id.
PaymentDeclinedWebhookEvent { api_version, created_at, data, 5 more }
data: Data { id, amount, checkout_url, 17 more } The payment request, as returned by
GET /v3/payment_requests/{paymentRequestId}.
The payment request, as returned by
GET /v3/payment_requests/{paymentRequestId}.
What was charged at checkout, in the currency’s minor
units. In subscription mode this is the first invoice’s
total — all items after any discounts are applied.
URL the recipient opens to pay
(https://zero.linqapp.com/pay/{slug}?session=...).
discount?: Discount { coupon, label, promotion_code } Subscription mode — the discount Stripe applied, read back
from the coupon. Absent when none was applied.
Subscription mode — the discount Stripe applied, read back from the coupon. Absent when none was applied.
mode?: "payment" | "subscription"Whether the request collected a one-time charge or started a subscription.
Whether the request collected a one-time charge or started a subscription.
natural?: Natural { payment_request_id, transaction_id } Natural-rail join keys, present when rail: natural.
Natural-rail join keys, present when rail: natural.
stripe?: Stripe { customer_id, payment_intent_id, subscription_id } Ids of the Stripe objects on your connected account — join
keys into your own Stripe Dashboard/API. Manage a
subscription’s post-checkout lifecycle with subscription_id.
Ids of the Stripe objects on your connected account — join
keys into your own Stripe Dashboard/API. Manage a
subscription’s post-checkout lifecycle with subscription_id.
PaymentExpiredWebhookEvent { api_version, created_at, data, 5 more }
data: Data { id, amount, checkout_url, 17 more } The payment request, as returned by
GET /v3/payment_requests/{paymentRequestId}.
The payment request, as returned by
GET /v3/payment_requests/{paymentRequestId}.
What was charged at checkout, in the currency’s minor
units. In subscription mode this is the first invoice’s
total — all items after any discounts are applied.
URL the recipient opens to pay
(https://zero.linqapp.com/pay/{slug}?session=...).
discount?: Discount { coupon, label, promotion_code } Subscription mode — the discount Stripe applied, read back
from the coupon. Absent when none was applied.
Subscription mode — the discount Stripe applied, read back from the coupon. Absent when none was applied.
mode?: "payment" | "subscription"Whether the request collected a one-time charge or started a subscription.
Whether the request collected a one-time charge or started a subscription.
natural?: Natural { payment_request_id, transaction_id } Natural-rail join keys, present when rail: natural.
Natural-rail join keys, present when rail: natural.
stripe?: Stripe { customer_id, payment_intent_id, subscription_id } Ids of the Stripe objects on your connected account — join
keys into your own Stripe Dashboard/API. Manage a
subscription’s post-checkout lifecycle with subscription_id.
Ids of the Stripe objects on your connected account — join
keys into your own Stripe Dashboard/API. Manage a
subscription’s post-checkout lifecycle with subscription_id.
PaymentSucceededWebhookEvent { api_version, created_at, data, 5 more }
data: Data { id, amount, checkout_url, 17 more } The payment request, as returned by
GET /v3/payment_requests/{paymentRequestId}.
The payment request, as returned by
GET /v3/payment_requests/{paymentRequestId}.
What was charged at checkout, in the currency’s minor
units. In subscription mode this is the first invoice’s
total — all items after any discounts are applied.
URL the recipient opens to pay
(https://zero.linqapp.com/pay/{slug}?session=...).
discount?: Discount { coupon, label, promotion_code } Subscription mode — the discount Stripe applied, read back
from the coupon. Absent when none was applied.
Subscription mode — the discount Stripe applied, read back from the coupon. Absent when none was applied.
mode?: "payment" | "subscription"Whether the request collected a one-time charge or started a subscription.
Whether the request collected a one-time charge or started a subscription.
natural?: Natural { payment_request_id, transaction_id } Natural-rail join keys, present when rail: natural.
Natural-rail join keys, present when rail: natural.
stripe?: Stripe { customer_id, payment_intent_id, subscription_id } Ids of the Stripe objects on your connected account — join
keys into your own Stripe Dashboard/API. Manage a
subscription’s post-checkout lifecycle with subscription_id.
Ids of the Stripe objects on your connected account — join
keys into your own Stripe Dashboard/API. Manage a
subscription’s post-checkout lifecycle with subscription_id.
ZeroDayRetentionUpdatedWebhookEvent { api_version, created_at, data, 5 more } Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
data: Data { actor, occurred_at, origin, 11 more } A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
actor: Actor { type, id, email, name } Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Human-readable label, identical to the Activity page. For display only; the wording may change without a new webhook version.
change?: Change { first_name, from, image_url, 2 more } The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
first_name?: FirstName { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
image_url?: ImageURL { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
environment?: Environment { name, type } An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
method?: "code" | "sso" | "google" | 2 moreHow the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
How the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
PhoneNumberForwardingUpdatedWebhookEvent { api_version, created_at, data, 5 more } Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
data: Data { actor, occurred_at, origin, 11 more } A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
actor: Actor { type, id, email, name } Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Human-readable label, identical to the Activity page. For display only; the wording may change without a new webhook version.
change?: Change { first_name, from, image_url, 2 more } The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
first_name?: FirstName { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
image_url?: ImageURL { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
environment?: Environment { name, type } An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
method?: "code" | "sso" | "google" | 2 moreHow the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
How the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
EnvironmentLineMovedWebhookEvent { api_version, created_at, data, 5 more } Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
data: Data { actor, occurred_at, origin, 11 more } A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
actor: Actor { type, id, email, name } Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Human-readable label, identical to the Activity page. For display only; the wording may change without a new webhook version.
change?: Change { first_name, from, image_url, 2 more } The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
first_name?: FirstName { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
image_url?: ImageURL { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
environment?: Environment { name, type } An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
method?: "code" | "sso" | "google" | 2 moreHow the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
How the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
ContactCardCreatedWebhookEvent { api_version, created_at, data, 5 more } Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
data: Data { actor, occurred_at, origin, 11 more } A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
actor: Actor { type, id, email, name } Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Human-readable label, identical to the Activity page. For display only; the wording may change without a new webhook version.
change?: Change { first_name, from, image_url, 2 more } The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
first_name?: FirstName { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
image_url?: ImageURL { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
environment?: Environment { name, type } An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
method?: "code" | "sso" | "google" | 2 moreHow the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
How the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
ContactCardUpdatedWebhookEvent { api_version, created_at, data, 5 more } Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
data: Data { actor, occurred_at, origin, 11 more } A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
actor: Actor { type, id, email, name } Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Human-readable label, identical to the Activity page. For display only; the wording may change without a new webhook version.
change?: Change { first_name, from, image_url, 2 more } The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
first_name?: FirstName { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
image_url?: ImageURL { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
environment?: Environment { name, type } An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
method?: "code" | "sso" | "google" | 2 moreHow the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
How the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
ContactCardDeletedWebhookEvent { api_version, created_at, data, 5 more } Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
data: Data { actor, occurred_at, origin, 11 more } A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
actor: Actor { type, id, email, name } Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Human-readable label, identical to the Activity page. For display only; the wording may change without a new webhook version.
change?: Change { first_name, from, image_url, 2 more } The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
first_name?: FirstName { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
image_url?: ImageURL { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
environment?: Environment { name, type } An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
method?: "code" | "sso" | "google" | 2 moreHow the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
How the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
APITokenCreatedWebhookEvent { api_version, created_at, data, 5 more } Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
data: Data { actor, occurred_at, origin, 11 more } A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
actor: Actor { type, id, email, name } Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Human-readable label, identical to the Activity page. For display only; the wording may change without a new webhook version.
change?: Change { first_name, from, image_url, 2 more } The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
first_name?: FirstName { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
image_url?: ImageURL { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
environment?: Environment { name, type } An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
method?: "code" | "sso" | "google" | 2 moreHow the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
How the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
APITokenRenamedWebhookEvent { api_version, created_at, data, 5 more } Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
data: Data { actor, occurred_at, origin, 11 more } A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
actor: Actor { type, id, email, name } Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Human-readable label, identical to the Activity page. For display only; the wording may change without a new webhook version.
change?: Change { first_name, from, image_url, 2 more } The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
first_name?: FirstName { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
image_url?: ImageURL { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
environment?: Environment { name, type } An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
method?: "code" | "sso" | "google" | 2 moreHow the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
How the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
APITokenExpiryScheduledWebhookEvent { api_version, created_at, data, 5 more } Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
data: Data { actor, occurred_at, origin, 11 more } A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
actor: Actor { type, id, email, name } Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Human-readable label, identical to the Activity page. For display only; the wording may change without a new webhook version.
change?: Change { first_name, from, image_url, 2 more } The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
first_name?: FirstName { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
image_url?: ImageURL { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
environment?: Environment { name, type } An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
method?: "code" | "sso" | "google" | 2 moreHow the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
How the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
APITokenExpiredWebhookEvent { api_version, created_at, data, 5 more } Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
data: Data { actor, occurred_at, origin, 11 more } A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
actor: Actor { type, id, email, name } Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Human-readable label, identical to the Activity page. For display only; the wording may change without a new webhook version.
change?: Change { first_name, from, image_url, 2 more } The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
first_name?: FirstName { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
image_url?: ImageURL { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
environment?: Environment { name, type } An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
method?: "code" | "sso" | "google" | 2 moreHow the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
How the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
APITokenActivatedWebhookEvent { api_version, created_at, data, 5 more } Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
data: Data { actor, occurred_at, origin, 11 more } A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
actor: Actor { type, id, email, name } Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Human-readable label, identical to the Activity page. For display only; the wording may change without a new webhook version.
change?: Change { first_name, from, image_url, 2 more } The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
first_name?: FirstName { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
image_url?: ImageURL { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
environment?: Environment { name, type } An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
method?: "code" | "sso" | "google" | 2 moreHow the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
How the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
APITokenDeletedWebhookEvent { api_version, created_at, data, 5 more } Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
data: Data { actor, occurred_at, origin, 11 more } A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
actor: Actor { type, id, email, name } Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Human-readable label, identical to the Activity page. For display only; the wording may change without a new webhook version.
change?: Change { first_name, from, image_url, 2 more } The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
first_name?: FirstName { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
image_url?: ImageURL { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
environment?: Environment { name, type } An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
method?: "code" | "sso" | "google" | 2 moreHow the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
How the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
EnvironmentCreatedWebhookEvent { api_version, created_at, data, 5 more } Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
data: Data { actor, occurred_at, origin, 11 more } A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
actor: Actor { type, id, email, name } Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Human-readable label, identical to the Activity page. For display only; the wording may change without a new webhook version.
change?: Change { first_name, from, image_url, 2 more } The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
first_name?: FirstName { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
image_url?: ImageURL { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
environment?: Environment { name, type } An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
method?: "code" | "sso" | "google" | 2 moreHow the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
How the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
EnvironmentRenamedWebhookEvent { api_version, created_at, data, 5 more } Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
data: Data { actor, occurred_at, origin, 11 more } A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
actor: Actor { type, id, email, name } Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Human-readable label, identical to the Activity page. For display only; the wording may change without a new webhook version.
change?: Change { first_name, from, image_url, 2 more } The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
first_name?: FirstName { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
image_url?: ImageURL { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
environment?: Environment { name, type } An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
method?: "code" | "sso" | "google" | 2 moreHow the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
How the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
EnvironmentDeletedWebhookEvent { api_version, created_at, data, 5 more } Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
data: Data { actor, occurred_at, origin, 11 more } A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
actor: Actor { type, id, email, name } Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Human-readable label, identical to the Activity page. For display only; the wording may change without a new webhook version.
change?: Change { first_name, from, image_url, 2 more } The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
first_name?: FirstName { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
image_url?: ImageURL { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
environment?: Environment { name, type } An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
method?: "code" | "sso" | "google" | 2 moreHow the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
How the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
WebhookSubscriptionCreatedWebhookEvent { api_version, created_at, data, 5 more } Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
data: Data { actor, occurred_at, origin, 11 more } A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
actor: Actor { type, id, email, name } Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Human-readable label, identical to the Activity page. For display only; the wording may change without a new webhook version.
change?: Change { first_name, from, image_url, 2 more } The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
first_name?: FirstName { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
image_url?: ImageURL { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
environment?: Environment { name, type } An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
method?: "code" | "sso" | "google" | 2 moreHow the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
How the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
WebhookSubscriptionDeletedWebhookEvent { api_version, created_at, data, 5 more } Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
data: Data { actor, occurred_at, origin, 11 more } A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
actor: Actor { type, id, email, name } Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Human-readable label, identical to the Activity page. For display only; the wording may change without a new webhook version.
change?: Change { first_name, from, image_url, 2 more } The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
first_name?: FirstName { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
image_url?: ImageURL { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
environment?: Environment { name, type } An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
method?: "code" | "sso" | "google" | 2 moreHow the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
How the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
WebhookSubscriptionTargetURLChangedWebhookEvent { api_version, created_at, data, 5 more } Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
data: Data { actor, occurred_at, origin, 11 more } A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
actor: Actor { type, id, email, name } Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Human-readable label, identical to the Activity page. For display only; the wording may change without a new webhook version.
change?: Change { first_name, from, image_url, 2 more } The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
first_name?: FirstName { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
image_url?: ImageURL { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
environment?: Environment { name, type } An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
method?: "code" | "sso" | "google" | 2 moreHow the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
How the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
WebhookSubscriptionEnabledWebhookEvent { api_version, created_at, data, 5 more } Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
data: Data { actor, occurred_at, origin, 11 more } A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
actor: Actor { type, id, email, name } Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Human-readable label, identical to the Activity page. For display only; the wording may change without a new webhook version.
change?: Change { first_name, from, image_url, 2 more } The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
first_name?: FirstName { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
image_url?: ImageURL { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
environment?: Environment { name, type } An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
method?: "code" | "sso" | "google" | 2 moreHow the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
How the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
WebhookSubscriptionDisabledWebhookEvent { api_version, created_at, data, 5 more } Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
data: Data { actor, occurred_at, origin, 11 more } A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
actor: Actor { type, id, email, name } Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Human-readable label, identical to the Activity page. For display only; the wording may change without a new webhook version.
change?: Change { first_name, from, image_url, 2 more } The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
first_name?: FirstName { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
image_url?: ImageURL { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
environment?: Environment { name, type } An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
method?: "code" | "sso" | "google" | 2 moreHow the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
How the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
WebhookSubscriptionEventsUpdatedWebhookEvent { api_version, created_at, data, 5 more } Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
data: Data { actor, occurred_at, origin, 11 more } A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
actor: Actor { type, id, email, name } Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Human-readable label, identical to the Activity page. For display only; the wording may change without a new webhook version.
change?: Change { first_name, from, image_url, 2 more } The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
first_name?: FirstName { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
image_url?: ImageURL { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
environment?: Environment { name, type } An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
method?: "code" | "sso" | "google" | 2 moreHow the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
How the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
WebhookSubscriptionPhoneNumbersUpdatedWebhookEvent { api_version, created_at, data, 5 more } Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
data: Data { actor, occurred_at, origin, 11 more } A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
actor: Actor { type, id, email, name } Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Human-readable label, identical to the Activity page. For display only; the wording may change without a new webhook version.
change?: Change { first_name, from, image_url, 2 more } The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
first_name?: FirstName { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
image_url?: ImageURL { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
environment?: Environment { name, type } An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
method?: "code" | "sso" | "google" | 2 moreHow the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
How the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
WebhookSubscriptionRoutingHeadersSetWebhookEvent { api_version, created_at, data, 5 more } Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
data: Data { actor, occurred_at, origin, 11 more } A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
actor: Actor { type, id, email, name } Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Human-readable label, identical to the Activity page. For display only; the wording may change without a new webhook version.
change?: Change { first_name, from, image_url, 2 more } The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
first_name?: FirstName { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
image_url?: ImageURL { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
environment?: Environment { name, type } An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
method?: "code" | "sso" | "google" | 2 moreHow the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
How the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
WebhookSubscriptionRoutingHeadersClearedWebhookEvent { api_version, created_at, data, 5 more } Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
data: Data { actor, occurred_at, origin, 11 more } A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
actor: Actor { type, id, email, name } Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Human-readable label, identical to the Activity page. For display only; the wording may change without a new webhook version.
change?: Change { first_name, from, image_url, 2 more } The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
first_name?: FirstName { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
image_url?: ImageURL { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
environment?: Environment { name, type } An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
method?: "code" | "sso" | "google" | 2 moreHow the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
How the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
TeamMemberAddedWebhookEvent { api_version, created_at, data, 5 more } Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
data: Data { actor, occurred_at, origin, 11 more } A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
actor: Actor { type, id, email, name } Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Human-readable label, identical to the Activity page. For display only; the wording may change without a new webhook version.
change?: Change { first_name, from, image_url, 2 more } The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
first_name?: FirstName { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
image_url?: ImageURL { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
environment?: Environment { name, type } An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
method?: "code" | "sso" | "google" | 2 moreHow the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
How the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
TeamMemberSignedInWebhookEvent { api_version, created_at, data, 5 more } Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
data: Data { actor, occurred_at, origin, 11 more } A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
actor: Actor { type, id, email, name } Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Human-readable label, identical to the Activity page. For display only; the wording may change without a new webhook version.
change?: Change { first_name, from, image_url, 2 more } The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
first_name?: FirstName { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
image_url?: ImageURL { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
environment?: Environment { name, type } An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
method?: "code" | "sso" | "google" | 2 moreHow the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
How the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
TeamMemberSignedOutWebhookEvent { api_version, created_at, data, 5 more } Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
Webhook payload for account events. One event type per kind of account change. event_id is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. created_at is when the webhook was created and data.occurred_at when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to webhook_subscription.* events receives an event about the subscription that was just created or edited.
data: Data { actor, occurred_at, origin, 11 more } A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
A change on your account, the same change shown on your Activity page. Every event carries summary, occurred_at, actor and origin. The object fields (api_token, webhook_subscription, environment, contact_card, phone_number, team_member) identify what changed; on update events change describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don’t apply; null appears only inside change.
actor: Actor { type, id, email, name } Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Who made the change. team_member carries the member’s id, name and email; other types carry no identity. system is a change made by Linq, matching “System” on your Activity page. unknown means the actor could not be identified.
Human-readable label, identical to the Activity page. For display only; the wording may change without a new webhook version.
change?: Change { first_name, from, image_url, 2 more } The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
The transition an update event describes: from is the value before and to the value after. Present only on update events (*.updated, *.renamed, *_changed, api_token.expiry_scheduled, environment.line_moved, webhook_subscription.routing_headers_*); created, deleted, enabled, disabled, expired and activated events never carry it. null means none: to: null means cleared and from: null means first set. The value type depends on the event and is given in each event’s description. contact_card.updated uses first_name, last_name and image_url instead of from and to, each present only when that field changed.
first_name?: FirstName { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
image_url?: ImageURL { from, to } A single field’s change, on contact_card.updated. Present only for the field that changed.
A single field’s change, on contact_card.updated. Present only for the field that changed.
environment?: Environment { name, type } An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
An environment, identified by name. Production is {"name": "Production", "type": "environment"}; a named environment you created (e.g. “Staging”) looks the same shape, just with its own name.
method?: "code" | "sso" | "google" | 2 moreHow the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.
How the team member signed in. code is a one-time code sent by email or text. Only on team_member.signed_in.