Get notification preferences

GET /api/v2/notification-preferences Returns the notification opt-ins for the authenticated user. Each opt-in pairs a notificationType with a delivery channel.

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": "media_buy.created", "channel": "email" },
    { "notificationType": "creative.rejected", "channel": "in_app" }
  ]
}

Field	Type	Notes
`optIns[]`	array	One entry per enabled notification
`optIns[].notificationType`	string	The event the user is opted into (e.g. `media_buy.created`, `creative.rejected`)
`optIns[].channel`	enum	`email` or `in_app`

Always-on operational types (for example source.action_required and source.action_resolved) do not appear in optIns — they are delivered in-app and by email regardless of opt-in. See the notifications guide for the full list.

Errors

401 UNAUTHORIZED — missing or invalid API key.

See Errors for the full error contract.

Account tasks

All account operations

Update notification preferences

Replace your opt-ins

Account overview

Concepts and hierarchy

Get membership List accounts

⌘I

Getting Started

Operating Your Storefront

Inventory Sources

Real-Time Targeting (TMP)

Approvals & Reviews

Buyer Onboarding

Demand & Signals

Proposals & Agents

Buyer Routing

Analytics & Activity

Billing

Account

Get notification preferences

Request

Parameters

Response

Errors

Account tasks

Update notification preferences

Account overview

​Request

​Parameters

​Response

​Errors

​Related

Account tasks

Update notification preferences

Account overview

Request

Parameters

Response

Errors

Related