Subscribers
Retrieve subscriber preferences
Retrieve subscriber channel preferences by its unique key identifier subscriberId. This API returns all five channels preferences for all workflows and global preferences.
get/v2/subscribers/{subscriberId}/preferences
Path parameters
subscriberIdstring required
The identifier of the subscriber
Query parameters
criticality'critical' | 'nonCritical' | 'all'
contextKeysstring[]
Context keys for filtering preferences (e.g., ["tenant:acme"])
Headers
idempotency-keystring
A header for idempotency purposes
Response
OK
Example response
{
"global": {
"channels": {
"email": true,
"in_app": true,
"push": true,
"tool": true
},
"schedule": {
"isEnabled": true,
"weeklySchedule": {
"monday": {
"isEnabled": true,
"hours": [
{
"start": "09:00 AM",
"end": "05:00 PM"
}
]
},
"tuesday": {
"isEnabled": true,
"hours": [
{
"start": "09:00 AM",
"end": "05:00 PM"
}
]
},
"wednesday": {
"isEnabled": true,
"hours": [
{
"start": "09:00 AM",
"end": "05:00 PM"
}
]
},
"thursday": {
"isEnabled": true,
"hours": [
{
"start": "09:00 AM",
"end": "05:00 PM"
}
]
},
"friday": {
"isEnabled": true,
"hours": [
{
"start": "09:00 AM",
"end": "05:00 PM"
}
]
},
"saturday": {
"isEnabled": true,
"hours": [
{
"start": "09:00 AM",
"end": "05:00 PM"
}
]
},
"sunday": {
"isEnabled": true,
"hours": [
{
"start": "09:00 AM",
"end": "05:00 PM"
}
]
}
}
}
},
"workflows": [
{
"channels": {
"email": true,
"in_app": true,
"push": true,
"tool": true
}
}
]
}