Skip to main content
POST
Add Single Prospect

Overview

Add an individual prospect to a campaign. Prospect imports are processed asynchronously: the response includes a listId that you can use to check processing status.

Request body

Prompt personalization

Use customData for context that should be unique to this imported conversation, for example the action that qualified the lead. In your prompt, reference it with:

Example

Response

Use Prospect Import Status to confirm that the chat was created before marking the prospect as fully imported in your system.

Best practices

  • Keep customData concise and directly useful for the AI prompt.
  • Do not include secrets or sensitive private data.
  • Confirm import completion with the import status endpoint; creation is asynchronous.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Prospect to add

campaignId
string
required
Example:

"campaign_12345abcde"

name
string
required
Example:

"John Smith"

url
string<uri>
required
Example:

"https://linkedin.com/in/johnsmith"

customData
string
Maximum string length: 3000
Example:

"John commented on Liam's LinkedIn post about AI outbound."

Response

Prospect added successfully

message
string
Example:

"Prospect added successfully"

listId
string
Example:

"import_list_id"

Last modified on June 20, 2026