Copy
{
"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
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.