Our API

Account

Gives you access to core account information such as the clients available in your account and helper procedures when creating a client including available countries, time zones and the current date and time in your account.


Getting your clients

Contains a list of all the clients in your account, including their name and ID.

GET https://api.createsend.com/api/v3.1/clients.{xml|json}
Expected response: JSON XML
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
 
[
	{
		"ClientID": "4a397ccaaa55eb4e6aa1221e1e2d7122",
		"Name": "Client One"
	},
	{
		"ClientID": "a206def0582eec7dae47d937a4109cb2",
		"Name": "Client Two"
	}
]
Error responses:
Please see our response status codes documentation for details of potential error responses for any API request.

Getting your billing details

Returns billing details for your account, including the number of credits in your account.

GET https://api.createsend.com/api/v3.1/billingdetails.{xml|json}
Expected response: JSON XML
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
	"Credits": 3021
}
Error responses:
Please see our response status codes documentation for details of potential error responses for any API request.

Getting valid countries

Contains a list of all the valid countries accepted as input when a country is required, typically when creating a client.

GET https://api.createsend.com/api/v3.1/countries.{xml|json}
Expected response: JSON XML
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
 
[
	"Afghanistan",
	"Albania",
	"Algeria",
	"American Samoa",
	"etc..."
]
Error responses:
Please see our response status codes documentation for details of potential error responses for any API request.

Getting valid timezones

Contains a list of all the valid timezones accepted as input when a timezone is required, typically when creating a client.

GET https://api.createsend.com/api/v3.1/timezones.{xml|json}
Expected response: JSON XML
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
 
[
	"(GMT) Casablanca",
	"(GMT) Coordinated Universal Time",
	"(GMT) Dublin, Edinburgh, Lisbon, London",
	"(GMT) Monrovia, Reykjavik",
	"etc..."
]
Error responses:
Please see our response status codes documentation for details of potential error responses for any API request.

Getting current date

Contains the current date and time in your account's timezone. This is useful when, for example, you are syncing your Campaign Monitor lists with an external list, allowing you to accurately determine the time on our server when you carry out the synchronization.

GET https://api.createsend.com/api/v3.1/systemdate.{xml|json}
Expected response: JSON XML
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
 
{
	"SystemDate": "2010-11-16 14:18:00"
}
Error responses:
Please see our response status codes documentation for details of potential error responses for any API request.

Adding an administrator

Adds a new administrator to the account. An invitation will be sent to the new administrator via email

POST https://api.createsend.com/api/v3.1/admins.{xml|json}
Expected request: JSON XML
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{ 
  "EmailAddress": "sally@sparrow.com",
  "Name": "Sally Sparrow"
}
Expected response: JSON XML
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
   "EmailAddress": "sally@sparrow.com"
}
Error responses:

Please see our response status codes documentation for details of potential error responses for any API request.

If you receive a 400 Bad Request response for this request, these are the possible errors which may be included in the body of the response:

  • 1: Invalid Email Email address is missing or incorrectly formatted.
  • 150: Email Taken A person with that email address is already associated with this client.
  • 751: Empty Admin Name Administrator name cannot be empty.

Updating an administrator

Updates the email address and/or name of an administrator.

Note: the email value in the query string is the old email address. Use the EmailAddress property in the request body to change the email address.

PUT https://api.createsend.com/api/v3.1/admins.{xml|json}?email={email}

email The email address of the admin whose details will be updated. This is regarded as the 'old' email address.

Expected request: JSON XML

{ 
  "EmailAddress": "sam@sparrow.com",
  "Name": "Sam Sparrow"
}
Expected response: JSON XML
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
   "EmailAddress": "sam@sparrow.com"
}
Error responses:

Please see our response status codes documentation for details of potential error responses for any API request.

If you receive a 400 Bad Request response for this request, these are the possible errors which may be included in the body of the response:

  • 1: Invalid Email Email address is missing or incorrectly formatted.
  • 150: Email Taken A person with that email address is already associated with this client.
  • 751: Empty Administrator Name Administrator name cannot be empty.
  • 752: Administrator not found No administrator with that email address is associated with this account.

Getting Administrators

Contains a list of all (active or invited) administrators associated with a particular account.

GET https://api.createsend.com/api/v3.1/admins.{xml|json}
Expected response: JSON XML
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

