Clickatell SMS API

The SMS API API from Clickatell — 3 operation(s) for sms api.

Business capability
SMS & Messaging Apps AE-150.20

Operations 3

POST /messages Send message via REST integration #
POST /messages/rest/bulk Send bulk messages via REST integration #
GET /messages/http/send Send message via HTTP integration #

Specifications

Schemas & Data

📊
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

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/clickatell:clickatell-sms-api-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

clickatell-sms-api-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: SMS API
  version: 1.0.0
  x-provenance:
    method: searched
    source: https://help.clickatell.com/developers-api-reference/ (OpenAPI fragments embedded verbatim in the GitBook .md twins, merged by info.title)
    generated: '2026-10-13'
servers:
- url: https://platform.clickatell.com
security:
- api-key: []
tags:
- name: SMS API
paths:
  /messages:
    post:
      tags:
      - SMS API
      summary: Send message via REST integration
      operationId: sendMessageREST_1
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SendMessageRequest'
          application/xml:
            schema:
              $ref: '#/components/schemas/SendMessageRequest'
        required: true
      responses:
        '202':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SendMessagesListResponse'
            application/xml:
              schema:
                $ref: '#/components/schemas/SendMessagesListResponse'
  /messages/rest/bulk:
    post:
      tags:
      - SMS API
      summary: Send bulk messages via REST integration
      operationId: sendBulkMessageREST
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SendBulkMessageRequest'
        required: true
      responses:
        '202':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SendMessagesListResponse'
  /messages/http/send:
    get:
      tags:
      - SMS API
      summary: Send message via HTTP integration
      operationId: sendMessageHTTP
      parameters:
      - name: apiKey
        in: query
        description: Integration API key.
        required: true
        schema:
          type: string
      - name: to
        in: query
        description: Receiver number.
        required: true
        schema:
          type: string
      - name: from
        in: query
        description: Sender number in two-way integration.
        schema:
          type: string
      - name: content
        in: query
        description: Message content.
        required: true
        schema:
          type: string
      - name: clientMessageId
        in: query
        description: Client message id
        schema:
          type: string
      responses:
        '202':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SendMessagesListResponse'
            application/xml:
              schema:
                $ref: '#/components/schemas/SendMessagesListResponse'
components:
  schemas:
    SendMessageRequest:
      type: object
      properties:
        content:
          type: string
          xml:
            name: Content
        to:
          uniqueItems: true
          type: array
          xml:
            name: To
          items:
            type: string
            xml:
              name: To
        from:
          type: string
          xml:
            name: From
        binary:
          type: boolean
          xml:
            name: Binary
        clientMessageId:
          type: string
          xml:
            name: ClientMessageId
        scheduledDeliveryTime:
          type: string
          xml:
            name: ScheduledDeliveryTime
        userDataHeader:
          maxLength: 2147483647
          minLength: 1
          type: string
          xml:
            name: UserDataHeader
        validityPeriod:
          type: integer
          format: int32
          xml:
            name: ValidityPeriod
        charset:
          type: string
          xml:
            name: Charset
      description: Send sms request
      xml:
        name: SendMessageRequest
    SendMessagesListResponse:
      type: object
      properties:
        messages:
          type: array
          xml:
            name: Messages
            wrapped: true
          items:
            $ref: '#/components/schemas/SendMessageResponse'
        errorCode:
          type: integer
          format: int32
          xml:
            name: ErrorCode
        error:
          type: string
          xml:
            name: Error
        errorDescription:
          type: string
          xml:
            name: ErrorDescription
      xml:
        name: SendMessagesResponse
    SendBulkMessageRequest:
      type: object
      properties:
        messageList:
          type: array
          items:
            $ref: '#/components/schemas/SendMessageRequest'
    SendMessageResponse:
      type: object
      properties:
        apiMessageId:
          type: string
          xml:
            name: ApiMessageId
        accepted:
          type: boolean
          xml:
            name: Accepted
        to:
          type: string
          xml:
            name: To
        errorCode:
          type: integer
          format: int32
          xml:
            name: ErrorCode
        error:
          type: string
          xml:
            name: Error
        errorDescription:
          type: string
          xml:
            name: ErrorDescription
  securitySchemes:
    api-key:
      type: apiKey
      name: Authorization
      in: header