Skip to main content
POST
/
subscribers
Create a subscriber
curl --request POST \
  --url https://app.letterbucket.com/api/v1/subscribers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "[email protected]",
  "name": "John Doe"
}
'
{
  "success": true,
  "data": {
    "id": "019756c2-7f3a-7c2e-9b1d-2a4e6f8c0d11",
    "email": "[email protected]",
    "name": "John Doe",
    "status": "active",
    "created_at": "2026-06-11T17:00:00+00:00"
  }
}
When status is pending, the subscriber receives a confirmation email. When active, the subscriber becomes active directly and no confirmation email is sent.
A duplicate email within the same newsletter returns 422 with code email_already_subscribed.

Authorizations

​
Authorization
string
header
required

Your API key, sent as Authorization: Bearer sk_....

Body

application/json
​
email
string<email>
required

Subscriber email address.

Maximum string length: 254
Example:

"[email protected]"

​
name
string | null

Full name. Stored as first + last name, split on the first space.

Maximum string length: 255
Example:

"John Doe"

​
status
enum<string>

Optional. active makes the subscriber active directly; pending sends a confirmation email.

Available options:
active,
pending

Response

Subscriber created.

​
success
boolean
​
data
object