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 or get_contact_discovery_audience_import_status. Use exact prospectId values or saved foundProspectIds; these are included in targetCount and are not fetched again.

nextToken
string | null

Pagination token returned by discover_contacts as nextPage or by get_contact_discovery_audience_import_status as nextToken. Pass the raw token together with initialProspectIds to continue after saved contacts; 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.