{
"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
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.
object
required
The prospect associated with this event, including Inbox context.
Show properties
Show properties
string
The social platform. Currently
"twitter".string
The platform’s native user ID (e.g.
"1566123362161725440").string | null
The Inbox prospect ID. Null if the prospect hasn’t been fully imported.
string
Display name as shown on their profile.
string
Platform username without the
@ symbol.string
Username with
@ prefix (e.g. "@acmecorp").string | null
Profile picture URL as provided by the platform.
string | null
Profile picture URL normalized to highest quality. Prefer this over
image for display.string | null
Profile bio/description text.
string | null
Freeform location string as entered by the user.
string
Direct link to the profile on the platform.
string | null
External website URL from their profile.
string | null
Domain extracted from
websiteUrl.string
Verification status:
"none", "verified", "business", or "government".string
Account type:
"personal", "business", or "government".boolean
Whether the account is private/protected.
number
Number of followers.
number
Number of accounts this user follows.
number
Total posts/tweets by this account.
number | null
Platform-specific engagement metric (e.g. likes given on X).
number | null
Number of X lists this profile appears on.
string | null
ISO 8601 timestamp of when the account was created on the platform.
string | null
ISO 8601 timestamp of when this prospect was first added to Inbox.
string
ISO 8601 timestamp of the most recent data update.
string | null
ISO 8601 timestamp of when fresh data was last fetched from the platform.
string | null
ISO 8601 timestamp of last platform activity.
string
Data source:
"cached", "indexed", "live", or "merged".boolean
Whether data was updated within the last 7 days.
boolean
Whether data hasn’t been updated in over 30 days.
number
Data accuracy confidence score from
0 to 1.