target.contacted

{
  "id": "ck9v2m5nj0xp4wq7ybftrae8",
  "seq": 401,
  "teamId": "hzcai5t59nn9vsck3rbuepyg",
  "type": "target.contacted",
  "timestamp": "2025-01-16T10:05:00.000Z",
  "version": "1.0",
  "data": {
    "campaign": {
      "id": "m4wq7ybftcaelp8rvk2m5j0x",
      "name": "Q1 Product Launch Outreach",
      "description": "Reaching out to design leaders about our new collaboration features",
      "status": "active",
      "dryRun": false,
      "targetsCount": 250,
      "contactedCount": 88,
      "repliesCount": 12,
      "completionRate": 0.352,
      "replyRate": 0.136,
      "createdAt": "2025-01-10T09:00:00.000Z",
      "updatedAt": "2025-01-16T10:05:00.000Z",
      "pausedAt": null,
      "completedAt": null,
      "lastStartedAt": "2025-01-12T08:00:00.000Z"
    },
    "thread": {
      "id": "l44e15irdq4db30i77cgphhx",
      "platform": "twitter",
      "platformId": "1566123362161725440:1876543210987654321",
      "done": false,
      "assigneeId": null,
      "lastMessageTimestamp": "2025-01-16T10:05:00.000Z",
      "computedSortTimestamp": "2025-01-16T10:05:00.000Z",
      "createdAt": "2025-01-16T10:05:00.000Z",
      "status": "active",
      "variant": "unencrypted",
      "accountLinkId": "df6jbw4h36qm5d9iu2sgn7kx",
      "isSyncing": false,
      "isRequest": false,
      "typingIndicatorsEnabled": null,
      "lastMessage": {
        "id": "p8rvk2m5j0xn4wq7ybftcael",
        "content": "Hi Sarah — I noticed your work on the Figma design system. We just launched a collaboration API that might be a great fit for your team. Would love to chat!",
        "authorId": "df6jbw4h36qm5d9iu2sgn7kx",
        "createdAt": "2025-01-16T10:05:00.000Z",
        "userId": null,
        "campaignId": "m4wq7ybftcaelp8rvk2m5j0x"
      },
      "prospect": {
        "platform": "twitter",
        "platformId": "1876543210987654321",
        "externalId": "n7kxqm5d9iu2sgdf6jbw4h36",
        "displayName": "Sarah Chen",
        "username": "sarahchen",
        "handle": "@sarahchen",
        "image": "https://pbs.twimg.com/profile_images/example/photo.jpg",
        "context": {
          "tags": [],
          "statusId": null,
          "valuation": null,
          "notes": null
        }
      }
    },
    "message": {
      "id": "p8rvk2m5j0xn4wq7ybftcael",
      "platform": "twitter",
      "platformId": "1876543210987654322",
      "threadId": "l44e15irdq4db30i77cgphhx",
      "teamId": "hzcai5t59nn9vsck3rbuepyg",
      "authorId": "df6jbw4h36qm5d9iu2sgn7kx",
      "userId": null,
      "campaignId": "m4wq7ybftcaelp8rvk2m5j0x",
      "content": "Hi Sarah — I noticed your work on the Figma design system. We just launched a collaboration API that might be a great fit for your team. Would love to chat!",
      "origin": "internal",
      "createdAt": "2025-01-16T10:05:00.000Z",
      "updatedAt": null,
      "isEdited": false,
      "isEncrypted": false,
      "entities": null,
      "attachment": null,
      "reactions": [],
      "replyData": null,
      "forwardData": null,
      "deletedAt": null,
      "platformDeletedAt": null
    },
    "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-15T10:00:00.000Z",
      "lastUpdatedAt": "2025-01-16T10:05:00.000Z",
      "lastEnrichedAt": "2025-01-15T10:00:00.000Z",
      "lastActiveAt": "2025-01-16T08:30:00.000Z",
      "source": "cached",
      "isFresh": true,
      "isStale": false,
      "confidence": 0.95,
      "context": {
        "tags": [],
        "statusId": null,
        "valuation": null,
        "notes": null
      }
    }
  }
}

