Skip to main content
POST
Create Audience

Authorizations

X-API-Key
string
header
required

Body

application/json
name
string | null
required

Audience name.

mode
enum<string>
default:manual

Audience source mode: manual, hubspot_list, or sales_navigator. Defaults to manual.

Available options:
manual,
hubspot_list,
sales_navigator
aiContext
string | null

Optional AI context to store on the audience.

contacts
(object | null)[] | null

Optional external contacts for manual mode, such as pasted rows, CSV rows, or CRM exports. Each contact may include customVariables. Cannot be combined with prospects.

prospects
(object | null)[] | null

Optional saved prospects for manual mode: up to 500 unique objects with prospectId and optional customVariables.

  • Use exact persisted prospectId values returned by FirstTouch tools, not profile URLs.
  • Cannot be combined with contacts.
  • Values are saved on audience contacts and copied to newly created enrollment candidates.
hubspotListId
string | null

HubSpot list id for hubspot_list mode. Use the exact listId/id returned by list_hubspot_lists; do not pass an audienceId here.

salesNavigator
object | null

Sales Navigator source configuration for sales_navigator mode.

Response

Tool result.