# Sinch Campaigns Callbacks API **Canonical:** https://apis.io/apis/sinch/sinch-campaigns-callbacks-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 Campaigns Callbacks 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 Campaigns Callbacks. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, an AsyncAPI specification, and 73 JSON Schemas. You can set up callback URLs to receive event notifications when your campaign status is updated or when a new note is addeed to your campaign or any of the carrier orders. When delivering events the order is not guaranteed (for example, a failed event scheduled for retry will not block other events that were queued). The client's callback handler must implement the state machine that can decide what to do with unexpected events, for example, "old" events or invalid state transitions. In these cases the handler could use the API to GET the latest state for the resource. The callback handler is expected to "ingest" the event and respond with 200 OK. The domain-specific business logic and processes should be executed outside of the callback request, as internal asynchronous jobs. An HMAC encrypted secret is used for hashing the payload and sending the hashed String via the X-Sinch-Signature header - that you can use to validate that an incoming request is secure. Hmac secret value can be checked with GET endpoint, and it can be updated with PUT endpoint ## Operations (2) | Method | Path | Summary | |---|---|---| | GET | `/v1/projects/{projectId}/callback-configuration` | Get a callback configuration by project id | | PUT | `/v1/projects/{projectId}/callback-configuration` | Update a callback configuration | ## Machine-readable artifacts (107) - **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/openapi/sinch-campaigns-callbacks-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 Campaigns Callbacks --- Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/sinch/sinch-campaigns-callbacks-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/sinch/.