Hey, Get a 50% discount on all our offers now with the code STATUSPAGE50. This promotion is limited to the first 50 customers who subscribe to one of our offers using the promo code.

Notification handlers

Retrieve all

GET https://statuspage.sidl-corporation.fr/api/notification-handlers/
curl --request GET \
--url 'https://statuspage.sidl-corporation.fr/api/notification-handlers/' \
--header 'Authorization: Bearer {api_key}' \
Parameters Details Description
page Optional Integer The page number that you want results from. Defaults to 1.
results_per_page Optional Integer How many results you want per page. Allowed values are: 10 , 25 , 50 , 100 , 250 , 500 , 1000. Defaults to 25.
{ "data": [ { "id": 1, "type": "email", "name": "Work email", "settings": { "email": "hey@example.com" }, "is_enabled": true, "last_datetime": null, "datetime": "2025-10-11 21:23:14" } ], "meta": { "page": 1, "results_per_page": 25, "total": 1, "total_pages": 1 }, "links": { "first": "https://statuspage.sidl-corporation.fr/api/notification-handlers?&page=1", "last": "https://statuspage.sidl-corporation.fr/api/notification-handlers?&page=1", "next": null, "prev": null, "self": "https://statuspage.sidl-corporation.fr/api/notification-handlers?&page=1" } }

Retrieve one

GET https://statuspage.sidl-corporation.fr/api/notification-handlers/{notification_handler_id}
curl --request GET \
--url 'https://statuspage.sidl-corporation.fr/api/notification-handlers/{notification_handler_id}' \
--header 'Authorization: Bearer {api_key}' \
{ "data": { "id": 1, "type": "email", "name": "Work email", "settings": { "email": "hey@example.com" }, "is_enabled": true, "last_datetime": null, "datetime": "2025-10-11 21:23:14" } }

Create

POST https://statuspage.sidl-corporation.fr/api/notification-handlers
Parameters Details Description
name Required String -
type Required String Allowed values: email , webhook , discord , x , google_chat , internal_notification , push_subscriber_id
email Optional String Available when: type = email Email
webhook Optional String Available when: type = webhook Webhook URL
slack Optional String Available when: type = slack Slack webhook URL
discord Optional String Available when: type = discord Discord webhook URL
telegram Optional String Available when: type = telegram Telegram API Token
telegram_chat_id Optional String Available when: type = telegram Telegram Chat ID
x_consumer_key Optional String Available when: type = x Telegram API Token
x_consumer_secret Optional String Available when: type = x Telegram API Token
x_access_token Optional String Available when: type = x Telegram API Token
x_access_token_secret Optional String Available when: type = x Telegram API Token
curl --request POST \
--url 'https://statuspage.sidl-corporation.fr/api/notification-handlers' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'name=Example' \
--form 'type=email' \
--form 'email=hello@example.com' \
{ "data": { "id": 1 } }

Update

POST https://statuspage.sidl-corporation.fr/api/notification-handlers/{notification_handler_id}
Parameters Details Description
name Optional String -
type Optional String Allowed values: email , webhook , discord , x , google_chat , internal_notification , push_subscriber_id
email Optional String Available when: type = email Email
webhook Optional String Available when: type = webhook Webhook URL
slack Optional String Available when: type = slack Slack webhook URL
discord Optional String Available when: type = discord Discord webhook URL
telegram Optional String Available when: type = telegram Telegram API Token
telegram_chat_id Optional String Available when: type = telegram Telegram Chat ID
x_consumer_key Optional String Available when: type = x Telegram API Token
x_consumer_secret Optional String Available when: type = x Telegram API Token
x_access_token Optional String Available when: type = x Telegram API Token
x_access_token_secret Optional String Available when: type = x Telegram API Token
is_enabled Optional Boolean -
curl --request POST \
--url 'https://statuspage.sidl-corporation.fr/api/notification-handlers/{notification_handler_id}' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'name=Example new name' \
--form 'is_enabled=1' \
{ "data": { "id": 1 } }

Delete

DELETE https://statuspage.sidl-corporation.fr/api/notification-handlers/{notification_handler_id}
curl --request DELETE \
--url 'https://statuspage.sidl-corporation.fr/api/notification-handlers/{notification_handler_id}' \
--header 'Authorization: Bearer {api_key}' \