# Clickatell One API Client Callbacks API

**Canonical:** https://apis.io/apis/clickatell/clickatell-one-api-client-callbacks-api/  
**Provider:** Clickatell — https://apis.io/providers/clickatell/  
**Base URL:** https://your-server.com  
**Documentation:** https://help.clickatell.com/developers-api-reference/reference/clickatell-api-reference

Clickatell One API Client Callbacks API is one of 8 APIs that [Clickatell](https://apis.io/providers/clickatell/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 24 JSON Schema definitions. Tagged areas include One API Client Callbacks. The published artifact set on APIs.io includes an OpenAPI specification and 24 JSON Schemas.

<b>Forward Compatibility</b><br>While the basic callback structure will remain constant:<br><pre> { "integrationId": "string", "integrationName": "string", "event": {} }</pre>There are constant additions to channels including new features and message types, and Clickatell will be adding these to the callbacks as they become available. <br><br>Customers are required to implement callback processing in such a way that new event types as well as additional parameters in an event type do not break callback processing in the customer system.<ul><li>Any HTTP 200 range status code response from client is considered an acknowledgement that the callback was successful. Anything else will be retried, excluding redirect status code.</li><li>Callback payloads and configurations are different (not backwards compatible).</li><li>In future, one HTTPS callback request may contain multiple events for efficiency, but for now batch sizes are always 1.</li><li>The events in callbacks may be out of sequence. User should look at timestamp fields to determine order.</li><li>Timestamps are millisecond unit timestamps.</li><li>If the customer application does not respond fast enough to HTTP/S callbacks, we will retry the callback. This means they may experience duplicate callbacks (due to the retries).</li><li>Customer can configure a callback URL for status event callbacks and another URL for MO messages. This helps to maintain low latency conversations by splitting the events.</li></ul>

## Operations (2)

| Method | Path | Summary |
|---|---|---|
| POST | `/client-callback/one-api-reply` | Example of a customer's One Api reply callback |
| POST | `/client-callback/one-api-status` | Example of a customer's One Api status callback |

## Machine-readable artifacts (25)

- **OpenAPI** — https://artifacts.apis.io/clickatell/openapi/clickatell-one-api-client-callbacks-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/clickatell/json-schema/clickatell-transaction-status-notification-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/clickatell/json-schema/clickatell-send-payment-outcome-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/clickatell/json-schema/clickatell-widget-config-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/clickatell/json-schema/clickatell-pay-by-link-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/clickatell/json-schema/clickatell-transaction-status-endpoint-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/clickatell/json-schema/clickatell-payment-gateway-operation-result-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/clickatell/json-schema/clickatell-pay-by-link-transaction-log-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/clickatell/json-schema/clickatell-payment-receipt-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/clickatell/json-schema/clickatell-detailed-widget-config-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/clickatell/json-schema/clickatell-externallink-schema.json
- **JSONSchema** — https://artifacts.apis.io/clickatell/json-schema/clickatell-waitforcallback-schema.json
- **JSONSchema** — https://artifacts.apis.io/clickatell/json-schema/clickatell-omni-status-callback-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/clickatell/json-schema/clickatell-omni-reply-callback-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/clickatell/json-schema/clickatell-send-omni-channel-messages-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/clickatell/json-schema/clickatell-omni-message-list-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/clickatell/json-schema/clickatell-whats-app-notification-list-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/clickatell/json-schema/clickatell-reply-status-notification-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/clickatell/json-schema/clickatell-omni-message-status-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/clickatell/json-schema/clickatell-omni-media-upload-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/clickatell/json-schema/clickatell-send-reply-message-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/clickatell/json-schema/clickatell-sms-status-callback-schema.json
- **JSONSchema** — https://artifacts.apis.io/clickatell/json-schema/clickatell-send-message-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/clickatell/json-schema/clickatell-send-messages-list-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/clickatell/json-schema/clickatell-send-bulk-message-request-schema.json

## Other Clickatell APIs (7)

- [Clickatell Chat 2 Pay API](https://apis.io/apis/clickatell/clickatell-chat-2-pay-api-api/)
- [Clickatell Chat 2 Pay API Client Callbacks API](https://apis.io/apis/clickatell/clickatell-chat-2-pay-api-client-callbacks-api/)
- [Clickatell External Link Callback API](https://apis.io/apis/clickatell/clickatell-external-link-callback-api/)
- [Clickatell One API](https://apis.io/apis/clickatell/clickatell-one-api-api/)
- [Clickatell SMS API](https://apis.io/apis/clickatell/clickatell-sms-api-api/)
- [Clickatell SMS Client Callbacks API](https://apis.io/apis/clickatell/clickatell-sms-client-callbacks-api/)
- [Clickatell Wait for Callback API](https://apis.io/apis/clickatell/clickatell-wait-for-callback-api/)

## Tags

One API Client Callbacks

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/clickatell/clickatell-one-api-client-callbacks-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/clickatell/.