Skip to main content
POST
/
senders
Create a sender
curl --request POST \
  --url https://api.sendkit.dev/senders \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "John Doe",
  "username": "john",
  "domain_id": "550e8400-e29b-41d4-a716-446655440000",
  "reply_to": "reply@yourdomain.com"
}
'
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "John Doe",
  "username": "john",
  "email": "john@yourdomain.com",
  "reply_to": "reply@yourdomain.com",
  "domain": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "yourdomain.com",
    "status": "verified",
    "region": "us-east-1",
    "open_tracking": true,
    "click_tracking": true,
    "tls": "opportunistic",
    "sending_enabled": true,
    "created_at": "2026-03-03 10:00:00",
    "updated_at": "2026-03-03 10:00:00"
  },
  "created_at": "2026-03-03 10:00:00",
  "updated_at": "2026-03-03 10:00:00"
}

Authorizations

​
Authorization
string
header
required

API key from your SendKit dashboard. Pass it as a Bearer token in the Authorization header.

Body

application/json
​
name
string
required

The sender display name.

Maximum string length: 255
Example:

"John Doe"

​
username
string
required

The username part of the email address. May only contain letters, numbers, dots, underscores, percent signs, plus signs, and hyphens. Must be unique per domain.

Maximum string length: 64
Example:

"john"

​
domain_id
string<uuid>
required

The ID of a verified domain that belongs to your account.

Example:

"550e8400-e29b-41d4-a716-446655440000"

​
reply_to
string<email> | null

The reply-to email address.

Maximum string length: 255
Example:

"reply@yourdomain.com"

Response

Sender created successfully

​
id
string<uuid>

Unique identifier.

Example:

"550e8400-e29b-41d4-a716-446655440000"

​
name
string

The sender display name.

Example:

"John Doe"

​
username
string

The username part of the sender email address.

Example:

"john"

​
email
string<email>

The full sender email address (computed from username and domain).

Example:

"john@yourdomain.com"

​
reply_to
string<email> | null

The reply-to email address.

Example:

"reply@yourdomain.com"

​
domain
object

The domain associated with this sender (without DNS records).

​
created_at
string<date-time>

When the sender was created.

Example:

"2026-03-03 10:00:00"

​
updated_at
string<date-time>

When the sender was last updated.

Example:

"2026-03-03 10:00:00"