Email Campaign

Overview

The Email Campaign endpoint allows you to manage your Email Campaigns, by creating new Campaigns, or by requesting information about or updating existing Campaigns. The endpoint supports Campaigns that use a Messaging table as their data source, and Campaigns that use the Engagement Data Platform (EDP) as their data source. 

For more details on how to set up an Email Campaign API request, please see the Email Campaign API Technical Guide.

Email Campaigns can also be created from the Campaign screen, or from the New Item screen.

  • Endpoint (North America): https://api.eccmp.com/services2/api/EmailCampaign

  • Endpoint (Europe): https://api.ccmp.eu/services2/api/EmailCampaign

  • Endpoint (Japan): https://api.marketingsuite.jp/services2/api/EmailCampaign

GET Method

The Email Campaign endpoint supports the following GET operation. This endpoint allows you to retrieve information about a specified Email Campaign by providing its Object Reference ID.

Note: This endpoint works only for Campaigns in the email channel; the endpoint can't retrieve information about Campaigns in other channels.

Click here to see a sample response message in JSON format.

POST Method

The Email Campaign endpoint supports the following POST operation. This endpoint allows you to create a new Email Campaign by providing the following basic information:

  • Your Customer ID.

  • The Entity ID of the desired table.

  • The name of the new Campaign.

  • The Folder ID of the folder where you want to save the new Campaign.

  • The type of Campaign -- Regular One-off, Date-triggered, or Event-triggered.

  • Additional supporting assets (Filter, Seed List, Exclusion List, etc.)

  • The email header information (from address, to address, subject line, etc.).

  • Campaign schedule information.

  • Message content.

  • For a Load and Send Campaign -- the Load and Send import file, or folder location.

  • For a Campaign that uses EDP as its data source -- the Segment ID of the Campaign's Segment. 

Click here to see a sample request message in JSON format.

PUT Method

The Email Campaign endpoint supports the following PUT operation. This endpoint allows you to submit modifications to an existing Email Campaign. The request message must include the Campaign's Object Reference ID, and the desired changes. Using this endpoint, you can change just about any aspect of the Campaign, including its name, subject line, message content, schedule, etc.

In addition, you can use the PUT method to execute a process for this Campaign, such as send proofs, run audits, or launch the Campaign, for example.

DELETE Method

The Email Campaign endpoint supports a DELETE operation that will delete the specified Campaign. You must provide the Object Reference ID for the desired Campaign.

Note: Deleted Campaigns are moved to the Recycle Bin.