BigMailer

The BigMailer Developer Hub

Welcome to the BigMailer developer hub. You'll find comprehensive guides and documentation to help you start working with BigMailer as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    
 
Suggest Edits

List contacts

List contacts in a brand.

 

Header Auth

 Authentication is required for this endpoint.
gethttps://api.bigmailer.io/v1/brands/brand_id/contacts
curl --request GET \
  --url https://api.bigmailer.io/v1/brands/brand_id/contacts
var request = require("request");

var options = { method: 'GET',
  url:
   'https://api.bigmailer.io/v1/brands/brand_id/contacts' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.bigmailer.io/v1/brands/brand_id/contacts")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.bigmailer.io/v1/brands/brand_id/contacts");

xhr.send(data);
import requests

url = "https://api.bigmailer.io/v1/brands/brand_id/contacts"

response = requests.request("GET", url)

print(response.text)
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "https://api.bigmailer.io/v1/brands/brand_id/contacts",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
));

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
A binary file was returned

You couldn't be authenticated

Try the API to see results

Path Params

brand_id
uuid
required

ID of the brand to list contacts in

Query Params

limit
integer

A limit on the number of objects to be returned, between 1 and 100.

cursor
string

A cursor for use in pagination. cursor defines your place in the list. For instance, if you make a list request and receive 100 objects along with cursor xyz123, your subsequent call can include cursor=xyz123 in order to fetch the next page of the list.

Response

A list of contacts

has_moreboolean

Whether or not there are more elements after this set. If false, this set comprises the end of the list.

cursorstring

A cursor for use in pagination. cursor defines your place in the list. For instance, if you make a list request and receive 100 objects along with cursor xyz123, your subsequent call can include cursor=xyz123 in order to fetch the next page of the list.

dataarray

Brand does not exist

typestring

The type of error returned.

messagestring

A human-readable message providing more details about the error.

paramstring

The parameter related to the error.

codestring

Code to aid in handling the error programatically.

An unexpected error occurred

typestring

The type of error returned.

messagestring

A human-readable message providing more details about the error.

Suggest Edits

Create contact

Create a contact.

 

Header Auth

 Authentication is required for this endpoint.
posthttps://api.bigmailer.io/v1/brands/brand_id/contacts
curl --request POST \
  --url https://api.bigmailer.io/v1/brands/brand_id/contacts
var request = require("request");

var options = { method: 'POST',
  url:
   'https://api.bigmailer.io/v1/brands/brand_id/contacts' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.bigmailer.io/v1/brands/brand_id/contacts")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://api.bigmailer.io/v1/brands/brand_id/contacts");

xhr.send(data);
import requests

url = "https://api.bigmailer.io/v1/brands/brand_id/contacts"

response = requests.request("POST", url)

print(response.text)
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "https://api.bigmailer.io/v1/brands/brand_id/contacts",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
));

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
A binary file was returned

You couldn't be authenticated

Try the API to see results

Path Params

brand_id
uuid
required

ID of the brand to create the contact in

Body Params

email
email
required

Email address of the contact

field_values
array of objects

Field values are saved along with the email as part of the contact.

Each name must match the tag name of a field that exists in the brand.

Each field value must have exactly one of string, integer, or date.

date
integer
name
string
list_ids
array of strings

IDs of lists the contact should be added to

unsubscribe_all
boolean

Set to true to unsubscribe the contact from all future campaigns,
regardless of message type.

unsubscribe_ids
array of strings

IDs of message types the contact should be unsubscribed from.

Response

Contact successfully created

idstring

ID of the contact inserted

Invalid request

typestring

The type of error returned.

messagestring

A human-readable message providing more details about the error.

paramstring

If the error is parameter-specific, the parameter related to the error. For example, you can use this to display a message near the correct form field.

codestring

For some errors that could be handled programmatically, a short string indicating the error code reported.

Brand does not exist

typestring

The type of error returned.

messagestring

A human-readable message providing more details about the error.

paramstring

The parameter related to the error.

codestring

