Skip to main content
POST
Preview unsaved canonical targeting without sending or saving a campaign. For asynchronous calculation, poll campaign_audience_preview_get with preview_id.
Preview unsaved canonical targeting without sending or saving a campaign. For asynchronous calculation, poll campaign_audience_preview_get with preview_id. Requires a scoped personal key, an explicit granted project_id, and resources.read. Current role and credential grants remain enforced. See Agent messaging and project operations for authorization and recovery.

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>
required

Body

application/json
channel
enum<string>
required

Channels whose reachability should be evaluated.

Available options:
email,
push,
cross_channel
targeting
object
required

Canonical campaign targeting. Obtain audience IDs through audiences_list; never infer all-contact intent from an empty selection.

app_id
string<uuid>

Owned resource UUID from discovery in this project.

environment
enum<string>

Push device environment; default production.

Available options:
development,
production

Response

Authorized result, preparation, or durable execution receipt.

status
integer
required
data
object
required