Skip to main content

Developers

SMS for your own systems, in one HTTP call.

Plain JSON over REST, the same in every language. Retries are safe, status changes are pushed to your endpoint, and accepted is never reported as delivered.

Send your first message
curl -X POST "$SENDD_API_URL/v1/messages" -H "Authorization: Bearer $SENDD_API_KEY" ...

The API

The same request in every language

No SDK required: one POST with your API key and an idempotency key.

curl -X POST "$SENDD_API_URL/v1/messages" \
  -H "Authorization: Bearer $SENDD_API_KEY" \
  -H "X-Idempotency-Key: order-1042-ready" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+255712345678",
    "from": "SENDD",
    "body": "Your order #1042 is ready for pickup.",
    "client_ref": "order-1042-ready"
  }'

Live sending opens once launch checks pass; test keys work today and never send or charge.

Built in

Everything a production integration needs

  • REST and JSON

    Predictable resources, clear error codes and an API reference built from the published OpenAPI contract.

  • Idempotency keys

    Send the same key twice and you get the first answer back: one message, one charge.

  • Signed webhooks

    Status changes are pushed to your endpoint, signed and retried, with a delivery log you can replay.

  • Honest statuses

    Accepted, submitted and delivered are separate states; a message is delivered only when a positive delivery receipt arrives.

  • Scoped API keys

    Keys with scopes and expiry, rotation with a grace period, and the secret shown only once.

  • Test mode

    Build and test your integration without sending real SMS or spending your balance.

Tools

Build faster with Sendd's own tools

Each one does the retries, the counting and the checks for you, so a message is never sent or charged twice. All are available now, MIT-licensed, from this site; questions are welcome.

  • Available now

    SDKs for JavaScript, Python and PHP

    Send with safe retries, see the segments and the price before you send, and verify webhooks in one call. Node.js 20+, Python 3.9+, PHP 8.1+.

    npm install https://sendd.africa/downloads/npm/sendd-sdk-0.1.0.tgz
    pip install https://sendd.africa/downloads/python/sendd-0.1.0-py3-none-any.whl
    composer config repositories.sendd vcs https://github.com/UNTU1995/sendd-php && composer require sendd/sendd
  • Available now

    Command-line tool

    Check your key, preview and send SMS, follow a message to Delivered, and send a signed test webhook to your own computer, from a terminal or a script.

    curl -fsSL https://sendd.africa/downloads/install.sh | sh
  • Available now

    Connect an AI assistant

    Let an assistant such as Claude check your balance, price a message and send it. Every live message waits for your own confirmation, and each session has a cap.

    claude mcp add sendd --env SENDD_API_KEY=sndd_test_... -- npx -y https://sendd.africa/downloads/npm/sendd-mcp-0.1.0.tgz
Write to us

Get your API key

Create an account, name your organization, then make a key under Developers in the dashboard.