Create up to 100 subscribers in a single request

POST

/api/subscribers/bulk

Accepts an array of subscribers (max 100). Returns per-item success/failure so a single bad row does not fail the rest of the batch.

Request

Authorization

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Bulk create completed; failed contains per-item rejections (empty if all succeeded)

Body

🟠400

🟠401

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.maildesk.io/api/subscribers/bulk' \
--header 'Content-Type: application/json' \
--data-raw '{
    "subscribers": [
        {
            "email": "john.doe@example.com",
            "firstName": "John",
            "lastName": "Doe",
            "isConfirmed": "true | false",
            "tags": [
                "tag1",
                "tag2"
            ]
        }
    ]
}'

Response Example

{
    "failed": [
        {
            "index": 3,
            "email": "duplicate@example.com",
            "reason": "DUPLICATE_IN_REQUEST"
        }
    ]
}

Modified at 2026-04-21 06:01:25

Create a new subscriber

Get all tags