Skip to main content
POST
/
api
/
audiences
/
create
Create Audience
curl --request POST \
  --url https://a.contactlevel.com/api/audiences/create \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "organization_id": "<string>",
  "name": "<string>",
  "facebook": false,
  "google": false,
  "linkedin": false
}
'
{
  "organization_id": "<string>",
  "audience": {
    "id": "<string>",
    "organization_id": "<string>",
    "name": "<string>",
    "description": "<string>",
    "linkedin": false,
    "google": false,
    "facebook": false,
    "tracking_utm_value": "<string>"
  }
}

Authorizations

​
X-Api-Key
string
header
required

Body

application/json
​
organization_id
string
required
​
name
string
required
​
facebook
boolean
default:false
​
google
boolean
default:false
​
linkedin
boolean
default:false

Response

Successful Response

​
organization_id
string
required
​
audience
Api_Audience · object
required

Public API representation of an Audience.

This is a stable DTO exposed to external callers. It is intentionally a slim subset of the internal Audience domain model (apps.common.models.audience.audience_model.Audience).

Add new fields here cautiously to avoid breaking clients; prefer additive, backwards-compatible changes. Use the from_domain helper to convert.