Code to aid in handling the error programatically.

Contact already exists with email

typestring

The type of error returned.

messagestring

A human-readable message providing more details about the error.

paramstring

The parameter related to the error.

codestring

Code to aid in handling the error programatically.

An unexpected error occurred

typestring

The type of error returned.

messagestring

A human-readable message providing more details about the error.

Suggest Edits

Get contact

Get a contact.

 

Header Auth

 Authentication is required for this endpoint.
gethttps://api.bigmailer.io/v1/brands/brand_id/contacts/contact_id
curl --request GET \
  --url https://api.bigmailer.io/v1/brands/brand_id/contacts/contact_id
var request = require("request");

var options = { method: 'GET',
  url:
   'https://api.bigmailer.io/v1/brands/brand_id/contacts/contact_id' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.bigmailer.io/v1/brands/brand_id/contacts/contact_id")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.bigmailer.io/v1/brands/brand_id/contacts/contact_id");

xhr.send(data);
import requests

url = "https://api.bigmailer.io/v1/brands/brand_id/contacts/contact_id"

response = requests.request("GET", url)

print(response.text)
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "https://api.bigmailer.io/v1/brands/brand_id/contacts/contact_id",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
));

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
A binary file was returned

You couldn't be authenticated

Try the API to see results

Path Params

brand_id
uuid
required

ID of the brand to get the contact from

contact_id
string
required

ID or email address of the contact

Response

Retrieval was successful

idstring

ID of the contact

brand_idstring

ID of the brand the contact is in

emailstring

Email address of the contact

field_valuesarray

Field values associated with the contact.

list_idsarray

IDs of the lists the contact is part of.

unsubscribe_allboolean

true if the contact has unsubscribed from all message types, false otherwise.

unsubscribe_idsarray

IDs of message types the contact has unsubscribed from.

Invalid request

typestring

The type of error returned.

messagestring

A human-readable message providing more details about the error.

paramstring

If the error is parameter-specific, the parameter related to the error. For example, you can use this to display a message near the correct form field.

codestring

For some errors that could be handled programmatically, a short string indicating the error code reported.

Brand or contact does not exist

typestring

The type of error returned.

messagestring

A human-readable message providing more details about the error.

paramstring

The parameter related to the error.

codestring

Code to aid in handling the error programatically.

An unexpected error occurred

typestring

The type of error returned.

messagestring

A human-readable message providing more details about the error.

Suggest Edits

Update contact

Update a contact. Any parameters not provided are left unchanged.

 

Header Auth

 Authentication is required for this endpoint.
posthttps://api.bigmailer.io/v1/brands/brand_id/contacts/contact_id
curl --request POST \
  --url https://api.bigmailer.io/v1/brands/brand_id/contacts/contact_id
var request = require("request");

var options = { method: 'POST',
  url:
   'https://api.bigmailer.io/v1/brands/brand_id/contacts/contact_id' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.bigmailer.io/v1/brands/brand_id/contacts/contact_id")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://api.bigmailer.io/v1/brands/brand_id/contacts/contact_id");

xhr.send(data);
import requests

url = "https://api.bigmailer.io/v1/brands/brand_id/contacts/contact_id"

response = requests.request("POST", url)

print(response.text)
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "https://api.bigmailer.io/v1/brands/brand_id/contacts/contact_id",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
));

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
A binary file was returned

You couldn't be authenticated

Try the API to see results

Path Params

brand_id
uuid
required

ID of the brand to update the contact in

contact_id
string
required

ID or email address of the contact

Body Params

email
email

Email address of the contact

field_values
array of objects

Field values are saved along with the email as part of the contact.

Each name must match the tag name of a field that exists in the brand.

Each field value must have exactly one of string, integer, or date.

date
integer
name
string
list_ids
array of strings

IDs of lists the contact should be added to

unsubscribe_all
boolean

Set to true to unsubscribe the contact from all future campaigns,
regardless of message type.

unsubscribe_ids
array of strings

IDs of message types the contact should be unsubscribed from.

Response

