Skip to main content
POST
Create an audience

Authorizations

Authorization
string
header
required

API key (dh_live_...) or Auth0 JWT token

Headers

Idempotency-Key
string

Replays the stored response for 24h when the same key is sent again (1–255 visible ASCII)

X-DevHelm-Client
string

Calling surface and version, e.g. cli/1.4.0 or sdk-js/2.0.0

Path Parameters

id
string<uuid>
required

Body

application/json

Create an audience on a private status page

name
string
required

Audience name, unique on the page (1–100 characters)

componentIds
string<uuid>[] | null

Components of this page only the audience sees

Components of this page only the audience sees

componentGroupIds
string<uuid>[] | null

Component groups of this page only the audience sees

Component groups of this page only the audience sees

emails
string[] | null

Viewer emails in the audience, matched ignoring case

Viewer emails in the audience, matched ignoring case

domains
string[] | null

Email domains whose viewers are in the audience, e.g. acme.com

Email domains whose viewers are in the audience, e.g. acme.com

Response

Created

data
object
required

A named group of viewers of a private status page and the components only they see