Status Page Subscribers

Create subscriber

POST https://api.sorryapp.com/v1/pages/:page_id/subscribers

Example Request

curl -X POST https://api.sorryapp.com/v1/pages/:page_id/subscribers \ -d email="nic@example-inc.com" \ -d phone_number="+44712345678" \ -H "Authorization: Bearer 129spul0wcxabrfsnscn6lwrledmp2afbuaxgt1w42s74xds70fgln85e4s3"

Example Response

{ "response": { "id": 1234567, "email": "nic@example-inc.com", "phone_number": " 44712345678", "slack_webhook_url": null, "microsoft_teams_url": null, "notify_by_email": true, "notify_by_phone_number": true, "notify_by_slack_webhook_url": false, "notify_by_legacy_slack_oauth_token": false, "notify_by_microsoft_teams_url": false, "first_name": null, "last_name": null, "nickname": null, "company": null, "tag_list": [], "avatar_url": "https://www.gravatar.com/avatar/6147beffaaa80c7a6d41447223c9fc07", "created_at": "2022-12-05T10:00:14.423Z", "updated_at": "2022-12-05T10:00:14.415Z" } }

Special Request Parameters

These attributes are not part of the standard resource and only apply on this specific action.

Attribute Name Description
component_ids[] List of components this subscriber should be notified about. For each component, you need to individually parse through the attribute e.g. component_ids[]=12345 component_ids[]=12346. Leave blank for all.

Example Request with Components

curl -X POST https://api.sorryapp.com/v1/pages/:page_id/subscribers \ -d email="nic@sorryapp.com" \ -d phone_number="+44712345679" \ -d 'component_ids[]=45598' \ -d 'component_ids[]=45599' \ -H "Authorization: Bearer 129spul0wcxabrfsnscn6lwrledmp2afbuaxgt1w42s74xds70fgln85e4s3"

Example Response with Components

{ "response": { "id": 659818, "email": "nic@sorryapp.com", "phone_number": " 44712345679", "slack_webhook_url": null, "microsoft_teams_url": null, "notify_by_email": true, "notify_by_phone_number": true, "notify_by_slack_webhook_url": false, "notify_by_legacy_slack_oauth_token": false, "notify_by_microsoft_teams_url": false, "first_name": null, "last_name": null, "nickname": null, "company": null, "tag_list": [], "avatar_url": "https://www.gravatar.com/avatar/e825666b5ac2d399f60c0c5c06567b1b", "created_at": "2022-12-05T10:07:23.516Z", "updated_at": "2022-12-05T10:07:23.504Z" } }%