Get Email Campaign Properties

Use this interface to get an existing EMD Email campaign object.

The response returns the campaign object, which includes the campaign ID number and other campaign properties (echoing the request format). The links array contains the campaign object’s related API operations, specific to the campaign name where applicable.

Note: The Responsys Advanced API is generally available for all Responsys customers.

Service URL:

/rest/api/v1.5/campaigns/{campaignName}

Required Path Parameters:

campaignName - Name of the campaign to be fetched.

Request Method:

GET

Request Header:

Authorization=<AUTH_TOKEN>

Content-Type=application/json

Request Body - Required Properties:

Not applicable

Sample Request Body

Not applicable

Sample Response Body

{
  "id": 1000,
  "name": "testcampaign-b11",
  "folderName": "testfolder",
  "type": "EMAIL",
  "description": "<description>",
  "purpose": "PROMOTIONAL",
  "marketingStrategy": "<strategy>",
  "dataSource": [
    {
      "path": "folderName/objectName",
      "alias": "<data source alias name>",
      "fields": [
        {
          "name": "<columnName>",
          "alias": "<aliasName>",
          "lookUpKey": false,
          "defaultValue": null
        },
        {
          "name": "<columnName>",
          "alias": "<aliasName>",
          "lookUpKey": false,
          "defaultValue": null
        }
      ],
      "type": "<data source type>",
      "defaultValue": null
    },
    {
      "path": "folderName/objectName",
      "alias": "<data source alias name>",
      "fields": [
        {
          "name": "<columnName>",
          "alias": "<aliasName>",
          "lookUpKey": false,
          "defaultValue": null
        },
        {
          "name": "<columnName>",
          "alias": "<aliasName>",
          "lookUpKey": false,
          "defaultValue": null
        }
      ],
      "type": "PROFILE_LIST",
      "defaultValue": null
    }
  ],
  "marketingProgram": "<program>",
  "filterPaths": [
    "foldername/objectName1",
    "foldername/objectName2"
  ],
  "refiningDataSourcePath": "foldername/objectName1",
  "proofListPath": "foldername/objectName1",
  "seedListPath": "foldername/objectName1",
  "supplementaryProofDataSourcePaths": [
    "foldername/objectName1",
    "foldername/objectName2"
  ],
  "supplementarySeedDataSourcePaths": [
    "foldername/objectName1",
    "foldername/objectName2"
  ],
  "supplementaryLookupDataSource": [
    {
      "path": "foldername/objectName1",
      "alias": "<data source alias name>",
      "fields": [
        {
          "name": "<column name>",
          "alias": "<alias name>",
          "lookUpKey": true
        }
      ]
    }
  ],
  "suppressionListPaths": [
    "foldername/objectName1",
    "foldername/objectName2"
  ],
  "subject": "<subject>",
  "fromName": "<from name>",
  "fromEmail": "<from email>",
  "replyToEmail": "<reply to email>",
  "bccEmail": "<bcc email>",
  "htmlMessagePath": "documentPath",
  "textMessagePath": "documentPath",
  "enableExternalTracking": true,
  "externalTrackingParams": {
    "name1": "value1",
    "name2": "value2"
  },
  "enableLinkTracking": true,
  "linkTablePath": "foldername/objectName1",
  "attachmentPaths": [
    "documentPath1",
    "documentPath2"
  ],
  "useUTF8": true,
  "locale": "<value>",
  "trackHTMLOpens": true,
  "trackConversions": true,
  "sendTextIfHTMLUnknown": true,
  "segmentTrackingColumnName": "<name>",
  "unsubscribeOption": "OPTOUT_SINGLE_CLICK",
  "unsubscribeFormName": "name",
  "autoCloseOption": "NO_AUTO_CLOSE",
  "autoCloseValue": "<value>",
  "closedCampaignURL": "<URL>",
  "externalCampaignCode": "<code>",
  "salesForceCampaignId": "<salesforce id>",
  "links": [
    {
      "rel": "self",
      "href": "/rest/api/v1.5/campaigns/testcampaign-b11",
      "method": "GET"
    },
    {
      "rel": "create",
      "href": "/rest/api/v1.5/campaigns",
      "method": "POST"
    },
    {
      "rel": "updateCampaign",
      "href": "rest/api/v1.5/campaigns/testcampaign-b11",
      "method": "PUT"
    }
  ]
}