{
"id": "ck9v2m5nj0xp4wq7ybftrae8",
"seq": 203,
"teamId": "hzcai5t59nn9vsck3rbuepyg",
"type": "prospect.tagsChanged",
"timestamp": "2025-01-15T16:45:00.000Z",
"version": "1.0",
"data": {
"prospect": {
"platform": "twitter",
"platformId": "1876543210987654321",
"externalId": "n7kxqm5d9iu2sgdf6jbw4h36",
"displayName": "Sarah Chen",
"username": "sarahchen",
"handle": "@sarahchen",
"image": "https://pbs.twimg.com/profile_images/example/photo.jpg",
"imageNormalized": "https://pbs.twimg.com/profile_images/example/photo.jpg",
"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-10T09:00:00.000Z",
"lastUpdatedAt": "2025-01-15T16:45:00.000Z",
"lastEnrichedAt": "2025-01-14T12:00:00.000Z",
"lastActiveAt": "2025-01-15T11:30:00.000Z",
"source": "cached",
"isFresh": true,
"isStale": false,
"confidence": 0.95,
"context": {
"tags": [
"l44e15irdq4db30i77cgphhx",
"r3km7xj9wq5p2bvnhfdteoly",
"x9wq5p2bvnhfdteolyr3km7j"
],
"statusId": "n5xr8yk0wr6q3cwohgeufqmz",
"valuation": 2500,
"notes": "Interested in enterprise plan"
}
}
}
}
When it fires
- A tag is added to a prospect through the Inbox UI or the API
- A tag is removed from a prospect
- Multiple tags are added or removed in a single operation
context.tags array in the payload reflects the current set of tag IDs after the change. To determine which tags were added or removed, compare against the previous state from your system.
Payload
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.