ClickSend SMS

ClickSend SMS Sms API

The Sms API from ClickSend SMS — 6 operation(s) for sms.

GitHub OpenAPI

Operations 7

POST /sms/send Send SMS messages
POST /sms/price Calculate SMS price
GET /sms/receipts List delivery receipts
POST /sms/receipts Create a test delivery receipt
GET /sms/receipts/{message_id} Get a single SMS receipt
PUT /sms/receipts-read Mark SMS receipts as read
POST /sms/ Create a test inbound SMS

Documentation

📖
Documentation
https://developers.clicksend.com/docs/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/clicksend-sms/refs/heads/main/openapi/clicksend-sms-sms-api-openapi.yml

Other Resources

🔗
API Portal
https://developers.clicksend.com/
🔗
GitHubOrganization
https://github.com/ClickSend
🔗
APIsJSON
https://raw.githubusercontent.com/api-evangelist/clicksend-sms/refs/heads/main/apis.yml

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/clicksend-sms-sms-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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.

GitHub Google LinkedIn

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

OpenAPI Specification

clicksend-sms-sms-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: ClickSend REST API v3 Sms API
  description: 'ClickSend REST API v3 for sending SMS messages, calculating SMS pricing,

    fetching delivery receipts, and simulating inbound and delivery webhooks.

    Authentication uses HTTP Basic Auth with your account username and API key.

    '
  version: 3.0.0
servers:
- url: https://rest.clicksend.com/v3
  description: ClickSend REST API v3
security:
- basicAuth: []
tags:
- name: Sms
paths:
  /sms/send:
    post:
      summary: Send SMS messages
      description: Send one or more SMS messages to recipients.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SmsMessageCollection'
      responses:
        '200':
          description: Messages accepted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
        '400':
          description: Invalid request
        '401':
          description: Unauthorized
      tags:
      - Sms
  /sms/price:
    post:
      summary: Calculate SMS price
      description: Estimate the cost of sending one or more SMS messages.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SmsMessageCollection'
      responses:
        '200':
          description: Pricing returned
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
      tags:
      - Sms
  /sms/receipts:
    get:
      summary: List delivery receipts
      parameters:
      - name: page
        in: query
        schema:
          type: integer
          default: 1
      - name: limit
        in: query
        schema:
          type: integer
          default: 15
          minimum: 15
          maximum: 100
      responses:
        '200':
          description: Paginated delivery receipts
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
      tags:
      - Sms
    post:
      summary: Create a test delivery receipt
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Receipt'
      responses:
        '200':
          description: Test receipt generated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
      tags:
      - Sms
  /sms/receipts/{message_id}:
    get:
      summary: Get a single SMS receipt
      parameters:
      - name: message_id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Single delivery receipt
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
      tags:
      - Sms
  /sms/receipts-read:
    put:
      summary: Mark SMS receipts as read
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                date_before:
                  type: integer
                  description: Unix timestamp cutoff for bulk marking
      responses:
        '200':
          description: Receipts marked read
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
      tags:
      - Sms
  /sms/:
    post:
      summary: Create a test inbound SMS
      description: Generate an inbound test message for webhook verification.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                from:
                  type: string
                to:
                  type: string
                body:
                  type: string
      responses:
        '200':
          description: Inbound test created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
      tags:
      - Sms
components:
  schemas:
    SuccessResponse:
      type: object
      properties:
        http_code:
          type: integer
        response_code:
          type: string
        response_msg:
          type: string
        data:
          type: object
    SmsMessageCollection:
      type: object
      properties:
        messages:
          type: array
          items:
            $ref: '#/components/schemas/SmsMessage'
        senders:
          type: array
          items:
            type: object
            properties:
              country:
                type: string
              from:
                type: string
        shorten_urls:
          type: boolean
    Receipt:
      type: object
      properties:
        url:
          type: string
    SmsMessage:
      type: object
      properties:
        source:
          type: string
        from:
          type: string
        body:
          type: string
        to:
          type: string
        schedule:
          type: integer
        custom_string:
          type: string
        country:
          type: string
        from_email:
          type: string
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: Username and API key