Hello, 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": "2026-01-11 15:32:39",
        }
    ],
    "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": "2026-01-11 15:32:39",
    }
}

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
discord Optional String Available when: type = discord Discord webhook URL
google_chat Optional String Available when: type = google_chat Google chat webhook URL
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
push_subscriber_id Optional String Available when: type = push_subscriber_id Push subscriber
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
discord Optional String Available when: type = discord Discord webhook URL
google_chat Optional String Available when: type = google_chat Google chat webhook URL
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
push_subscriber_id Optional String Available when: type = push_subscriber_id Push subscriber
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}' \