Contact successfully updated

idstring

ID of the contact updated

Invalid request

typestring

The type of error returned.

messagestring

A human-readable message providing more details about the error.

paramstring

If the error is parameter-specific, the parameter related to the error. For example, you can use this to display a message near the correct form field.

codestring

For some errors that could be handled programmatically, a short string indicating the error code reported.

Brand or contact does not exist

typestring

The type of error returned.

messagestring

A human-readable message providing more details about the error.

paramstring

The parameter related to the error.

codestring

Code to aid in handling the error programatically.

Contact already exists with email

typestring

The type of error returned.

messagestring

A human-readable message providing more details about the error.

paramstring

The parameter related to the error.

codestring

Code to aid in handling the error programatically.

An unexpected error occurred

typestring

The type of error returned.

messagestring

A human-readable message providing more details about the error.

Suggest Edits

Delete contact

Delete a contact.

 

Header Auth

 Authentication is required for this endpoint.
deletehttps://api.bigmailer.io/v1/brands/brand_id/contacts/contact_id
curl --request DELETE \
  --url https://api.bigmailer.io/v1/brands/brand_id/contacts/contact_id
var request = require("request");

var options = { method: 'DELETE',
  url:
   'https://api.bigmailer.io/v1/brands/brand_id/contacts/contact_id' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.bigmailer.io/v1/brands/brand_id/contacts/contact_id")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("DELETE", "https://api.bigmailer.io/v1/brands/brand_id/contacts/contact_id");

xhr.send(data);
import requests

url = "https://api.bigmailer.io/v1/brands/brand_id/contacts/contact_id"

response = requests.request("DELETE", url)

print(response.text)
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "https://api.bigmailer.io/v1/brands/brand_id/contacts/contact_id",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
));

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
A binary file was returned

You couldn't be authenticated

Try the API to see results

Path Params

brand_id
uuid
required

ID of the brand to delete the contact from

contact_id
string
required

ID or email address of the contact

Response

Deletion was successful

idstring

ID of the contact deleted

Invalid request

typestring

The type of error returned.

messagestring

A human-readable message providing more details about the error.

paramstring

If the error is parameter-specific, the parameter related to the error. For example, you can use this to display a message near the correct form field.

codestring

For some errors that could be handled programmatically, a short string indicating the error code reported.

Brand or contact does not exist

typestring

The type of error returned.

messagestring

A human-readable message providing more details about the error.

paramstring

The parameter related to the error.

codestring

Code to aid in handling the error programatically.

An unexpected error occurred

typestring

The type of error returned.

messagestring

A human-readable message providing more details about the error.

Suggest Edits

Transactional Campaigns

 
Suggest Edits

Send a transactional email

Send an email as part of a transactional campaign.

 

Header Auth

 Authentication is required for this endpoint.
posthttps://api.bigmailer.io/v1/brands/brand_id/transactional-campaigns/campaign_id/send
curl --request POST \
  --url https://api.bigmailer.io/v1/brands/brand_id/transactional-campaigns/campaign_id/send
var request = require("request");

var options = { method: 'POST',
  url:
   'https://api.bigmailer.io/v1/brands/brand_id/transactional-campaigns/campaign_id/send' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.bigmailer.io/v1/brands/brand_id/transactional-campaigns/campaign_id/send")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://api.bigmailer.io/v1/brands/brand_id/transactional-campaigns/campaign_id/send");

xhr.send(data);
import requests

url = "https://api.bigmailer.io/v1/brands/brand_id/transactional-campaigns/campaign_id/send"

response = requests.request("POST", url)

print(response.text)
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "https://api.bigmailer.io/v1/brands/brand_id/transactional-campaigns/campaign_id/send",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
));

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
A binary file was returned

You couldn't be authenticated

Try the API to see results

Path Params

brand_id
uuid
required

Id of the brand the campaign is part of

campaign_id
uuid
required

ID of the campaign

Body Params

email
email
required

Email address of the contact

field_values
array of objects

