Create a mail

Create a mail without creating a campaign. Before starting to send mails, make sure you have created a from address. See the from addresses section to create and obtain from addresses.

POST https://api.cm.com/bulkemail/v1.0/accounts/{accountID}/mails

System links

The following system links can be included for a mail without a campaign. Simply put the placeholder somewhere in the body of the mail and we will automatically replace them.

Placeholder	Description
[[ SpecialLink.Unsubscribe ]]	Unsubscribe link, this will allow users to unsubscribe for your mails. They won't get mails when you try to send to them again.

POST Parameters

Name	In	Description	Required	Type	Example
AccountID	Path	The account guid	True	Guid	A8C062E4-ECFD-48D0-89B1-A37D2622B7A9
Body	Body	The mail to create	True	Json object	See example request
X-CM-PRODUCTTOKEN	Header	Your product token	True	Guid	C24A5029-37DD-4161-9728-F80D8639588E

Example request

{
	"FromAddressID": "05923f4c-eb2e-4e4b-a07a-096fcbb2697a",
	"FromName": "John Doe",
	"ReplyToAddressID": null,
	"ReplyToAddress": null,
	"ReplyToName": null,
	"ToAddress": "[email protected]",
	"ToName": "John Doe",
	"Ccs": [
		{
			"EmailAddress": "[email protected]"
		}
	],
	"Bccs": null,
	"Subject": "Demo",
	"HtmlBody": "<!DOCTYPE HTML PUBLIC \"-//W3C//DTD XHTML 1.0 Transitional //EN\" \"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd\"><html><body><p> Hello John!</p><a href=\"[[ SpecialLink.Unsubscribe ]]\">Unsubscribe</a></body></html>",
	"TextBody": "Hello John",
	"Attachments": [
		{
			"Content": "VGhpcyBpcyBhIGF3ZXNvbWUgdGV4dCBmaWxl",
			"FileName": "info.txt"
		}
	],
	"CustomerReference": "123456789"
}

Responses

Http status	Description
200	Mail created
400	Bad request

Example response

{
	"ID": "16bc0f8e-77af-4cfa-a2d0-686726d1f697",
	"AccountID": "a8c062e4-ecfd-48d0-89b1-a37d2622b7a9",
	"FromAddressID": "05923f4c-eb2e-4e4b-a07a-096fcbb2697a",
	"FromName": "John Doe",
	"ReplyToAddressID": null,
	"ReplyToAddress": null,
	"ReplyToName": null,
	"ToAddress": "[email protected]",
	"ToName": "John Doe",
	"Ccs": [
		{
			"EmailAddress": "[email protected]"
		}
	],
	"Bccs": null,
	"Subject": "Demo",
	"HtmlBody": "<!DOCTYPE HTML PUBLIC \"-//W3C//DTD XHTML 1.0 Transitional //EN\" \"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd\"><html><body><p> Hello John!</p><a href=\"[[ SpecialLink.Unsubscribe ]]\">Unsubscribe</a></body></html>",
	"TextBody": "Hello John",
	"Attachments": null,
	"CreatedOn": "2017-08-22T16:30:09.899",
	"CreatedOnUtc": "2017-08-22T15:30:09.899Z",
	"ModifiedOn": "2017-08-22T16:30:09.899",
	"ModifiedOnUtc": "2017-08-22T15:30:09.899Z"
}