Use the Sendtim REST API

Create an API key

Create and revoke keys in Settings → API. A key belongs to one workspace and can do anything an admin can in it, so keep it on your server and never in a browser or mobile app.

Make a request

All endpoints live under one base URL. Send the key as a bearer token:

curl https://sendtim.com/api/v1/lists \
  -H "Authorization: Bearer YOUR_API_KEY"

Every request and response is described in the OpenAPI document, which also works with API clients and code generators.

Rate limits

Contacts, lists and automations are available on every plan. Sending a campaign through the API requires Starter or above. A request over the limit returns 429.

Errors

A failed request always returns the same JSON shape:

{
  "error": {
    "code": "validation_failed",
    "message": "email is required",
    "details": {}
  }
}

code is one of unauthenticated, forbidden, not_found, validation_failed, conflict, rate_limited or internal.