Audiences

Create audience

Create a new audience.

Returns the audience with contact_count: 0. Requires audiences:write.

Request

curl -X POST "https://api.blueticks.co/v1/audiences" \  -H "Content-Type: application/json" \  -d '{    "name": "Q4 Newsletter Recipients"  }'

{
  "success": true,
  "data": {
    "id": "string",
    "name": "string",
    "contact_count": 0,
    "created_at": "2019-08-24T14:15:22Z"
  }
}

{
  "success": false,
  "error": {
    "code": "string",
    "message": "string",
    "request_id": "string",
    "details": [
      {
        "path": "string",
        "code": "string",
        "message": "string"
      }
    ]
  }
}

Request Body

application/json

name*string

Length1 <= length <= 120

contacts?array<>

Itemsitems <= 1000

Response

Response Body

`application/json`

List audiences

List the audiences in your workspace, newest first.

Get audience

Retrieve a single audience by id, including its `contact_count` and variable schema.

Create audience

Request

Request Body

Response

Response Body

200application/json

Error codesapplication/json

`application/json`

`application/json`