Skip to main content
POST
/
audiences
Create Audience
curl --request POST \
  --url https://api.audiencelab.io/audiences \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "name": "<string>",
  "filters": {
    "age": {
      "minAge": 25,
      "maxAge": 45
    },
    "city": [
      "<string>"
    ],
    "state": [
      "<string>"
    ],
    "zip": [
      "<string>"
    ],
    "gender": [
      "M"
    ],
    "businessProfile": {
      "industry": [
        "<string>"
      ],
      "seniority": [
        "<string>"
      ],
      "companyName": [
        "<string>"
      ],
      "jobTitle": [
        "<string>"
      ]
    }
  },
  "segment": [
    "<string>"
  ],
  "days_back": 123
}
'
{
  "audienceId": "812b78c3-83e6-4d6a-8245-def0dde26223"
}

Authorizations

X-Api-Key
string
header
required

Body

application/json
name
string
required
filters
object
required

Filter criteria for audience selection. All array fields must be passed as arrays even for single values.

segment
string[]
days_back
integer

Response

Audience created successfully

audienceId
string
Example:

"812b78c3-83e6-4d6a-8245-def0dde26223"