On-Call API › My notifications
List my notification methods
GET/api/v1/notification-preferences
The ways the caller is notified when paged — push, voice call, email, SMS — and their targets. These are the caller's own, across every organization they belong to. Meant for a person; with an organization API key the key itself is the caller.
Permission: none — any valid API key or signed-in member of the organization.
Authorization
Responses
200
The preferences.
dataarray of NotificationPreference requiredShow NotificationPreference properties
idstringorg_idstringThe organization it was created from.user_idstringchannelNotificationChanneltargetstringPhone number, email address, or empty for push.priorityinteger0 is tried first.enabledbooleanquiet_startstringStored for older clients; no longer used. Use the notification schedule.quiet_endstringStored for older clients; no longer used.created_atstring (date-time)updated_atstring (date-time)
successboolean required
401
No API key was sent, or it is unknown, revoked or expired (UNAUTHORIZED).
errorobject requiredcodestring requiredMachine-readable code. Branch on this.messagestring requiredHuman-readable explanation.
429
Too many requests (RATE_LIMITED). Wait Retry-After seconds.
Retry-AfterintegerSeconds to wait.
errorobject requiredcodestring requiredMachine-readable code. Branch on this.messagestring requiredHuman-readable explanation.
500
Something went wrong on EvoHub's side (INTERNAL_ERROR). Retry later.
errorobject requiredcodestring requiredMachine-readable code. Branch on this.messagestring requiredHuman-readable explanation.
Example request
curl -X GET 'https://evohub.io/api/v1/notification-preferences' \
-H 'Authorization: Bearer <TOKEN>'