Skip to main content
POST
/
subscribers
/
bulk
Bulk create subscribers
curl --request POST \
  --url https://app.letterbucket.com/api/v1/subscribers/bulk \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
[
  {
    "email": "[email protected]",
    "status": "active"
  },
  {
    "email": "[email protected]",
    "status": "pending"
  },
  {
    "email": "[email protected]"
  }
]
'
{
  "success": true,
  "data": {
    "created": [
      {
        "id": "019756c2-aaaa",
        "email": "[email protected]",
        "name": "",
        "status": "active",
        "created_at": "2026-06-11T17:00:00+00:00"
      },
      {
        "id": "019756c2-bbbb",
        "email": "[email protected]",
        "name": "",
        "status": "pending",
        "created_at": "2026-06-11T17:00:00+00:00"
      }
    ]
  }
}
The body is a JSON array (max 100 items). Each item can set its own status; items with pending receive confirmation emails.
If any item fails validation, no subscribers are created. Bulk creation is all-or-nothing.

Authorizations

​
Authorization
string
header
required

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

Body

application/json
Required array length: 1 - 100 elements
​
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

Subscribers created.

​
success
boolean
​
data
object