Getting Started
Teams
Threads
Account Links
Members
Statuses
Colors
curl --request GET \
--url https://inboxapp.com/api/v1/threads{
"threads": [
{
"id": "<string>",
"done": true,
"assigneeId": "df6jbw4h36...",
"lastMessageTimestamp": "2025-08-22T12:00:00.000Z",
"computedSortTimestamp": "2025-08-22T12:00:00.000Z",
"createdAt": "2023-11-07T05:31:56Z",
"status": "active",
"accountLinkId": "<string>",
"isSyncing": true,
"isRequest": true,
"lastMessage": {
"id": "<string>",
"content": "<string>",
"authorId": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"userId": "df6jbw4h36...",
"campaignId": "df6jbw4h36..."
},
"prospect": {
"platform": "twitter",
"platformId": "<string>",
"externalId": "l44e15irdq4db30i77cgphhx",
"documentId": 858224163,
"displayName": "<string>",
"username": "<string>",
"handle": "<string>",
"image": "https://pbs.twimg.com/profile_images/1954360649393295360/rwp-vVt6.jpg",
"imageNormalized": "https://pbs.twimg.com/profile_images/1954360649393295360/rwp-vVt6.jpg",
"bio": "Social Selling CRM Close deals faster, stay organized, and never miss an opportunity. Starting with X",
"location": "San Francisco, CA",
"profileUrl": "<string>",
"websiteUrl": "https://inboxapp.com",
"websiteDomain": "inboxapp.com",
"verified": "none",
"profileType": "personal",
"isProtected": true,
"followerCount": 123,
"followingCount": 123,
"postCount": 123,
"engagementCount": 2613,
"listedCount": 18,
"platformCreatedAt": "2022-09-03T17:58:06.000Z",
"firstSeenAt": "2024-07-09T14:08:49.000Z",
"lastUpdatedAt": "2023-11-07T05:31:56Z",
"lastEnrichedAt": "2025-11-10T18:03:16.000Z",
"lastActiveAt": "2025-11-10T12:00:00.000Z",
"source": "cached",
"isFresh": true,
"isStale": true,
"confidence": 0.5,
"platformData": {
"isVerifiedBlue": true,
"isVerifiedGold": true,
"isVerifiedGray": true,
"professionalCategory": "986",
"urlEntities": [
{
"url": "<string>",
"expandedUrl": "<string>",
"displayUrl": "<string>",
"indices": "<array>"
}
],
"bannerUrl": "https://pbs.twimg.com/profile_banners/1566123362161725440/1753273968",
"tweetsCount": 123,
"favoritesCount": 123,
"rawData": {}
},
"context": {
"tags": [
"<string>"
],
"statusId": "df6jbw4h36...",
"valuation": 599,
"notes": "This prospect is a potential customer."
}
}
}
],
"nextCursor": {
"timestamp": "2023-11-07T05:31:56Z",
"id": "<string>"
}
}List Threads
List threads ordered by recency with advanced filtering
curl --request GET \
--url https://inboxapp.com/api/v1/threads{
"threads": [
{
"id": "<string>",
"done": true,
"assigneeId": "df6jbw4h36...",
"lastMessageTimestamp": "2025-08-22T12:00:00.000Z",
"computedSortTimestamp": "2025-08-22T12:00:00.000Z",
"createdAt": "2023-11-07T05:31:56Z",
"status": "active",
"accountLinkId": "<string>",
"isSyncing": true,
"isRequest": true,
"lastMessage": {
"id": "<string>",
"content": "<string>",
"authorId": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"userId": "df6jbw4h36...",
"campaignId": "df6jbw4h36..."
},
"prospect": {
"platform": "twitter",
"platformId": "<string>",
"externalId": "l44e15irdq4db30i77cgphhx",
"documentId": 858224163,
"displayName": "<string>",
"username": "<string>",
"handle": "<string>",
"image": "https://pbs.twimg.com/profile_images/1954360649393295360/rwp-vVt6.jpg",
"imageNormalized": "https://pbs.twimg.com/profile_images/1954360649393295360/rwp-vVt6.jpg",
"bio": "Social Selling CRM Close deals faster, stay organized, and never miss an opportunity. Starting with X",
"location": "San Francisco, CA",
"profileUrl": "<string>",
"websiteUrl": "https://inboxapp.com",
"websiteDomain": "inboxapp.com",
"verified": "none",
"profileType": "personal",
"isProtected": true,
"followerCount": 123,
"followingCount": 123,
"postCount": 123,
"engagementCount": 2613,
"listedCount": 18,
"platformCreatedAt": "2022-09-03T17:58:06.000Z",
"firstSeenAt": "2024-07-09T14:08:49.000Z",
"lastUpdatedAt": "2023-11-07T05:31:56Z",
"lastEnrichedAt": "2025-11-10T18:03:16.000Z",
"lastActiveAt": "2025-11-10T12:00:00.000Z",
"source": "cached",
"isFresh": true,
"isStale": true,
"confidence": 0.5,
"platformData": {
"isVerifiedBlue": true,
"isVerifiedGold": true,
"isVerifiedGray": true,
"professionalCategory": "986",
"urlEntities": [
{
"url": "<string>",
"expandedUrl": "<string>",
"displayUrl": "<string>",
"indices": "<array>"
}
],
"bannerUrl": "https://pbs.twimg.com/profile_banners/1566123362161725440/1753273968",
"tweetsCount": 123,
"favoritesCount": 123,
"rawData": {}
},
"context": {
"tags": [
"<string>"
],
"statusId": "df6jbw4h36...",
"valuation": 599,
"notes": "This prospect is a potential customer."
}
}
}
],
"nextCursor": {
"timestamp": "2023-11-07T05:31:56Z",
"id": "<string>"
}
}Query Parameters
Filter by specific account links. Omit to include all accounts, or provide an array of account link IDs to filter by specific accounts.
Pagination cursor. Omit to start from the beginning. Use the cursor returned from the previous response to fetch the next page.
Inbox view to filter threads. 'default' shows active threads, 'no-reply' shows threads awaiting response, 'requests' shows message requests, 'archived' shows archived threads.
default, no-reply, requests, archived Advanced filtering options for threads. Pass null or omit to disable all filters.
Show child attributes
Show child attributes
Filter threads by tags. Use selectedIds to filter by specific tags, or set noTags to true to show only untagged threads.
Filter threads by status. Use selectedIds to filter by specific statuses, or set noStatus to true to show only threads without a status.
Filter threads by assignee. Use selectedIds to filter by specific team members, or set noAssignee to true to show only unassigned threads.
Filter threads by campaign. Use selectedIds to filter by specific campaigns, or set noCampaign to true to show only non-campaign threads.
Sort order for threads. 'desc' shows most recent first (default), 'asc' shows oldest first.
asc, desc Maximum number of threads to return per page. Defaults to 20, maximum 100.
1 <= x <= 100Response
OK
Show child attributes
Show child attributes
The ID of the thread.
Whether the thread has been archived or not.
The ID of the member assigned to the thread.
"df6jbw4h36..."
The timestamp of the last message in the thread.
"2025-08-22T12:00:00.000Z"
The timestamp of the last message in the thread or the creation date if no messages have been sent.
"2025-08-22T12:00:00.000Z"
The timestamp of when the thread was created in Inbox.
Idle threads are hidden from the main inbox, i.e. when previewing a profile using 'Quick peek'
active, idle The ID of the account link associated with this thread.
Whether the thread is currently syncing data from Twitter to load all messages.
Whether this conversation is a message request.
Show child attributes
Show child attributes
The ID of the last message in the thread. This is the message that will be displayed in the thread preview.
The content of the last message in the thread.
Points to either the accountLinkId or the externalId of the thread
The timestamp of when the last message was created in Inbox.
The ID of the Inbox user who sent the last message in the thread. Note that this is not a member ID.
"df6jbw4h36..."
The ID of the campaign that sent the last message in the thread. This is only set if the last message was sent by a campaign.
"df6jbw4h36..."
Show child attributes
Show child attributes
The social platform where this prospect's profile exists.
twitter, sandbox The platform's native user ID. For Twitter, this is the numeric user ID. This is the primary identifier for cross-platform operations.
Unique identifier for this prospect in the Inbox system. Null if the prospect hasn't been imported yet.
"l44e15irdq4db30i77cgphhx"
Search index identifier for fast lookups. Null if the prospect isn't indexed yet.
858224163
The user's display name as shown on their profile. For businesses, typically the company name.
The unique handle/username on the platform, without the @ symbol. Always lowercase for Twitter.
The username with @ symbol prefix, ready for display in UI. Computed from username.
Profile picture URL as provided by platform. May contain size suffixes or be lower quality. Prefer imageNormalized for display.
"https://pbs.twimg.com/profile_images/1954360649393295360/rwp-vVt6.jpg"
Profile picture URL normalized to highest quality available. Size suffixes removed. Prefer this over image for display.
"https://pbs.twimg.com/profile_images/1954360649393295360/rwp-vVt6.jpg"
The user's profile bio/description text.
"Social Selling CRM Close deals faster, stay organized, and never miss an opportunity. Starting with X"
Freeform location string as entered by user. Not normalized or geocoded.
"San Francisco, CA"
Direct link to view this profile on the platform.
External website URL the user provided in their profile, if any.
"https://inboxapp.com"
Domain extracted from websiteUrl for quick filtering and grouping.
"inboxapp.com"
Verification badge status: none (no badge), verified (blue checkmark), business (gold badge), or government (gray badge).
none, verified, business, government Account type classification: personal (individual), business (organization), or government (official agency).
personal, business, government Whether the account is private/protected. For Twitter: protected tweets enabled. Private accounts require approval to follow.
Number of users following this account.
Number of users this account follows.
Total content posted by this account. For Twitter: tweet count. For Instagram: post count.
Platform-specific engagement metric. For Twitter: likes/favorites given by user. May be null if platform doesn't provide this.
2613
How many Twitter lists this profile appears on. Useful metric for influence. Null for non-Twitter platforms.
18
When the account was created on the platform. Null if platform doesn't provide this data.
"2022-09-03T17:58:06.000Z"
When this prospect was first added to Inbox. Useful for tracking relationship timeline.
"2024-07-09T14:08:49.000Z"
Most recent update timestamp for any data about this prospect.
When fresh data was last fetched from the platform API. Use this to determine if data needs refresh.
"2025-11-10T18:03:16.000Z"
Last time the profile was active on the platform (posted, liked, or engaged). Platform-dependent availability.
"2025-11-10T12:00:00.000Z"
Data source: cached (stored), indexed (searchable), live (real-time from platform), or merged (combined sources).
cached, indexed, live, merged Indicates if data was updated within the last 7 days. Fresh data is current and reliable.
Indicates if data hasn't been updated in over 30 days. Stale data may need refreshing for accuracy.
Confidence score for data accuracy (0-1). Higher values indicate more recent and reliable data. 1.0 = real-time, 0.8+ = recent, below 0.5 = potentially outdated.
0 <= x <= 1Show child attributes
Show child attributes
Standard Twitter blue checkmark verification badge.
Gold verification badge indicating a business/brand account on Twitter.
Gray verification badge indicating a government/official account on Twitter.
Professional category ID if the account has set one. Maps to categories like Technology, Media, Education, etc.
"986"
Parsed URL entities from the bio text with expanded and display URLs.
Show child attributes
Show child attributes
Shortened t.co URL as it appears in the tweet text.
Full expanded URL that the t.co link redirects to.
Human-readable display text for the URL (typically domain + path).
Start and end character indices where this URL appears in the bio text.
Profile banner/header image URL (typically 1500x500px). Null if no banner is set.
"https://pbs.twimg.com/profile_banners/1566123362161725440/1753273968"
Total number of tweets posted by this account (all-time count).
Total number of likes/favorites this user has given to other tweets.
Show child attributes
Show child attributes
The tag IDs attached to this prospect.
The status ID of the prospect.
"df6jbw4h36..."
The valuation of the prospect.
599
Notes attached to the prospect.
"This prospect is a potential customer."