Field values are saved along with the email as part of the contact. Additionally, they are used as variables when generating the email content (body, subject, and recipient name).

Each name must match the tag name of a field that exists in the brand.

Each field value must have exactly one of string, integer, or date.

date
integer
name
string
variables
array of objects

Variables to substitute into the email content (body, subject,
and recipient name). Unlike field_values, they are NOT saved as part
of the contact.

name
value

Response

OK

contact_idstring

ID of the contact inserted or updated

Bad Request

typestring

The type of error returned.

messagestring

A human-readable message providing more details about the error.

paramstring

If the error is parameter-specific, the parameter related to the error. For example, you can use this to display a message near the correct form field.

codestring

For some errors that could be handled programmatically, a short string indicating the error code reported.

Brand or campaign not found

typestring

The type of error returned.

messagestring

A human-readable message providing more details about the error.

paramstring

The parameter related to the error.

codestring

Code to aid in handling the error programatically.

An unexpected error occurred

typestring

The type of error returned.

messagestring

A human-readable message providing more details about the error.

Suggest Edits

Deprecated Endpoints

 
Suggest Edits

Create contact

Create a contact

 

Header Auth

 Authentication is required for this endpoint.
posthttps://api.bigmailer.io/v1/contacts
curl --request POST \
  --url https://api.bigmailer.io/v1/contacts
var request = require("request");

var options = { method: 'POST', url: 'https://api.bigmailer.io/v1/contacts' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.bigmailer.io/v1/contacts")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://api.bigmailer.io/v1/contacts");

xhr.send(data);
import requests

url = "https://api.bigmailer.io/v1/contacts"

response = requests.request("POST", url)

print(response.text)
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "https://api.bigmailer.io/v1/contacts",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
));

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
A binary file was returned

You couldn't be authenticated

Try the API to see results

Body Params

brand_id
uuid
required

ID of the brand the contact should be created in

email
email
required

Email address of the contact

field_values
array of objects

Field values are saved along with the email as part of the contact.

Each name must match the tag name of a field that exists in the brand.

Each field value must have exactly one of string, integer, or date.

date
integer
name
string
list_ids
array of strings

IDs of lists the contact should be added to

unsubscribe_all
boolean

Set to true to unsubscribe the contact from all future campaigns,
regardless of message type.

unsubscribe_ids
array of strings

IDs of message types the contact should be unsubscribed from.

Response

OK

contact_idstring

ID of the contact inserted

Bad Request

codestring

an application-specific error code, expressed as a string value.

detailstring

a human-readable explanation specific to this occurrence of the
problem.

idstring

a unique identifier for this particular occurrence of the problem.

metaobject

a meta object containing non-standard meta-information about
the error.

statusstring

the HTTP status code applicable to this problem, expressed as
a string value.

Unprocessable Entity

codestring

an application-specific error code, expressed as a string value.

detailstring

a human-readable explanation specific to this occurrence of the
problem.

idstring

a unique identifier for this particular occurrence of the problem.

metaobject

a meta object containing non-standard meta-information about
the error.

statusstring

the HTTP status code applicable to this problem, expressed as
a string value.

Internal Server Error

Suggest Edits

Update contact

Update a contact. Any parameters not provided are left unchanged.

 

Header Auth

 Authentication is required for this endpoint.
posthttps://api.bigmailer.io/v1/contacts/contact_id
curl --request POST \
  --url https://api.bigmailer.io/v1/contacts/contact_id
var request = require("request");

var options = { method: 'POST',
  url:
   'https://api.bigmailer.io/v1/contacts/contact_id' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.bigmailer.io/v1/contacts/contact_id")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://api.bigmailer.io/v1/contacts/contact_id");

xhr.send(data);
import requests

url = "https://api.bigmailer.io/v1/contacts/contact_id"

response = requests.request("POST", url)

print(response.text)
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "https://api.bigmailer.io/v1/contacts/contact_id",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
));

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
A binary file was returned

You couldn't be authenticated

Try the API to see results

Path Params

contact_id
string
required

Id or email address of the contact

