Create a Mailing

Create a mailing

Create a new mailing

POST https://api.cm.com/bulkemail/v1.0/accounts/{accountID}/campaigns/{campaignID}/mailings

POST Parameters

Name In Description Required Type Example
AccountID Path The account guid True Guid A8C062E4-ECFD-48D0-89B1-A37D2622B7A9
CampaignID Path The campaign guid True Guid 77E6A0E6-0C92-4138-89BD-886EDF2ECC0D
MailingID Path The mailing guid True Guid B6D33812-24CC-48E3-B7DD-354715051A85
Body Body The mailing to create True Json object See example request
X-CM-PRODUCTTOKEN Header Your product token True Guid C24A5029-37DD-4161-9728-F80D8639588E
{
	"Name": "Demo",
	"FromName": "John Doe",
	"FromAddressID": "05923f4c-eb2e-4e4b-a07a-096fcbb2697a",
	"ReplyToAddressID": null,
	"Subject": "Demo",
	"MailingState": 2,
	"MailingType": 1,
	"Template": {
		"Name": "Demo Template",
		"Description": "Demo description",
		"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 {{ Recipient.Name }}</p></body></html>",
		"TextBody": "Hello {{ Recipient.Name }}",
		"MergeFields": {
			"MergeTags": [
				{
					"Name": "Recipient.Name",
					"Value": "{{ Recipient.Name }}",
					"Mapping": "Recipient.MergeFieldValue1"
				},
				{
					"Name": "Sender.EmailAddress",
					"Value": "{{ Sender.EmailAddress }}",
					"Mapping": "Sender.EmailAddress"
				},
				{
					"Name": "Recipient.EmailAddress",
					"Value": "{{ Recipient.EmailAddress }}",
					"Mapping": "Recipient.EmailAddress"
				}
			],
			"SpecialLinks": [
				{
					"Type": "system",
					"Label": "Unsubscribe",
					"Link": "[[ SpecialLink.Unsubscribe ]]",
					"Mapping": "SpecialLink.Unsubscribe"
				},
				{
					"Type": "system",
					"Label": "View in browser",
					"Link": "[[ SpecialLink.ViewInBrowser ]]",
					"Mapping": "SpecialLink.ViewInBrowser"
				},
				{
					"Type": "system",
					"Label": "Viewed",
					"Link": "[[ SpecialLink.Pixel ]]",
					"Mapping": "SpecialLink.Pixel"
				}
			]
		},
		"TemplateEditorType": 2
	}
}

Responses

Http status Description
201 Mailing created
400 Bad request
{
	"ID": "b6d33812-24cc-48e3-b7dd-354715051a85",
	"AccountID": "a8c062e4-ecfd-48d0-89b1-a37d2622b7a9",
	"CampaignID": "77e6a0e6-0c92-4138-89bd-886edf2ecc0d",
	"Name": "Demo",
	"FromName": "John Doe",
	"FromAddressID": "05923f4c-eb2e-4e4b-a07a-096fcbb2697a",
	"ReplyToAddressID": null,
	"Subject": "Demo",
	"MailingState": 2,
	"MailingType": 1,
	"Template": {
		"ID": "dfd26818-88e9-4d1a-8a79-20ce44ea12fa",
		"AccountID": "a8c062e4-ecfd-48d0-89b1-a37d2622b7a9",
		"Name": "Demo Template",
		"Description": "Demo description",
		"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 {{ Recipient.Name }}</p></body></html>",
		"TextBody": "Hello {{ Recipient.Name }}",
		"Json": null,
		"MergeFields": {
			"MergeTags": [
				{
					"Name": "Recipient.Name",
					"Value": "{{ Recipient.Name }}",
					"Mapping": "Recipient.MergeFieldValue1"
				},
				{
					"Name": "Sender.EmailAddress",
					"Value": "{{ Sender.EmailAddress }}",
					"Mapping": "Sender.EmailAddress"
				},
				{
					"Name": "Recipient.EmailAddress",
					"Value": "{{ Recipient.EmailAddress }}",
					"Mapping": "Recipient.EmailAddress"
				}
			],
			"SpecialLinks": [
				{
					"Type": "system",
					"Label": "Unsubscribe",
					"Link": "[[ SpecialLink.Unsubscribe ]]",
					"Mapping": "SpecialLink.Unsubscribe"
				},
				{
					"Type": "system",
					"Label": "View in browser",
					"Link": "[[ SpecialLink.ViewInBrowser ]]",
					"Mapping": "SpecialLink.ViewInBrowser"
				},
				{
					"Type": "system",
					"Label": "Viewed",
					"Link": "[[ SpecialLink.Pixel ]]",
					"Mapping": "SpecialLink.Pixel"
				}
			]
		},
		"CreatedOn": "2017-08-08T15:25:40.995",
		"CreatedOnUtc": "2017-08-08T14:25:40.995Z",
		"ModifiedOn": "2017-08-08T15:25:40.995",
		"ModifiedOnUtc": "2017-08-08T14:25:40.995Z",
		"DeletedOn": null,
		"DeletedOnUtc": null
	},
	"CreatedOn": "2017-08-08T15:25:40.995",
	"CreatedOnUtc": "2017-08-08T14:25:40.995Z",
	"ModifiedOn": "2017-08-08T15:25:40.995",
	"ModifiedOnUtc": "2017-08-08T14:25:40.995Z",
	"DeletedOn": null,
	"DeletedOnUtc": null
}