API referenceAudiences
Create an audience
POST
Creates an empty static contact list.
bearerAuthheader
AuthorizationBearer <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.
application/json- body
name*stringdescription?stringCreated. Note the response omits created_at/updated_at (unlike the GET representation).
application/json- response
The response shape from create/patch — omits timestamps (unlike the GET representation).
id?stringname?stringdescription?string|nullcurl -X POST "https://example.com/v1/audiences" \ -H "Content-Type: application/json" \ -d '{ "name": "string" }'{ "id": "string", "name": "string", "description": "string"}