Rules
API request format
https://email.api.engagelab.cc/v1/<module>/<action>
Module: name of function module, e.g. mail module, addresslist module.
Action: action of each module, e.g. send, add.
API return code
API is returned in the format of JSON.Sample is as below:
# request was successful
{
"result": {}
}
# Authentication failed
{
"code": 30000,
"message": "Authentication failed",
}
# Data acquisition success
{
"total": 28,
"count": 28,
"result": [
{
"label_id": 598802,
"label_name": "xjm226",
"create_time": "2022-11-10T15:47:05+0800",
"update_time": "2022-11-10T15:47:05+0800"
}
]
}
# request was successful
{
"result": {}
}
# Authentication failed
{
"code": 30000,
"message": "Authentication failed",
}
# Data acquisition success
{
"total": 28,
"count": 28,
"result": [
{
"label_id": 598802,
"label_name": "xjm226",
"create_time": "2022-11-10T15:47:05+0800",
"update_time": "2022-11-10T15:47:05+0800"
}
]
}
This code block in the floating window
- httpStatus: 200
- result: Data information
HTTP status code
| Status | Description | Meaning |
|---|---|---|
| 200 | Success | The request has succeeded. |
| 400 | Bad Request | The request could not be understood by the server due to malformed syntax. |
| 401 | Unauthorized | The request requires user authentication. |
| 404 | Not Found | The server has not found anything matching the Request-URI |
| 500 | Internal Server Error | The server encountered an unexpected condition which prevented it from fulfilling the request. |
Email address format description
Email address format: local_part@domain_part , by local_part, @ and domain_part composition.The legal email address must meet the following rules:
- local_part@domain_part minimum length includes 6 characters and the maximum length is 128 characters;
- local_part maximum length of the part string is 96 characters and cannot contain the @ character;
- domain_part can only contain a-zA-Z0-9 -. It cannot start with - or end with -. The total length does not exceed 255 characters, and each segment does not exceed 63. The top-level domain can only contain 2 to 20 uppercase and lowercase English letters;
Time zone dictionary
| Zone | Description |
|---|---|
| -12 | International Date Line West |
| -11 | Coordinated Universal Time-11 |
| -10 | Aleutian Islands(Hawaii) |
| -9 | Alaska(Coordinated Universal Time-09) |
| -8 | Baja California(Coordinated Universal Time-08,Pacific Time [US & Canada]) |
| -7 | Arizona(Chihuahua, La Paz, Mazatlan,Mountain Time [US & Canada],Yukon) |
| -6 | Central America(Central Time [US & Canada],Easter Island,Guadalajara, Mexico City, Monterrey,Saskatchewan) |
| -5 | Bogota, Lima, Quito, Rio Branco(Chetumal,Eastern Time [US & Canada],Haiti,Havana,Indiana [East],Turks and Caicos) |
| -4 | Asuncion(Atlantic Time [Canada],Caracas,Cuiaba,Georgetown, La Paz, Manaus, San Juan,Santiago) |
| -3 | Araguaina(Brasilia,Cayenne, Fortaleza,City of Buenos Aires,Greenland,Montevideo,Punta Arenas,Saint Pierre and Miquelon,Salvador) |
| -2 | Coordinated Universal Time-02 |
| -1 | Azores(Cabo Verde Is.) |
| 0 | Dublin, Edinburgh, Lisbon, London(Monrovia, Reykjavik,Sao Tome) |
| 1 | Casablanca(Amsterdam, Berlin, Bern, Rome, Stockholm, Vienna,Belgrade, Bratislava, Budapest, Ljubljana, Prague,Brussels, Copenhagen, Madrid, Paris,Sarajevo, Skopje, Warsaw, Zagreb,Western Central Africa) |
| 2 | Amman(Athens, Bucharest,Beirut,Cairo,Chisinau,Damascus ,Gaza, Hebron ,Harare, Pretoria,Helsinki, Kyiv, Riga, Sofia, Tallinn, Vilnius,Jerusalem,Kaliningrad,Khartoum,Tripoli,Windhoek) |
| 3 | Baghdad(Istanbul,Kuwait, Riyadh,Minsk,Moscow, St. Petersburg,Nairobi) |
| 4 | Abu Dhabi, Muscat(Astrakhan, Ulyanovsk,Baku,Izhevsk, Samara,Port Louis,Saratov,Tbilisi,Volgograd,Yerevan) |
| 5 | Ashgabat, Tashkent(Ekaterinburg,Islamabad, Karachi,Qyzylorda) |
| 6 | Astana(Dhaka,Omsk) |
| 7 | Bangkok, Hanoi, Jakarta(Barnaul, Gorno-Altaysk,Hovd,Krasnoyarsk,Novosibirsk,Tomsk) |
| 8 | Beijing, Chongqing, Hong Kong, Urumqi(Irkutsk,Kuala Lumpur, Singapore,Perth,Taipei,Ulaanbaatar) |
| 9 | Chita(Osaka, Sapporo, Tokyo,Pyongyang,Seoul,Yakutsk) |
| 10 | Brisbane(Canberra, Melbourne, Sydney,Guam, Port Moresby,Hobart,Vladivostok) |
| 11 | Bougainville Island(Chokurdakh,Magadan,Norfolk Island,Sakhalin,Solomon Is., New Caledonia) |
| 12 | Anadyr, Petropavlovsk-Kamchatsky(Auckland, Wellington,Coordinated Universal Time+12,Fiji) |
Calendar time zone dictionary
| time_zone_id | time zone |
|---|---|
| Africa/Abidjan | +0000 |
| Africa/Algiers | +0100 |
| Africa/Bissau | +0000 |
| Africa/Cairo | +0200 |
| Africa/Casablanca | +0000 |
| Africa/Ceuta | +0100 |
| Africa/El_Aaiun | +0000 |
| Africa/Johannesburg | +0200 |
| Africa/Juba | +0200 |
| Africa/Khartoum | +0200 |
| Africa/Lagos | +0100 |
| Africa/Maputo | +0200 |
| Africa/Monrovia | +0000 |
| Africa/Nairobi | +0300 |
| Africa/Ndjamena | +0100 |
| Africa/Sao_Tome | +0000 |
| Africa/Tripoli | +0200 |
| Africa/Tunis | +0100 |
| Africa/Windhoek | +0200 |
| America/Adak | -1000,-0900 |
| America/Anchorage | -0900,-0800 |
| America/Araguaina | -0300 |
| America/Asuncion | -0400,-0300 |
| America/Bahia | -0300 |
| America/Bahia_Banderas | -0600 |
| America/Barbados | -0400 |
| America/Belem | -0300 |
| America/Belize | -0600 |
| America/Boa_Vista | -0400 |
| America/Bogota | -0500 |
| America/Boise | -0700,-0600 |
| America/Cambridge_Bay | -0700,-0600 |
| America/Campo_Grande | -0400 |
| America/Cancun | -0500 |
| America/Caracas | -0400 |
| America/Cayenne | -0300 |
| America/Chicago | -0600,-0500 |
| America/Chihuahua | -0600 |
| America/Costa_Rica | -0600 |
| America/Cuiaba | -0400 |
| America/Danmarkshavn | +0000 |
| America/Dawson | -0700 |
| America/Dawson_Creek | -0700 |
| America/Denver | -0700,-0600 |
| America/Detroit | -0500,-0400 |
| America/Edmonton | -0700,-0600 |
| America/Eirunepe | -0500 |
| America/El_Salvador | -0600 |
| America/Fort_Nelson | -0700 |
| America/Fortaleza | -0300 |
| America/Glace_Bay | -0400,-0300 |
| America/Goose_Bay | -0300,-0400 |
| America/Grand_Turk | -0400,-0500 |
| America/Guatemala | -0600 |
| America/Guayaquil | -0500 |
| America/Guyana | -0400 |
| America/Halifax | -0400 |
| America/Havana | -0400,-0500 |
| America/Hermosillo | -0700,-0700 |
| America/Inuvik | -0700,-0600 |
| America/Iqaluit | -0500,-0400 |
| America/Jamaica | -0500 |
| America/Juneau | -0900,-0800 |
| America/La_Paz | -0400 |
| America/Lima | -0500 |
| America/Los_Angeles | -0800,-0700 |
| America/Maceio | -0300 |
| America/Managua | -0600 |
| America/Manaus | -0400 |
| America/Martinique | -0400 |
| America/Matamoros | -0600,-0500 |
| America/Mazatlan | -0700 |
| America/Menominee | -0600 |
| America/Merida | -0600 |
| America/Metlakatla | -0900,-0800 |
| America/Mexico_City | -0600 |
| America/Miquelon | -0300,-0200 |
| America/Moncton | -0400,-0300 |
| America/Monterrey | -0600 |
| America/Montevideo | -0300 |
| America/New_York | -0500,-0400 |
| America/Nome | -0900,-0800 |
| America/Noronha | -0200 |
| America/Nuuk | -0300,-0200 |
| America/Ojinaga | -0600 |
| America/Panama | -0500 |
| America/Pangnirtung | -0500,-0400 |
| America/Paramaribo | -0300 |
| America/Phoenix | -0700 |
| America/Port-au-Prince | -0500,-0400 |
| America/Porto_Velho | -0400 |
| America/Puerto_Rico | -0400 |
| America/Punta_Arenas | -0300 |
| America/Rankin_Inlet | -0600,-0500 |
| America/Recife | -0300 |
| America/Regina | -0600 |
| America/Resolute | -0500,-0600 |
| America/Rio_Branco | -0500 |
| America/Santarem | -0300 |
| America/Santiago | -0300,-0400 |
| America/Santo_Domingo | -0400 |
| America/Sao_Paulo | -0300 |
| America/Scoresbysund | -0100,+0000 |
| America/Sitka | -0900,-0800 |
| America/St_Johns | -0230,-0330 |
| America/Swift_Current | -0600 |
| America/Tegucigalpa | -0600 |
| America/Thule | -0400,-0300 |
| America/Tijuana | -0800,-0700 |
| America/Toronto | -0500,-0400 |
| America/Vancouver | -0800,-0700 |
| America/Whitehorse | -0700 |
| America/Winnipeg | -0600,-0500 |
| America/Yakutat | -0900,-0800 |
| America/Yellowknife | -0700,-0600 |
| America/Argentina/Buenos_Aires | -0300 |
| America/Argentina/Catamarca | -0300 |
| America/Argentina/Cordoba | -0300 |
| America/Argentina/Jujuy | -0300 |
| America/Argentina/La_Rioja | -0300 |
| America/Argentina/Mendoza | -0300 |
| America/Argentina/Rio_Gallegos | -0300 |
| America/Argentina/Salta | -0300 |
| America/Argentina/San_Juan | -0300 |
| America/Argentina/San_Luis | -0300 |
| America/Argentina/Tucuman | -0300 |
| America/Argentina/Ushuaia | -0300 |
| America/Indiana/Indianapolis | -0500,-0400 |
| America/Indiana/Knox | -0600,-0500 |
| America/Indiana/Marengo | -0500,-0400 |
| America/Indiana/Petersburg | -0500,-0400 |
| America/Indiana/Tell_City | -0600,-0500 |
| America/Indiana/Vevay | -0500,-0400 |
| America/Indiana/Vincennes | -0500,-0400 |
| America/Indiana/Winamac | -0400,-0500 |
| America/Kentucky/Louisville | -0500,-0400 |
| America/Kentucky/Monticello | -0500,-0400 |
| America/North_Dakota/Beulah | -0600,-0500 |
| America/North_Dakota/Center | -0600,-0500 |
| America/North_Dakota/New_Salem | -0600,-0500 |
| Antarctica/Casey | +1100 |
| Antarctica/Davis | +0700 |
| Antarctica/Macquarie | +1100 |
| Antarctica/Mawson | +0500 |
| Antarctica/Palmer | -0300 |
| Antarctica/Rothera | -0300 |
| Antarctica/Troll | +0000,+0200 |
| Asia/Almaty | +0600 |
| Asia/Amman | +0300 |
| Asia/Anadyr | +1200 |
| Asia/Aqtau | +0500 |
| Asia/Aqtobe | +0500 |
| Asia/Ashgabat | +0500 |
| Asia/Atyrau | +0500 |
| Asia/Baghdad | +0300 |
| Asia/Baku | +0400 |
| Asia/Bangkok | +0700 |
| Asia/Barnaul | +0700 |
| Asia/Beirut | +0200,+0300 |
| Asia/Bishkek | +0600 |
| Asia/Chita | +0900 |
| Asia/Choibalsan | +0800 |
| Asia/Colombo | +0530 |
| Asia/Damascus | +0300 |
| Asia/Dhaka | +0600 |
| Asia/Dili | +0900 |
| Asia/Dubai | +0400 |
| Asia/Dushanbe | +0500 |
| Asia/Famagusta | +0200,+0300 |
| Asia/Gaza | +0300,+0200 |
| Asia/Hebron | +0300,+0200 |
| Asia/Ho_Chi_Minh | +0700 |
| Asia/Hong_Kong | +0800 |
| Asia/Hovd | +0700 |
| Asia/Irkutsk | +0800 |
| Asia/Jakarta | +0700 |
| Asia/Jayapura | +0900 |
| Asia/Jerusalem | +0200,+0300 |
| Asia/Kabul | +0430 |
| Asia/Kamchatka | +1200 |
| Asia/Karachi | +0500 |
| Asia/Kathmandu | +0545 |
| Asia/Khandyga | +0900 |
| Asia/Kolkata | +0530 |
| Asia/Krasnoyarsk | +0700 |
| Asia/Kuching | +0800 |
| Asia/Macau | +0800 |
| Asia/Magadan | +1100 |
| Asia/Makassar | +0800 |
| Asia/Manila | +0800 |
| Asia/Nicosia | +0300,+0200 |
| Asia/Novokuznetsk | +0700 |
| Asia/Novosibirsk | +0700 |
| Asia/Omsk | +0600 |
| Asia/Oral | +0500 |
| Asia/Pontianak | +0700 |
| Asia/Pyongyang | +0900 |
| Asia/Qatar | +0300 |
| Asia/Qostanay | +0600 |
| Asia/Qyzylorda | +0500 |
| Asia/Riyadh | +0300 |
| Asia/Sakhalin | +1100 |
| Asia/Samarkand | +0500 |
| Asia/Seoul | +0900 |
| Asia/Shanghai | +0800 |
| Asia/Singapore | +0800 |
| Asia/Srednekolymsk | +1100 |
| Asia/Taipei | +0800 |
| Asia/Tashkent | +0500 |
| Asia/Tbilisi | +0400 |
| Asia/Tehran | +0330 |
| Asia/Thimphu | +0600 |
| Asia/Tokyo | +0900 |
| Asia/Tomsk | +0700 |
| Asia/Ulaanbaatar | +0800 |
| Asia/Urumqi | +0600 |
| Asia/Ust-Nera | +1000 |
| Asia/Vladivostok | +1000 |
| Asia/Yakutsk | +0900 |
| Asia/Yangon | +0630 |
| Asia/Yekaterinburg | +0500 |
| Asia/Yerevan | +0400 |
| Atlantic/Azores | -0100,+0000 |
| Atlantic/Bermuda | -0400,-0300 |
| Atlantic/Canary | +0000,+0100 |
| Atlantic/Cape_Verde | -0100,-0100 |
| Atlantic/Faroe | +0000,+0100 |
| Atlantic/Madeira | +0000,+0100 |
| Atlantic/South_Georgia | -0200 |
| Atlantic/Stanley | -0300 |
| Europe/Andorra | +0100,+0200 |
| Europe/Astrakhan | +0400 |
| Europe/Athens | +0200,+0300 |
| Europe/Belgrade | +0100,+0200 |
| Europe/Berlin | +0100,+0200 |
| Europe/Brussels | +0100,+0200 |
| Europe/Bucharest | +0200,+0300 |
| Europe/Budapest | +0100,+0200 |
| Europe/Chisinau | +0200,+0300 |
| Europe/Dublin | +0000,+0100 |
| Europe/Gibraltar | +0100,+0200 |
| Europe/Helsinki | +0200,+0300 |
| Europe/Istanbul | +0300,+0300 |
| Europe/Kaliningrad | +0200 |
| Europe/Kirov | +0300 |
| Europe/Kyiv | +0300,+0200 |
| Europe/Lisbon | +0100,+0000 |
| Europe/London | +0000,+0100 |
| Europe/Madrid | +0100,+0200 |
| Europe/Malta | +0100,+0200 |
| Europe/Minsk | +0300 |
| Europe/Moscow | +0300 |
| Europe/Paris | +0100,+0200 |
| Europe/Prague | +0100,+0200 |
| Europe/Riga | +0200,+0300 |
| Europe/Rome | +0100,+0200 |
| Europe/Samara | +0400 |
| Europe/Saratov | +0400 |
| Europe/Simferopol | +0300 |
| Europe/Sofia | +0200,+0300 |
| Europe/Tallinn | +0200,+0300 |
| Europe/Tirane | +0100,+0200 |
| Europe/Ulyanovsk | +0400 |
| Europe/Vienna | +0100,+0200 |
| Europe/Vilnius | +0200,+0300 |
| Europe/Volgograd | +0300 |
| Europe/Warsaw | +0100,+0200 |
| Europe/Zurich | +0100,+0200 |
| Indian/Chagos | +0600 |
| Indian/Maldives | +0500 |
| Indian/Mauritius | +0400 |
| Pacific/Auckland | +1200,+1300 |
| Pacific/Bougainville | +1100 |
| Pacific/Chatham | +1245,+1345 |
| Pacific/Easter | -0500,-0600 |
| Pacific/Efate | +1100 |
| Pacific/Fakaofo | +1300 |
| Pacific/Fiji | +1200 |
| Pacific/Galapagos | -0600 |
| Pacific/Gambier | -0900 |
| Pacific/Guadalcanal | +1100 |
| Pacific/Guam | +1000 |
| Pacific/Honolulu | -1000 |
| Pacific/Kanton | +1300 |
| Pacific/Kiritimati | +1400 |
| Pacific/Kosrae | +1100 |
| Pacific/Kwajalein | +1200 |
| Pacific/Marquesas | -0930 |
| Pacific/Nauru | +1200 |
| Pacific/Niue | -1100 |
| Pacific/Norfolk | +1100,+1200 |
| Pacific/Noumea | +1100 |
| Pacific/Pago_Pago | -1100 |
| Pacific/Palau | +0900 |
| Pacific/Pitcairn | -0800 |
| Pacific/Port_Moresby | +1000 |
| Pacific/Rarotonga | -1000 |
| Pacific/Tahiti | -1000 |
| Pacific/Tarawa | +1200 |
| Pacific/Tongatapu | +1300 |
Rate Dictionary
| Step | Description |
|---|---|
| -1 | Free |
| 1 | 100 hourly, 1k daily |
| 2 | 250 hourly, 2.5k daily |
| 3 | 250 hourly, 5k daily |
| 4 | 650 hourly, 6.5k daily |
| 5 | 800 hourly, 8k daily |
| 6 | 1k hourly, 10k daily |
| 7 | 1.4k hourly, 14k daily |
| 8 | 2k hourly, 20k daily |
| 9 | 2.5k hourly, 25k daily |
| 10 | 3.5k hourly, 35k daily |
| 11 | 5k hourly, 50k daily |
| 12 | 8k hourly, 80k daily |
| 13 | 12k hourly, 120k daily |
| 14 | 17.5k hourly, 175k daily |
| 15 | 25k hourly, 250k daily |
Filter Conditions
Filter Condition Structure
{
"condition": {
"relation": "or",
"items": [
{
"field_name": "createTime",
"op": ">=",
"value": "2021-10-11"
},
{
"field_name": "Name",
"op": "contain",
"value": "left"
}
]
}
}
# Filter condition: createTime >= '2021-10-11' or Name contains 'left'
{
"condition": {
"relation": "or",
"items": [
{
"field_name": "createTime",
"op": ">=",
"value": "2021-10-11"
},
{
"field_name": "Name",
"op": "contain",
"value": "left"
}
]
}
}
# Filter condition: createTime >= '2021-10-11' or Name contains 'left'
This code block in the floating window
Filter Condition Explanation
| Parameter | Description |
|---|---|
| condition | Filter condition group |
| relation | Condition relation (and or or) |
| items | Filter conditions, see table below |
| fieldName | fieldType | op | Description | ||
| Filter Conditions | Filter by Tag | tag | None | ( == , != , contain , does not contain ) | Create the tag before filtering by tag |
| Filter by field | System field (Email, Name, Phone) |
Text | ( contain , does not contain ) | Represents email, name, phone number respectively | |
| System field (createTime, updateTime, unsubscribeTime) |
Date | ( == , != , < , > , <= , >= ) | Represents creation date, update date, unsubscribe date. Format: DD/MM/YYYY, e.g., 02/04/2022, cannot be 2/4/2022 | ||
| Common custom field name (e.g., SendTime) |
Date | ( == , != , < , > , <= , >= ) | Format: MM/DD/YYYY or DD/MM/YYYY | ||
| Common custom field name (e.g., Birthday) |
Birthday | ( == , != , < , > , <= , >= ) | Format: MM/DD or DD/MM | ||
| Common Custom Attribute Name (such as Age) |
Number | ( == , != , < , > , <= , >= ) | Format: 0 or .0 or .00 | ||
| Common Custom Attribute Name (such as Gender) |
Dropdown | ( == , != ) | When creating this attribute, options content needs to be set simultaneously, with a maximum of 10 options | ||
| Custom Attribute Name | Text, Date, Birthday, Number, or Dropdown | Determined by fieldType | Values for other custom attributes | ||








