Skip to main content
POST
/
lists
/
{list_id}
/
subscribe-bulk
curl -X POST https://api2.ecomailapp.cz/lists/1/subscribe-bulk \
  -H "key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "subscriber_data": [
      {
        "name": "Foo",
        "surname": "Bar",
        "email": "foo@bar.cz",
        "custom_fields": { "category": "customer" }
      },
      {
        "name": "Foo 2",
        "email": "foo2@bar.cz"
      }
    ],
    "update_existing": true,
    "resubscribe": false,
    "trigger_autoresponders": false
  }'

{
  "inserts": 2
}

Documentation Index

Fetch the complete documentation index at: https://docs.ecomail.cz/llms.txt

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

​
list_id
integer
required
ID of the list.
​
subscriber_data
array
required
Array of subscriber objects. Limited to 3000 subscribers per call — subscribers above the limit are ignored.
​
update_existing
boolean
default:"true"
Update subscribers that already exist in the list.
​
resubscribe
boolean
default:"false"
Force resubscribe if the subscriber was previously unsubscribed.
​
trigger_autoresponders
boolean
default:"false"
Trigger automations when subscribers are added.
Maximum of 3000 subscribers per call. Subscribers above the limit are silently ignored.
Subscribers added via bulk subscribe always skip double opt-in confirmation. Custom fields are limited to 5000 characters total. Custom field keys are case-insensitive — they are trimmed and lowercased on input, so SHOP, shop and Shop are treated as the same field; two keys that differ only in case or whitespace within the same subscriber are rejected as duplicates. Tags are limited to 2000 characters total and 50 characters per tag — tag content only updates when the tags parameter is present and update_existing is true.
curl -X POST https://api2.ecomailapp.cz/lists/1/subscribe-bulk \
  -H "key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "subscriber_data": [
      {
        "name": "Foo",
        "surname": "Bar",
        "email": "foo@bar.cz",
        "custom_fields": { "category": "customer" }
      },
      {
        "name": "Foo 2",
        "email": "foo2@bar.cz"
      }
    ],
    "update_existing": true,
    "resubscribe": false,
    "trigger_autoresponders": false
  }'

{
  "inserts": 2
}