# Sinch Notifications API **Canonical:** https://apis.io/apis/sinch/sinch-notifications-api/ **Provider:** Sinch — https://apis.io/providers/sinch/ **Base URL:** https://us.conversation.api.sinch.com **Documentation:** https://developers.sinch.com/docs/conversation/api-reference/conversation Sinch Notifications API is one of 101 APIs that [Sinch](https://apis.io/providers/sinch/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification. This API exposes 73 JSON Schema definitions. Tagged areas include Notification. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, an AsyncAPI specification, and 73 JSON Schemas. Webhooks allow you to get updates in real-time about the status of your faxes. Webhooks are triggered by events such as the completion of a fax, and transmit information about the state of that fax to you via HTTP(S) or email. HTTP webhooks are multipart/form-data POST requests, and should be processed like form submissions. **Note:** When webhooks with Basic authentication credentials are shown in GET requests, the credentials are masked with `***`` symbols. It is not possible to retrieve previously-set credentials through the API. ## Setting up webhooks Depending on the type of webhook, you can configure the callback URLs in a few ways: **Incoming fax notification**: - On your [Fax service](https://dashboard.sinch.com/fax/services) in the dashboard. - Using the [API when configuring your service](https://developers.sinch.com/docs/fax/api-reference/fax/services/createnotificationwebhook). This is required to receive notifications about incoming calls to your Sinch number. **Fax completed notification**: - By including the `callbackUrl` property in the request body when you send a fax via the `/faxes` endpoint. ### Retries If a webhook fails, we will automatically retry sending the fax up to 16 times. There will be a delay before each retry, which increases as follows: | Retry number | Delay | Cumulative wait | | ------------ | ---------- | ------------ | | 1 | 5 minutes | 5 minutes | | 2 | 10 minutes | 15 minutes | | 3 | 20 minutes | 35 minutes | | 4 | 30 minutes | 1 hour 5 minutes | | 5-16 | 6 hours | up to ~3 days | ### IP Addresses Notifications are sent from the following IP addresses so you can add them to allowlists if necessary. | IP address | Description | | ---------- | ----------- | | 34.232.249.173 | use1 (East) | | 44.226.9.173 | usw2 (West) | ## Machine-readable artifacts (107) - **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/openapi/sinch-notifications-api-openapi.yml - **Documentation** — https://developers.sinch.com/docs/conversation - **APIReference** — https://developers.sinch.com/docs/conversation/api-reference/template - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-v2-template-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-v2-list-translations-response-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-v2-list-templates-response-schema.json - **Documentation** — https://developers.sinch.com/docs/est - **APIReference** — https://developers.sinch.com/docs/est/api-reference/est - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-call-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-sip-trunk-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-sip-endpoint-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-ip-range-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-access-control-list-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-number-schema.json - **Documentation** — https://developers.sinch.com/docs/fax - **APIReference** — https://developers.sinch.com/docs/fax/api-reference/fax - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-fax-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-service-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-template-by-name-response-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-update-template-request-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-service-phone-number-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-cover-page-schema.json - **Documentation** — https://developers.sinch.com/docs/number-lookup-api-v2 - **APIReference** — https://developers.sinch.com/docs/number-lookup-api-v2/api-reference/number-lookup-v2 - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-number-lookup-response-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-number-lookup-request-schema.json - **Documentation** — https://developers.sinch.com/docs/numbers - **APIReference** — https://developers.sinch.com/docs/numbers/api-reference/imported-hosting - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-hosting-order-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-qualified-number-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-text-enable-numbers-request-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-hosting-order-number-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-imported-number-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-list-imported-numbers-response-schema.json - **APIReference** — https://developers.sinch.com/docs/numbers/api-reference/numbers - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-active-number-response-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-rent-any-number-request-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-validate-address-response-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-number-order-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-create-number-order-request-schema.json - …and 67 more, listed in full on the page. ## Other Sinch APIs (12) - [Sinch Conversation API](https://apis.io/apis/sinch/sinch-conversation-api/) - [Sinch Voice API](https://apis.io/apis/sinch/sinch-voice-api/) - [Sinch Brands API](https://apis.io/apis/sinch/sinch-brands-api/) - [Sinch MMS API](https://apis.io/apis/sinch/sinch-mms-api/) - [Sinch Batches API](https://apis.io/apis/sinch/sinch-batches-api/) - [Sinch Delivery Reports API](https://apis.io/apis/sinch/sinch-delivery-reports-api/) - [Sinch Inbounds API](https://apis.io/apis/sinch/sinch-inbounds-api/) - [Sinch Groups API](https://apis.io/apis/sinch/sinch-groups-api/) - [Sinch 10DLC Brand Registration API](https://apis.io/apis/sinch/sinch-10dlc-brand-registration-api/) - [Sinch 10DLC Campaign Registration API](https://apis.io/apis/sinch/sinch-10dlc-campaign-registration-api/) - [Sinch Access Control List API](https://apis.io/apis/sinch/sinch-access-control-list-api/) - [Sinch Access Control Lists API](https://apis.io/apis/sinch/sinch-access-control-lists-api/) ## Tags Notification --- Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/sinch/sinch-notifications-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/sinch/.