Copy
{
"id": "ck9v2m5nj0xp4wq7ybftrae8",
"seq": 42,
"teamId": "hzcai5t59nn9vsck3rbuepyg",
"type": "thread.created",
"timestamp": "2025-01-15T10:30:00.000Z",
"version": "1.0",
"data": {
"thread": {
"id": "l44e15irdq4db30i77cgphhx",
"platform": "twitter",
"platformId": "1566123362161725440:1876543210987654321",
"done": false,
"assigneeId": null,
"lastMessageTimestamp": null,
"computedSortTimestamp": "2025-01-15T10:30:00.000Z",
"createdAt": "2025-01-15T10:30:00.000Z",
"status": "active",
"variant": "unencrypted",
"accountLinkId": "df6jbw4h36qm5d9iu2sgn7kx",
"isSyncing": false,
"isRequest": false,
"typingIndicatorsEnabled": null,
"lastMessage": null,
"prospect": {
"platform": "twitter",
"platformId": "1876543210987654321",
"externalId": "p8rvk2m5j0xn4wq7ybftcael",
"displayName": "Sarah Chen",
"username": "sarahchen",
"handle": "@sarahchen",
"image": "https://pbs.twimg.com/profile_images/...",
"context": {
"tags": [],
"statusId": null,
"valuation": null,
"notes": null
}
}
},
"prospect": {
"platform": "twitter",
"platformId": "1876543210987654321",
"externalId": "p8rvk2m5j0xn4wq7ybftcael",
"displayName": "Sarah Chen",
"username": "sarahchen",
"handle": "@sarahchen",
"image": "https://pbs.twimg.com/profile_images/...",
"imageNormalized": "https://pbs.twimg.com/profile_images/...",
"bio": "Product designer at Figma. Building tools for the next generation of creators.",
"location": "San Francisco, CA",
"profileUrl": "https://x.com/sarahchen",
"websiteUrl": "https://sarahchen.design",
"websiteDomain": "sarahchen.design",
"verified": "none",
"profileType": "personal",
"isProtected": false,
"followerCount": 12840,
"followingCount": 892,
"postCount": 3420,
"engagementCount": 8912,
"listedCount": 47,
"platformCreatedAt": "2019-03-15T08:00:00.000Z",
"firstSeenAt": "2025-01-15T10:30:00.000Z",
"lastUpdatedAt": "2025-01-15T10:30:00.000Z",
"lastEnrichedAt": "2025-01-15T10:30:00.000Z",
"lastActiveAt": "2025-01-14T22:15:00.000Z",
"source": "live",
"isFresh": true,
"isStale": false,
"confidence": 1.0,
"context": {
"tags": [],
"statusId": null,
"valuation": null,
"notes": null
}
}
}
}
When it fires
Triggered when a new DM thread is created — through the Inbox UI, via the API, or when a prospect messages you for the first time.Payload
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.
The prospect associated with this event, including Inbox context.
Show properties
Show properties
The social platform. Currently
"twitter".The platform’s native user ID (e.g.
"1566123362161725440").The Inbox prospect ID. Null if the prospect hasn’t been fully imported.
Display name as shown on their profile.
Platform username without the
@ symbol.Username with
@ prefix (e.g. "@acmecorp").Profile picture URL as provided by the platform.
Profile picture URL normalized to highest quality. Prefer this over
image for display.Profile bio/description text.
Freeform location string as entered by the user.
Direct link to the profile on the platform.
External website URL from their profile.
Domain extracted from
websiteUrl.Verification status:
"none", "verified", "business", or "government".Account type:
"personal", "business", or "government".Whether the account is private/protected.
Number of followers.
Number of accounts this user follows.
Total posts/tweets by this account.
Platform-specific engagement metric (e.g. likes given on X).
Number of X lists this profile appears on.
ISO 8601 timestamp of when the account was created on the platform.
ISO 8601 timestamp of when this prospect was first added to Inbox.
ISO 8601 timestamp of the most recent data update.
ISO 8601 timestamp of when fresh data was last fetched from the platform.
ISO 8601 timestamp of last platform activity.
Data source:
"cached", "indexed", "live", or "merged".Whether data was updated within the last 7 days.
Whether data hasn’t been updated in over 30 days.
Data accuracy confidence score from
0 to 1.Inbox-specific context for this prospect.