Skip to main content
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" }
  ]
}
FieldTypeNotes
optInsarrayActive opt-ins for this user
optIns[].notificationTypestringEvent type the user receives (e.g. campaign.unhealthy, creative.rejected)
optIns[].channelenumemail 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