[
  {
    "EmailAddress": "sally@sparrow.com",
    "Name": "Sally Sparrow",
    "Status": "Waiting to Accept the Invitation"
  },
  {
    "EmailAddress": "john@jones.com",
    "Name": "John Jones",
    "Status": "Active"
  }
]
Error responses:
Please see our response status codes documentation for details of potential error responses for any API request.

Administrator details

Returns the details of a single administrator associated with an account.

GET https://api.createsend.com/api/v3.1/admins.{xml|json}?email={email}

email The email address of the administrator whose information should be retrieved.

Expected response: JSON XML
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
  "EmailAddress": "john@jones.com",
  "Name": "John Jones",
  "Status": "Active"
}
Error responses:

Please see our response status codes documentation for details of potential error responses for any API request.

If you receive a 400 Bad Request response for this request, these are the possible errors which may be included in the body of the response:

  • 1: Invalid Email Email address is missing or incorrectly formatted.
  • 752: Administrator not found No administrator with that email address is associated with this account.

Deleting an administrator

Changes the status of an active administrator to a deleted administrator. They will no longer be able to log into this account

DELETE https://api.createsend.com/api/v3.1/admins.{xml|json}?email={email}

email The email address of the administrator to be deleted.

Expected response (both XML and JSON):

HTTP/1.1 200 OK
Error responses:

Please see our response status codes documentation for details of potential error responses for any API request.

If you receive a 400 Bad Request response for this request, these are the possible errors which may be included in the body of the response:

  • 1: Invalid Email Email address is missing or incorrectly formatted.
  • 752: Administrator not found No administrator with that email address is associated with this account.
  • 753: Cannot delete last administrator There must always be at least one administrator associated with the account.

Setting primary contact

Sets the primary contact for the account to be the administrator with the specified email addresss.

PUT https://api.createsend.com/api/v3.1/primarycontact.{xml|json}?email={email}

email The email address of the person to be assigned as the primary contact for the client.

Expected response: JSON XML
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
  "EmailAddress": "john@jones.com",                     
}
Error responses:

Please see our response status codes documentation for details of potential error responses for any API request.

If you receive a 400 Bad Request response for this request, these are the possible errors which may be included in the body of the response:

  • 1: Invalid Email Email address is missing or incorrectly formatted.
  • 752: Administrator not found No administrator with that email address is associated with this account.
  • 754: Administrator not active The specified administrator has not accepted their invitation yet.

Getting primary contact

Returns the email address of the administrator who is selected as the primary contact for this account.

GET https://api.createsend.com/api/v3.1/primarycontact.{xml|json}
Expected response: JSON XML
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
  "EmailAddress": "john@jones.com",                     
}
Error responses:
Please see our response status codes documentation for details of potential error responses for any API request.

Single Sign On

Initiates a new login session for the member with the specified email address.

Before you can use this method you'll have to get in touch with us to obtain an IntegratorID. Once you've registered you can create login sessions for account members, optionally directing them to a specific page. This method will return a single use url which will create the login session. This is usually used as the source of an iframe for embedding Campaign Monitor within your own application.

Some UI elements can be hidden from the member via the Chrome parameter. Valid options for this parameter are all, tabs or none. chrome option examples

PUT https://api.createsend.com/api/v3.1/externalsession.{xml|json}
Expected request: JSON XML

{ 
  "Email": "example@example.com",
  "Chrome": "None",
  "Url": "/subscribers/search?search=belle@example.com",
  "IntegratorID": "a1b2c3d4e5f6",
  "ClientID": "aaa111bbb222ccc333"
}
Expected response: JSON XML
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
  "SessionUrl": "https://external1.createsend.com/cd/create/ABCDEF12/DEADBEEF?url=FEEDDAD1",                     
}
Error responses:

Please see our response status codes documentation for details of potential error responses for any API request.

If you receive a 400 Bad Request response for this request, these are the possible errors which may be included in the body of the response:

  • 1: Invalid Email Email address is missing or incorrectly formatted.
  • 752: Administrator not found No administrator with that email address is associated with this account.
  • 754: Administrator not active The specified administrator has not accepted their invitation yet.
  • 5001: Unknown Member The email address provided was not recognised.
  • 5002: Invalid IntegratorID The IntegratorID provided was not recognised or invalid.
  • 5003: Invalid Chrome The Chrome options specified was invalid.

Sign up for free.
Then send campaigns for as little as $9/month

Create an account