Notification handlers

GET https://prooflr.com/api/notification-handlers/
curl --request GET \
--url 'https://prooflr.com/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-06-21 13:23:30" } ], "meta": { "page": 1, "results_per_page": 25, "total": 1, "total_pages": 1 }, "links": { "first": "https://prooflr.com/api/notification-handlers?&page=1", "last": "https://prooflr.com/api/notification-handlers?&page=1", "next": null, "prev": null, "self": "https://prooflr.com/api/notification-handlers?&page=1" } }
GET https://prooflr.com/api/notification-handlers/{notification_handler_id}
curl --request GET \
--url 'https://prooflr.com/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-06-21 13:23:30" } }
POST https://prooflr.com/api/notification-handlers
Parameters Details Description
name Required String -
type Required String Allowed values:
email Optional String Available when: type = email notification_handlers.email
webhook Optional String Available when: type = webhook notification_handlers.webhook
slack Optional String Available when: type = slack notification_handlers.slack
discord Optional String Available when: type = discord notification_handlers.discord
telegram Optional String Available when: type = telegram notification_handlers.telegram
telegram_chat_id Optional String Available when: type = telegram notification_handlers.telegram_chat_id
x_consumer_key Optional String Available when: type = x notification_handlers.telegram
x_consumer_secret Optional String Available when: type = x notification_handlers.telegram
x_access_token Optional String Available when: type = x notification_handlers.telegram
x_access_token_secret Optional String Available when: type = x notification_handlers.telegram
curl --request POST \
--url 'https://prooflr.com/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 } }
POST https://prooflr.com/api/notification-handlers/{notification_handler_id}
Parameters Details Description
name Optional String -
type Optional String Allowed values:
email Optional String Available when: type = email notification_handlers.email
webhook Optional String Available when: type = webhook notification_handlers.webhook
slack Optional String Available when: type = slack notification_handlers.slack
discord Optional String Available when: type = discord notification_handlers.discord
telegram Optional String Available when: type = telegram notification_handlers.telegram
telegram_chat_id Optional String Available when: type = telegram notification_handlers.telegram_chat_id
x_consumer_key Optional String Available when: type = x notification_handlers.telegram
x_consumer_secret Optional String Available when: type = x notification_handlers.telegram
x_access_token Optional String Available when: type = x notification_handlers.telegram
x_access_token_secret Optional String Available when: type = x notification_handlers.telegram
is_enabled Optional Boolean -
curl --request POST \
--url 'https://prooflr.com/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 https://prooflr.com/api/notification-handlers/{notification_handler_id}
curl --request DELETE \
--url 'https://prooflr.com/api/notification-handlers/{notification_handler_id}' \
--header 'Authorization: Bearer {api_key}' \