{
  "id": "ck9v2m5nj0xp4wq7ybftrae8",
  "seq": 401,
  "teamId": "hzcai5t59nn9vsck3rbuepyg",
  "type": "target.contacted",
  "timestamp": "2025-01-16T10:05:00.000Z",
  "version": "1.0",
  "data": {
    "campaign": {
      "id": "m4wq7ybftcaelp8rvk2m5j0x",
      "name": "Q1 Product Launch Outreach",
      "description": "Reaching out to design leaders about our new collaboration features",
      "status": "active",
      "dryRun": false,
      "targetsCount": 250,
      "contactedCount": 88,
      "repliesCount": 12,
      "completionRate": 0.352,
      "replyRate": 0.136,
      "createdAt": "2025-01-10T09:00:00.000Z",
      "updatedAt": "2025-01-16T10:05:00.000Z",
      "pausedAt": null,
      "completedAt": null,
      "lastStartedAt": "2025-01-12T08:00:00.000Z"
    },
    "thread": {
      "id": "l44e15irdq4db30i77cgphhx",
      "platform": "twitter",
      "platformId": "1566123362161725440:1876543210987654321",
      "done": false,
      "assigneeId": null,
      "lastMessageTimestamp": "2025-01-16T10:05:00.000Z",
      "computedSortTimestamp": "2025-01-16T10:05:00.000Z",
      "createdAt": "2025-01-16T10:05:00.000Z",
      "status": "active",
      "variant": "unencrypted",
      "accountLinkId": "df6jbw4h36qm5d9iu2sgn7kx",
      "isSyncing": false,
      "isRequest": false,
      "typingIndicatorsEnabled": null,
      "lastMessage": {
        "id": "p8rvk2m5j0xn4wq7ybftcael",
        "content": "Hi Sarah — I noticed your work on the Figma design system. We just launched a collaboration API that might be a great fit for your team. Would love to chat!",
        "authorId": "df6jbw4h36qm5d9iu2sgn7kx",
        "createdAt": "2025-01-16T10:05:00.000Z",
        "userId": null,
        "campaignId": "m4wq7ybftcaelp8rvk2m5j0x"
      },
      "prospect": {
        "platform": "twitter",
        "platformId": "1876543210987654321",
        "externalId": "n7kxqm5d9iu2sgdf6jbw4h36",
        "displayName": "Sarah Chen",
        "username": "sarahchen",
        "handle": "@sarahchen",
        "image": "https://pbs.twimg.com/profile_images/example/photo.jpg",
        "context": {
          "tags": [],
          "statusId": null,
          "valuation": null,
          "notes": null
        }
      }
    },
    "message": {
      "id": "p8rvk2m5j0xn4wq7ybftcael",
      "platform": "twitter",
      "platformId": "1876543210987654322",
      "threadId": "l44e15irdq4db30i77cgphhx",
      "teamId": "hzcai5t59nn9vsck3rbuepyg",
      "authorId": "df6jbw4h36qm5d9iu2sgn7kx",
      "userId": null,
      "campaignId": "m4wq7ybftcaelp8rvk2m5j0x",
      "content": "Hi Sarah — I noticed your work on the Figma design system. We just launched a collaboration API that might be a great fit for your team. Would love to chat!",
      "origin": "internal",
      "createdAt": "2025-01-16T10:05:00.000Z",
      "updatedAt": null,
      "isEdited": false,
      "isEncrypted": false,
      "entities": null,
      "attachment": null,
      "reactions": [],
      "replyData": null,
      "forwardData": null,
      "deletedAt": null,
      "platformDeletedAt": null
    },
    "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-15T10:00:00.000Z",
      "lastUpdatedAt": "2025-01-16T10:05:00.000Z",
      "lastEnrichedAt": "2025-01-15T10:00:00.000Z",
      "lastActiveAt": "2025-01-16T08:30:00.000Z",
      "source": "cached",
      "isFresh": true,
      "isStale": false,
      "confidence": 0.95,
      "context": {
        "tags": [],
        "statusId": null,
        "valuation": null,
        "notes": null
      }
    }
  }
}

When it fires

A campaign sends the initial message to a target. This is the first point of contact — the opening DM in the campaign sequence. This event fires once per target, when the first step of the campaign reaches them. Subsequent follow-up messages trigger target.followUpSent instead.

Payload

Campaign

required

The campaign object.

Show properties

string

The Inbox campaign ID.

string

The campaign name.

string | null

The campaign description.

string

The campaign status. One of draft, active, paused, or completed.

boolean

Whether the campaign is in dry run mode (no messages actually sent).

number

Total number of targets in the campaign.

number

Number of targets that have been contacted.

number

Number of targets that have replied.

number

Percentage of targets contacted (0–1).

number

Percentage of contacted targets that replied (0–1).

string

ISO 8601 timestamp of when the campaign was created.

string | null

ISO 8601 timestamp of the last update, or null.

string | null

ISO 8601 timestamp of when the campaign was paused, or null.

string | null

ISO 8601 timestamp of when the campaign completed, or null.

string | null

ISO 8601 timestamp of when the campaign was last started, or null.

Thread

required

The thread associated with this event.

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

string

The Inbox message ID.

string

The message text content.

string

The accountLinkId or prospect’s externalId, depending on who sent the message.

string

ISO 8601 timestamp.

string | null

The Inbox user ID of the sender, if sent by a team member.

string | null

The campaign ID, if sent by a campaign.

object

The prospect associated with this thread. See the Prospect object for the full shape.

Message

required

The message object.

Show properties

string

The Inbox message ID.

string

The platform the message belongs to (e.g., twitter).

string | null

The platform’s native message ID.

string

The Inbox thread ID this message belongs to.

string

The Inbox team ID.

string

The author of the message. Either the accountLinkId (if sent by your team) or the prospect’s externalId.

string | null

The Inbox user ID of the team member who sent this message, if applicable.

string | null

The campaign ID that sent this message, if applicable.

string

The text content of the message.

string | null

How the message was sent: internal (Inbox UI), external (synced from platform), or api (sent via API).

string

When the message was created (ISO 8601).

string | null

When the message was last updated (ISO 8601).

boolean

Whether the message has been edited.

boolean | null

Whether the message is end-to-end encrypted.

object | null

Normalized URL entities, mentions, hashtags, and tweet shares.

object | null

Normalized media and card attachments.

array

Reactions on this message.

object | null

Reply metadata if this message is a reply to another message.

object | null

Forward metadata if this message was forwarded.

string | null

When the message was soft-deleted in Inbox (ISO 8601).

string | null

When the message was deleted on the platform (ISO 8601).

object

required

The prospect associated with this event, including Inbox context.

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.

object

Inbox-specific context for this prospect.

Show properties

string[]

Array of tag IDs attached to this prospect.

string | null

The pipeline status ID, or null if unset.

number | null

The prospect’s deal valuation, or null if unset.

string | null

Free-text notes attached to the prospect.

Webhooks

Event types

When it fires

Payload

​When it fires

​Payload

When it fires

Payload