Quickstart

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. 1

   Create an Instasent account

   Sign up at instasent.com and complete onboarding. A Transactional API token is issued automatically for your first project.

2. 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. 3

   Send your first message

   curlnodepython

   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"
     }'

4. 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 for payload details.

What's next

• Authentication — token scopes, rotation, header vs. query-string.
• Rate limits — per-endpoint limits and how to read the X-RateLimit-* headers.
• Errors — status codes, error payload shape, retry guidance.
• Receiving DLRs — webhook payload and status list.
• Reference — every endpoint, every parameter.