# Postman collection

> Download the 23 Telecom SMS API Postman collection — every endpoint pre-configured with auth headers and example bodies. Set two variables and send your first request in a minute.
> Source: https://docs.23telecom.co.uk/tools/postman/

Instructions for LLMs: This is one page of the 23 Telecom messaging API docs
(SMS today; more channels planned). Base URL: https://restlink23telecom.com/api/v1,
auth via the X-API-Key header. Match errors on the error_code field, never on
description text. Full docs: https://docs.23telecom.co.uk/llms-full.txt · Schemas: https://docs.23telecom.co.uk/openapi.yaml

Every endpoint, pre-configured — generated from the same
[OpenAPI spec](/tools/openapi) as this documentation, so it never drifts.

<p>
  <a class="sl-link-button primary" href="/postman/23telecom-sms-api.postman_collection.json" download>
    Download Postman collection ↓
  </a>
</p>

## Set up in one minute

1. **Import.** In Postman: **File → Import** and drop the downloaded
   `23telecom-sms-api.postman_collection.json`.

2. **Set two variables.** Open the collection → **Variables** tab:

   | Variable | Value |
   | --- | --- |
   | `baseUrl` | `https://restlink23telecom.com/api/v1` |
   | `apiKey` | Your key from the portal (**Settings → API Keys**) |

3. **Send.** Open **SMS → Send SMS**, replace the recipient with your own
   number in the example body, and hit **Send**.

  Store `apiKey` as a **current value** (not initial value) so it never syncs
  to shared/team workspaces or exports.

## What's inside

The collection mirrors the API structure: **SMS** (send, status), **Messages**
(list, unified, CSV export), **Statistics** (aggregate, daily, by country),
**Account** (balance, pricing, payments) and **Webhooks** (settings, test,
logs). Auth is handled at collection level — every request inherits the
`X-API-Key: {{apiKey}}` header.

## Alternatives

- [API playground](/api) — try requests right in the browser, nothing to install.
- [OpenAPI spec](/tools/openapi) — import the raw spec into Insomnia, Bruno,
  Hoppscotch or your own tooling.