Skip to Content
Docs
API referenceAudiences

Create an audience

POST
/v1/audiences

Creates an empty static contact list.

Authorization

bearerAuth
headerAuthorizationBearer <token>

API key sent as Authorization: Bearer <key>. Looked up by SHA-256 hash (email_core::sha256_hex) against api_keys.hash; revoked keys and keys belonging to a suspended tenant are rejected. See the top-level Authentication section for permission levels.

Request Body

application/json
  1. body
name*string
description?string

Response Body

Created. Note the response omits created_at/updated_at (unlike the GET representation).

application/json
  1. response

The response shape from create/patch — omits timestamps (unlike the GET representation).

id?string
name?string
description?string|null
Example Request
curl -X POST 'https://api.emitd.com/v1/audiences' \  -H 'Content-Type: application/json' \  -d '{  "name": "string"}'
Example Response
{  "id": "string",  "name": "string",  "description": "string"}