Skip to main content
POST
Create an audience property
Audience properties define server-owned contact data that can be used for audience targeting and personalization. Properties are authoritative by default. Set sdk_writable: true only when the mobile SDK is allowed to manage that value as a client-sourced tag. Keep account, billing, lifecycle, compliance, and verified profile data server-owned.

Authorizations

Authorization
string
header
required

Integration key for backend workloads, or a scoped personal key (sr_user_) for account discovery and supported project operations. MCP accepts only personal keys.

Headers

X-Sendrealm-Project-Id
string<uuid>

Explicit project context. Required for personal-key project resource calls; integration keys retain their configured default. MCP clients supply project_id in each tool call instead.

Body

application/json
type
enum<string>
required
Available options:
string,
number
key
string

Property key. Either key or name is accepted.

Maximum string length: 100
name
string

Alias for key.

Maximum string length: 100
sdk_writable
boolean

Allow SDK tag writes for this property. Defaults to false.

Response

Audience property created

status
integer
required

HTTP response status code

data
object