Audiences

Create an audience

Names must be unique in the workspace. Link data stores so targeting has real data behind it.

Scope: audiences:write.

Send an Idempotency-Key header to make retries safe.

post/audiences

Request

Base URL
https://www.fandom.ai/api/v1
Auth
HTTP bearer
TypeScript
https://skmtc.dev/skilledstars/apis/super-fans-enterprise-api/docs/audiences/post.ts
A function with typed inputs. Its response is checked against the schema.

Idempotency-Keystring

Any unique string. Repeating a request with the same key returns the first result instead of doing it twice.

namestring required

descriptionstring

Who these people are, in plain words. Drives targeting.

keywordsstring[]

topicsstring[]

tagsstring[]

dataStoreIdsstring[]

Data stores this audience is built from.

Success

idstring required

namestring required

descriptionstring required

kindstring required

custom, rfp (from a brief) or preset.

keywordsstring[] required

topicsstring[] required

tagsstring[] required

dataStoreIdsstring[] required

createdAtstring nullable required

updatedAtstring nullable required