# Instasent — transactional-api (full documentation)

> Autocontained dump of every page under /transactional-api. Paste this into an AI assistant or feed it to an agent as context for transactional-api integration work.

Source: https://docs.instasent.com/


---

URL: https://docs.instasent.com/transactional-api/http/quickstart

# Quickstart

Send your first SMS over the Transactional API in under five minutes. Grab a token, fire one HTTP request, and point a webhook at the DLR URL to see delivery.

The Transactional API over HTTP needs three things: an account, an `api_sms` token and one POST request. This walkthrough takes you from zero to a delivered message.

#### 1. Create an Instasent account

Sign up at [instasent.com](https://instasent.com) and complete onboarding.
A Transactional API token is issued automatically for your first project.

#### 2. Grab your token

In the dashboard, open **API tokens** and copy the `api_sms` token.
Treat it as a secret — never commit it to version control.

#### 3. Send your first message

#### curl

```bash
curl -X POST https://api.instasent.com/transactional/v1/sms \
  -H "Authorization: Bearer $INSTASENT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Instasent",
    "to": "+34600000000",
    "text": "Hello from Instasent"
  }'
```

#### node

```js
const res = await fetch("https://api.instasent.com/transactional/v1/sms", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.INSTASENT_TOKEN}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    from: "Instasent",
    to: "+34600000000",
    text: "Hello from Instasent",
  }),
});
const sms = await res.json();
```

#### python

```python
import os, requests

res = requests.post(
    "https://api.instasent.com/transactional/v1/sms",
    headers={"Authorization": f"Bearer {os.environ['INSTASENT_TOKEN']}"},
    json={
        "from": "Instasent",
        "to": "+34600000000",
        "text": "Hello from Instasent",
    },
)
sms = res.json()
```

#### 4. Check delivery

The response contains an `id`. Point your webhook endpoint at the DLR URL
in your project settings — Instasent will `POST` delivery updates as the
message progresses through the carrier network. See
[Receiving DLRs](/transactional-api/http/dlrs) for payload details.

## What's next

- **[Authentication](/transactional-api/http/authentication)** — token scopes, rotation, header vs. query-string.
- **[Rate limits](/transactional-api/http/rate-limits)** — per-endpoint limits and how to read the `X-RateLimit-*` headers.
- **[Errors](/transactional-api/http/errors)** — status codes, error payload shape, retry guidance.
- **[Receiving DLRs](/transactional-api/http/dlrs)** — webhook payload and status list.
- **[Reference](/transactional-api/reference)** — every endpoint, every parameter.