Skip to main content
POST
Start Contact Discovery Audience Import

Authorizations

X-API-Key
string
header
required

Body

application/json
audienceName
string | null
required

Audience name to create when the import completes.

targetCount
integer | null
required

Total desired saved profiles, including initialProspectIds. Maximum is 100.

filters
object | null

Structured filters assembled directly from the user request. Use only supported fields; do not invent unsupported filters.

confirmedMaxCredits
integer | null

Customer-confirmed maximum additional discovery credits to spend. Must be at least targetCount - distinct initialProspectIds count.

initialProspectIds
(string | null)[] | null

Persisted prospect ids already returned by discover_contacts and already paid for. Use exact prospectId values from discover_contacts results.

nextToken
string | null

Pagination token returned by discover_contacts. Pass the raw nextPage value to continue after initialProspectIds; do not pass a URL.

audienceAiContext
string | null

Optional AI context to store on the created audience.

audienceFlowPlanId
string | null

Optional existing flow plan id to link to the created audience. Use the exact flowPlanId returned by create_flow_plan, list_flow_plans, or get_flow_workspace.

Response

Tool result.