Sending messages to groups from address book

You can send message to contacts saved in groups in BulkGate address book via Advanced API. All you have to do is to enter specific group identifiers into the groups parameter. You can find this identifier in the group detail.

Supported versions: 1.0, 2.0.

Example of the request:

POST /api/2.0/advanced/promotional HTTP/1.1
Host: portal.bulkgate.com
Content-Type: application/json
Cache-Control: no-cache

{
    "application_id": "APPLICATION_ID",
    "application_token": "APPLICATION_TOKEN",   
    "groups": [974, 975],
    "text": "Hi <first_name>, it is nice to meet you. <email>",
}

It is possible to add variables that can be replaced by a specific value from the directory before sending the message.

The final message then looks like this:

Hi Thomas, it is nice to meet you. lukas@example.com

Here is the complete list of variables:

VARIABLE	MEANING
<title_before>	Title before the name
<first_name>	First name
<last_name>	Last name
<title_after>	Title after the name
<first_name_vokativ>	First name vokativ for czech language
<last_name_vokativ>	Last name vokativ for czech language
<company_name>	Company name
<phone_mobile>	Mobile phone number
<phone>	Phone number
<email>	Email address
<fax>	Fax
<url>	Website address
<street1>	Street 1
<street2>	Street 2
<city>	City
<zip>	Zip code
<state>	Region
<country>	Country
<company_number>	Company registration number (CRN)
<company_vat>	VAT
<custom_field_0>	Custom field
<custom_field_1>	Custom field
<custom_field_2>	Custom field
<custom_field_3>	Custom field
<custom_field_4>	Custom field
<custom_field_5>	Custom field
<custom_field_6>	Custom field
<custom_field_7>	Custom field
<custom_field_8>	Custom field
<custom_field_9>	Custom field