Copy
{
"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
The message object.
Show properties
Show properties
The Inbox message ID.
The platform the message belongs to (e.g.,
twitter).The platform’s native message ID.
The Inbox thread ID this message belongs to.
The Inbox team ID.
The author of the message. Either the
accountLinkId (if sent by your team) or the prospect’s externalId.The Inbox user ID of the team member who sent this message, if applicable.
The campaign ID that sent this message, if applicable.
The text content of the message.
How the message was sent:
internal (Inbox UI), external (synced from platform), or api (sent via API).When the message was created (ISO 8601).
When the message was last updated (ISO 8601).
Whether the message has been edited.
Whether the message is end-to-end encrypted.
Normalized URL entities, mentions, hashtags, and tweet shares.
Normalized media and card attachments.
Reactions on this message.
Reply metadata if this message is a reply to another message.
Forward metadata if this message was forwarded.
When the message was soft-deleted in Inbox (ISO 8601).
When the message was deleted on the platform (ISO 8601).
The thread associated with this event.
Show properties
Show properties
The Inbox thread ID.
The platform this thread belongs to. Currently
"twitter".The platform conversation ID.
Whether the thread has been archived.
The ID of the member assigned to the thread.
ISO 8601 timestamp of the last message in the thread.
Timestamp used for sorting — last message time or creation date if no messages exist.
ISO 8601 timestamp of when the thread was created.
"active" or "idle". Idle threads are hidden from the main inbox."unencrypted" or "xChat". Transitions to "xChat" once both parties have exchanged messages.The ID of the account link (connected X account) associated with this thread.
Whether the thread is currently syncing message history from the platform.
Whether this conversation is a message request.
Whether typing indicators are enabled.
null uses the team default.The most recent message in the thread.
Show properties
Show properties
The Inbox message ID.
The message text content.
The
accountLinkId or prospect’s externalId, depending on who sent the message.ISO 8601 timestamp.
The Inbox user ID of the sender, if sent by a team member.
The campaign ID, if sent by a campaign.
The prospect associated with this thread. See the Prospect object for the full shape.