Get notification preferences

GET /api/v2/notification-preferences Returns the notification opt-in preferences for the authenticated user — the set of event types and channels they currently receive.

Request

curl

curl https://api.interchange.io/api/v2/notification-preferences \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

Parameters

None. Preferences are scoped to the authenticated user.

Response

{
  "optIns": [
    { "notificationType": "campaign.unhealthy", "channel": "email" },
    { "notificationType": "creative.rejected", "channel": "in_app" }
  ]
}

Field	Type	Notes
`optIns`	array	Active opt-ins for this user
`optIns[].notificationType`	string	Event type the user receives (e.g. `campaign.unhealthy`, `creative.rejected`)
`optIns[].channel`	enum	`email` or `in_app`

Errors

401 UNAUTHORIZED — missing or invalid bearer token.

See Errors for the full error contract.

Account tasks

All account operations

Update notification preferences

Replace your opt-ins

Get membership settings List accounts

⌘I

Getting Started

Advertisers

Campaigns

Product Discovery

Webhooks

Creatives

Signals & Brand

Audiences & Inventory

Measurement & Conversions

Reporting & Activity

Planning & Governance

Connections

Account & Billing

Get notification preferences

Request

Parameters

Response

Errors

Account tasks

Update notification preferences

​Request

​Parameters

​Response

​Errors

​Related

Account tasks

Update notification preferences

Request

Parameters

Response

Errors

Related