Skip to main content
POST
/
v1
/
send
curl --request POST \ --url https://senderkit.com/api/v1/send \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "template": "welcome", "to": "user@example.com", "vars": { "name": "Ada", "dashboardUrl": "https://app.example.com/dashboard" }, "metadata": { "userId": "usr_123" } } '
{
  "id": "msg_0a1b2c3d4e5f6g7h",
  "status": "<string>",
  "livemode": true
}

Documentation Index

Fetch the complete documentation index at: https://docs.senderkit.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

API key with an sk_live_ or sk_test_ prefix.

Body

application/json
​
template
string
required

Template slug to send.

​
to
string
required

Recipient (email address, phone number, or device token).

​
version
integer

Optional explicit version pin. Defaults to the latest version in test mode and the current published version in live mode.

Required range: x >= 1
​
channel
enum<string>
Available options:
email,
sms,
push
​
vars
object

Variables interpolated into the template.

​
metadata
object

Caller-supplied tags/IDs. Values must be string, number, or boolean.

Response

Message accepted and queued for delivery.

​
id
string
required

Public message ID (e.g. msg_...).

Example:

"msg_0a1b2c3d4e5f6g7h"

​
status
string
required
Allowed value: "queued"
​
livemode
boolean
required