{
"id": "ck9v2m5nj0xp4wq7ybftrae8",
"seq": 51,
"teamId": "hzcai5t59nn9vsck3rbuepyg",
"type": "message.created",
"timestamp": "2025-01-15T14:30:00.000Z",
"version": "1.0",
"data": {
"message": {
"id": "p8rvk2m5j0xn4wq7ybftcael",
"platform": "twitter",
"platformId": "1876543210987654322",
"threadId": "l44e15irdq4db30i77cgphhx",
"teamId": "hzcai5t59nn9vsck3rbuepyg",
"authorId": "1876543210987654321",
"userId": null,
"campaignId": null,
"content": "Hey! I saw your post about the new API. Would love to chat about integrating it with our platform.",
"origin": "external",
"createdAt": "2025-01-15T14:30:00.000Z",
"updatedAt": null,
"isEdited": false,
"isEncrypted": false,
"entities": null,
"attachment": null,
"reactions": [],
"replyData": null,
"forwardData": null,
"deletedAt": null,
"platformDeletedAt": null
},
"thread": {
"id": "l44e15irdq4db30i77cgphhx",
"platform": "twitter",
"platformId": "1566123362161725440:1876543210987654321",
"done": false,
"assigneeId": "r3km7xj9wq5p2bvnhfdteoly",
"lastMessageTimestamp": "2025-01-15T14:30:00.000Z",
"computedSortTimestamp": "2025-01-15T14:30:00.000Z",
"createdAt": "2025-01-10T09:00:00.000Z",
"status": "active",
"variant": "xChat",
"accountLinkId": "df6jbw4h36qm5d9iu2sgn7kx",
"isSyncing": false,
"isRequest": false,
"typingIndicatorsEnabled": true,
"lastMessage": {
"id": "p8rvk2m5j0xn4wq7ybftcael",
"content": "Hey! I saw your post about the new API. Would love to chat about integrating it with our platform.",
"authorId": "1876543210987654321",
"createdAt": "2025-01-15T14:30:00.000Z",
"userId": null,
"campaignId": null
},
"prospect": {
"platform": "twitter",
"platformId": "1876543210987654321",
"externalId": "n7kxqm5d9iu2sgdf6jbw4h36",
"displayName": "Sarah Chen",
"username": "sarahchen",
"handle": "@sarahchen",
"image": "https://pbs.twimg.com/profile_images/example/photo.jpg",
"context": {
"tags": ["l44e15irdq4db30i77cgphhx"],
"statusId": "x9wq5p2bvnhfdteolyr3km7j",
"valuation": 2500,
"notes": "Interested in enterprise plan"
}
}
}
}
}
When it fires
- A prospect sends a DM to one of your connected accounts
- A team member sends a message through the Inbox UI
- A message is sent via the API
- A campaign sends a message to a target
origin field to distinguish the source: external (from the platform), internal (from the Inbox UI), or api (from the API). Campaign messages include a campaignId.
Payload
Message
required
The message object.
Show properties
Show properties
string
The Inbox message ID.
string
The platform the message belongs to (e.g.,
twitter).string | null
The platform’s native message ID.
string
The Inbox thread ID this message belongs to.
string
The Inbox team ID.
string
The author of the message. Either the
accountLinkId (if sent by your team) or the prospect’s externalId.string | null
The Inbox user ID of the team member who sent this message, if applicable.
string | null
The campaign ID that sent this message, if applicable.
string
The text content of the message.
string | null
How the message was sent:
internal (Inbox UI), external (synced from platform), or api (sent via API).string
When the message was created (ISO 8601).
string | null
When the message was last updated (ISO 8601).
boolean
Whether the message has been edited.
boolean | null
Whether the message is end-to-end encrypted.
object | null
Normalized URL entities, mentions, hashtags, and tweet shares.
object | null
Normalized media and card attachments.
array
Reactions on this message.
object | null
Reply metadata if this message is a reply to another message.
object | null
Forward metadata if this message was forwarded.
string | null
When the message was soft-deleted in Inbox (ISO 8601).
string | null
When the message was deleted on the platform (ISO 8601).
Thread
required
The thread associated with this event.
Show properties
Show properties
string
The Inbox thread ID.
string
The platform this thread belongs to. Currently
"twitter".string
The platform conversation ID.
boolean
Whether the thread has been archived.
string | null
The ID of the member assigned to the thread.
string | null
ISO 8601 timestamp of the last message in the thread.
string | null
Timestamp used for sorting — last message time or creation date if no messages exist.
string
ISO 8601 timestamp of when the thread was created.
string
"active" or "idle". Idle threads are hidden from the main inbox.string
"unencrypted" or "xChat". Transitions to "xChat" once both parties have exchanged messages.string
The ID of the account link (connected X account) associated with this thread.
boolean
Whether the thread is currently syncing message history from the platform.
boolean
Whether this conversation is a message request.
boolean | null
Whether typing indicators are enabled.
null uses the team default.object | null
The most recent message in the thread.
Show properties
Show properties
object
The prospect associated with this thread. See the Prospect object for the full shape.