curl -X PUT https://api2.ecomailapp.cz/lists/1/update-subscriber \
-H "key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"email": "foo@bar.cz",
"subscriber_data": {
"name": "Jan",
"surname": "Novak",
"gender": "male",
"company": "Company name",
"city": "Praha",
"custom_fields": { "shop": "myshop.cz" },
"tags": ["tags"],
"groups": { "grp_5a145ee75780f": ["Category 1", "Category 2"] }
}
}'
{
"id": 12345,
"name": "Jan",
"surname": "Novak",
"email": "foo@bar.cz",
"gender": "male",
"bounce_soft": 0,
"bounce_hard": null,
"bounce_message": null,
"inserted_at": "2022-11-15 13:59:21"
}
Lists
Update subscriber
Update an existing subscriber in a specific list.
PUT
/
lists
/
{list_id}
/
update-subscriber
curl -X PUT https://api2.ecomailapp.cz/lists/1/update-subscriber \
-H "key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"email": "foo@bar.cz",
"subscriber_data": {
"name": "Jan",
"surname": "Novak",
"gender": "male",
"company": "Company name",
"city": "Praha",
"custom_fields": { "shop": "myshop.cz" },
"tags": ["tags"],
"groups": { "grp_5a145ee75780f": ["Category 1", "Category 2"] }
}
}'
{
"id": 12345,
"name": "Jan",
"surname": "Novak",
"email": "foo@bar.cz",
"gender": "male",
"bounce_soft": 0,
"bounce_hard": null,
"bounce_message": null,
"inserted_at": "2022-11-15 13:59:21"
}
ID of the list.
Email address of the subscriber to update.
Updated subscriber information.
Show subscriber_data properties
Show subscriber_data properties
First name.
Last name.
Gender. Must be
male or female.Company name.
City.
Street address.
ZIP or postal code.
Country code.
Phone number.
Pre-title (e.g. Mr., Mrs.).
Post-nominal title (e.g. PhD).
Birthday in
YYYY-MM-DD format.Name day in
MM-DD format.Source of the subscriber.
Custom field values. Limited to 5000 characters total.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 in the same request are rejected as duplicates.Subscriber tags. Limited to 2000 characters total and 50 characters per tag. Content overwrites current tags.
Group assignments. Overwrites current values.
curl -X PUT https://api2.ecomailapp.cz/lists/1/update-subscriber \
-H "key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"email": "foo@bar.cz",
"subscriber_data": {
"name": "Jan",
"surname": "Novak",
"gender": "male",
"company": "Company name",
"city": "Praha",
"custom_fields": { "shop": "myshop.cz" },
"tags": ["tags"],
"groups": { "grp_5a145ee75780f": ["Category 1", "Category 2"] }
}
}'
{
"id": 12345,
"name": "Jan",
"surname": "Novak",
"email": "foo@bar.cz",
"gender": "male",
"bounce_soft": 0,
"bounce_hard": null,
"bounce_message": null,
"inserted_at": "2022-11-15 13:59:21"
}
⌘I