Create Email Campaigns

Content API enables you to send email body and subject from your back-end to create email campaigns on the Insider One's InOne panel. With this API request, you can specify the account name, campaign name, and campaign type. 

You can use the Content API to:

• Send your already created email HTML body and other input parameters to the InOne panel so you do not waste time adding them again.
• Send the values of the input parameters to the InOne panel directly if you have multiple accounts in InOne and have the same/similar values for these parameters.

Endpoint and Headers

POST https://mail.useinsider.com/content/v1/campaign/create

Headers

Body Parameters

Before sending your request, make sure you create it within the following criteria:

• All body parameters should be lowercase. Otherwise, they will not be validated and you will receive a validation error.
• If the campaign type is Experiment, you should have 2 variations. Otherwise, your request will not be validated and you will receive a validation error.
• If the campaign type is Single, you should have 1 variation. Otherwise, your request will not be validated and you will receive a validation error.
• The subject is required with a maximum of 200 characters.
• The pre-header is optional with a maximum of 150 characters.
• Source, medium, and campaign parameters are required for UTM parameters. 
• UTM keys can only be alphanumeric with _.
• UTM values can have a maximum of 40 characters.
• UTM values can only be alphanumeric with _-.
• The campaign you create will automatically be tagged with the email-content-api tag.
• The campaign creation on the Insider platform is real-time after you send the request.
• The default status of the campaign you create is set to Draft. You can schedule your campaigns on the panel.
• The email content is not saved as a template.

Sample Request

Every request made to the request endpoint requires a request body formatted in JSON and containing your email's content as variations.

The sample request below is a single email campaign containing one variation that defines a personalized subject line, a pre-header, an HTML body, and UTM tracking parameters for source, campaign, and medium.

curl --location --request POST 'http://mail.useinsider.com/content/v1/campaign/create' \
--header 'x-ins-auth-key: INS.1234' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "my single campaign",
    "tags": [
        "v",
        "tag1 789dfs44"
    ],
    "type": "single",
    "variations": [
        {
            "subject": "Hello {{name}} {{email}} {{custom3|fallback}}",
            "pre_header": "apre {{surname|there}}",
            "html": "PHRkIGNsYXNzPSJlc2Qtc3RydWN0dXJlIGVzLXAyMCIgYWxpZ249ImxlZnQiIGJkeT4NCiAgICAgICAgICAgICAgICAgICAgPC90YWJsZT4NCiAgICAgICAgICAgICAgICA8L3RkPg0KICAgICAgICAgICAgPC90cj4NCiAgICAgICAgPC90Ym9keT4NCiAgICA8L3RhYmxlPg0KPC90ZD4=",
            "utm": {
                "source": "thisis_source",
                "campaign": "thisis_campaign",
                "medium": "thisis_medium",
                "extra": "thisis_extra"
            }
        }
    ]
}'

The sample request below shows and Experiment (A/B) campaign containing two variations—each with its own subject line, pre-header, and HTML body, while one variation also includes UTM tracking parameters for source, campaign, and medium.

curl --location --request POST 'mail.useinsider.com/content/v1/campaign/create' \
--header 'x-ins-auth-key: INS.jQIja9pXwuNC2Pkoy....vgjiHHoMgBkkYtDsrb6Gz9K0nAIi4NMLkkWClfU' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Campaign Name",
    "tags": ["campaign-tag"],
    "type": "experiment",
    "variations": [
        {
            "subject": "Variation A subject {{custom}}",
            "html": "PHA+TXkgZW1haWwgYm9keSBBPC9wPg==",
            "pre_header": "Variation A preheader"
        },
        {
            "subject": "Variation B subject {{custom}}",
            "html": "PHA+TXkgZW1haWwgYm9keSBBPC9wPg==",
            "pre_header": "Variation B preheader",
            "utm": {
                "source": "my_source",
                "campaign": "my_campaign",
                "medium": "email",
                "extra": "value"
            }
        }
    ]
}'

The subject and pre_header will be placed in the following sections in your inbox:

The subject and html will look like as follows:

The UTM parameters will be added to the URL(s) as follows:

Sample Responses

The following are some of the responses you might receive for your request.

Created Success Message 201

{
   "message":"created",
   "id":"builderID"
}

Validation Error Message 400

{
   "error":"$message"
}

Unauthorized Error Message 401

{
   "error":"unathorized"
}

Limitations

• All functions must be executed with a simple HTTPS POST request.
• Only new email campaigns can be created via this API. No data can be retrieved.
• The API Key should be provided as the authorization key on the request header. If the key is incorrect, the operation will not be executed and an authorization error will return in the response.
• The rate limit is 1 request per second. Each request might take approximately 1 second.