Create broadcast mailing

Description

Creates a new broadcast mailing.

Request URL

Method: POST

https://example.com/api/v1.1/campaigns/broadcasts/add

Request parameters

Parameter	Type	Example	Required	Description
token	string	"abcdefghijklmnqrstuvwxyz"	Yes	API token
format	string	"json"	No	Response data format. By default – json
name	string	"Broadcast mailing name"	Yes	Mailing name
is_active	bool	true	No	Activate mailing on creation
data_type	string	"list"	Yes	Audience source type
data_id	int	12	Yes	Audience source ID
resource_id	int	24	No	Resource ID
content	JSON array		Yes	Message template object
send_channel	string	"email" "sms" "push"	Yes	Sending channel
content_type	string	"email"	No	Deprecated. If you pass this parameter, the mailing will use the email channel for sending, no matter what value you specify. It is recommended to use send_channel.
send_email_content	bool	true	No	Deprecated. If you pass this parameter, the mailing will use the email channel for sending, no matter what value you specify. It is recommended to use send_channel.
send_push_content	bool	true	No	Deprecated. If you pass this parameter, the mailing will use the email channel for sending, no matter what value you specify. It is recommended to use send_channel.
send_sms_content	bool	true	No	Deprecated. If you pass this parameter, the mailing will use the email channel for sending, no matter what value you specify. It is recommended to use send_channel.
subid	string	"Adv_1"	No	Mailing SubID
start_schedule	JSON object		No	Start schedule object
limit	int	0	No	Mailing cycle limitation
aglimit_count	int	0	No	Increase limit each cycle — number
agllimit_percent	float	99.0	No	Increase limit each cycle — percent
policy_id	int	1	No	Sending policy ID
push_sending_mode	string	"fanout" (default) "last"	No	Push notification sending mode (push channels only)
attributes	object	"season":"summer_2024"	No	Assigned attributes and their values
Smart settings
virtual_sender_id	int	12	No	Virtual sender ID (Smart accounts)
is_random_tracking_prefix	bool	false	No	Random tracking domain prefix (Smart accounts)
custom_tracking_domains	JSON array	["trk.example.com", "trk2.example.com"]	No	Tracking domain list (Smart accounts)
blind_carbon_copy	JSON array	["john@example.com", "george@example.com"]	No	Hidden copy email addresses (Smart accounts)
unconditional_sending	bool	true	No	Send messages regardless of subscription status (Smart accounts)
watched_list_id	int	12	No	Mailing watchers database ID (Smart accounts)
watcher_limit	int	100	No	Watchers limit (Smart accounts)

Request example

JSON

{
    "token": "abcdefghijklmnqrstuvwxyz",
    "virtual_sender_id": 5,
    "content": [
        {
            "from_email": "example@example.com",
            "from_name": "Victor",
            "message_id": 15,
            "replyto_email": "example@example.com",
            "replyto_name": "Victoria",
            "subject": "Hello"
        }
    ],
    "custom_tracking_domains": [
        "trk.example.com",
        "trk.example.org"
    ],
    "data_id": 1,
    "data_type": "list",
    "is_active": true,
    "limit": 1,
    "name": "New broadcast",
    "resource_id": 21,
    "send_channel": "email",
    "start_schedule": {
        "start_hours": [
            1,
            2,
            3,
            4
        ],
        "start_mins": [
            1,
            2,
            3,
            4
        ],
        "start_mdays": [
            1
        ],
        "start_months": [
            12
        ],
        "start_wdays": [],
        "start_years": [
            2024
        ]
    }
}

XML

<xml>
    <token>{{token}}</token>
    <virtual_sender_id>5</virtual_sender_id>
    <content array='true'>
        <from_email>example@example.com</from_email>
        <from_name></from_name>
        <message_id>14</message_id>
        <replyto_email>example@example.com</replyto_email>
        <replyto_name></replyto_name>
        <subject>Hello!</subject>
    </content>
    <custom_tracking_domains>trk.example.com</custom_tracking_domains>
    <custom_tracking_domains>trk.example.org</custom_tracking_domains>
    <data_id>1</data_id>
    <data_type>list</data_type>
    <is_active>true</is_active>
    <limit>1</limit>
    <name>Broadcast</name>
    <resource_id>21</resource_id>
    <send_channel>email</send_channel>
    <start_schedule>
        <start_hours>1</start_hours>
        <start_hours>2</start_hours>
        <start_hours>3</start_hours>
        <start_hours>4</start_hours>
        <start_mins>1</start_mins>
        <start_mins>2</start_mins>
        <start_mins>3</start_mins>
        <start_mins>4</start_mins>
        <start_mdays array='true'>1</start_mdays>
        <start_months array='true'>12</start_months>
        <start_wdays array='true'></start_wdays>
        <start_years array='true'>2024</start_years>
    </start_schedule>
</xml>

Response example

JSON

{
    "data": {
        "saved_id": 90
    },
    "error": 0,
    "error_text": "Successful operation"
}

XML

<xml>
    <data>
        <saved_id>90</saved_id>
    </data>
    <error>0</error>
    <error_text>Successful operation</error_text>
</xml>

Response parameters

Parameter	Type	Description
error	int	Error code
error_text	string	Error text
saved_id	int	New mailing ID