Body Params

brand_id
uuid
required

ID of the brand the contact is in. brand_id must match the
brand id specified when the contact was created
. A contact's brand cannot
be changed.

email
email

Email address of the contact

field_values
array of objects

Field values are saved along with the email as part of the contact.

Each name must match the tag name of a field that exists in the brand.

Each field value must have exactly one of string, integer, or date.

date
integer
name
string
list_ids
array of strings

IDs of lists the contact should be added to

unsubscribe_all
boolean

Set to true to unsubscribe the contact from all future campaigns,
regardless of message type.

unsubscribe_ids
array of strings

IDs of message types the contact should be unsubscribed from.

Response

OK

contact_idstring

ID of the contact updated

Bad Request

codestring

an application-specific error code, expressed as a string value.

detailstring

a human-readable explanation specific to this occurrence of the
problem.

idstring

a unique identifier for this particular occurrence of the problem.

metaobject

a meta object containing non-standard meta-information about
the error.

statusstring

the HTTP status code applicable to this problem, expressed as
a string value.

Not Found

codestring

an application-specific error code, expressed as a string value.

detailstring

a human-readable explanation specific to this occurrence of the
problem.

idstring

a unique identifier for this particular occurrence of the problem.

metaobject

a meta object containing non-standard meta-information about
the error.

statusstring

the HTTP status code applicable to this problem, expressed as
a string value.

Unprocessable Entity

codestring

an application-specific error code, expressed as a string value.

detailstring

a human-readable explanation specific to this occurrence of the
problem.

idstring

a unique identifier for this particular occurrence of the problem.

metaobject

a meta object containing non-standard meta-information about
the error.

statusstring

the HTTP status code applicable to this problem, expressed as
a string value.

Internal Server Error

Suggest Edits

Send a transactional email

Send an email as part of a transactional campaign.

 

Header Auth

 Authentication is required for this endpoint.
posthttps://api.bigmailer.io/v1/transactional-campaigns/campaign_id/send
curl --request POST \
  --url https://api.bigmailer.io/v1/transactional-campaigns/campaign_id/send
var request = require("request");

var options = { method: 'POST',
  url:
   'https://api.bigmailer.io/v1/transactional-campaigns/campaign_id/send' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.bigmailer.io/v1/transactional-campaigns/campaign_id/send")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://api.bigmailer.io/v1/transactional-campaigns/campaign_id/send");

xhr.send(data);
import requests

url = "https://api.bigmailer.io/v1/transactional-campaigns/campaign_id/send"

response = requests.request("POST", url)

print(response.text)
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "https://api.bigmailer.io/v1/transactional-campaigns/campaign_id/send",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
));

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
A binary file was returned

You couldn't be authenticated

Try the API to see results

Path Params

campaign_id
string
required

Id of the campaign

Body Params

email
email
required

Email address of the contact

field_values
array of objects

Field values are saved along with the email as part of the contact. Additionally, they are used as variables when generating the email content (body, subject, and recipient name).

Each name must match the tag name of a field that exists in the brand.

Each field value must have exactly one of string, integer, or date.

date
integer
name
string
variables
array of objects

Variables to substitute into the email content (body, subject,
and recipient name). Unlike field_values, they are NOT saved as part
of the contact.

name
value

Response

OK

contact_idstring

ID of the contact inserted or updated

Bad Request

codestring

an application-specific error code, expressed as a string value.

detailstring

a human-readable explanation specific to this occurrence of the
problem.

idstring

a unique identifier for this particular occurrence of the problem.

metaobject

a meta object containing non-standard meta-information about
the error.

statusstring

the HTTP status code applicable to this problem, expressed as
a string value.

Not Found

codestring

an application-specific error code, expressed as a string value.

detailstring

a human-readable explanation specific to this occurrence of the
problem.

idstring

a unique identifier for this particular occurrence of the problem.

metaobject

a meta object containing non-standard meta-information about
the error.

statusstring

the HTTP status code applicable to this problem, expressed as
a string value.

Internal Server Error