POST /messaging/v1/domainverification/bulk/insert

Overview

Queue a bulk insert to the From Address Management table using either an array of email addresses or a data extension and column reference.

JSON Parameters

Name Type Description
NotificationEmail string Required Email address where a notification is sent when the process completes.
Addresses string Array of email addresses to add as from addresses. The call must include either Addresses or DETable and DEColumn.
DETable string Name of the data extension to retrieve addresses from. The call must include either DETable and DEColumn or Addresses.
DEColumn string Column in DETable to retrieve addresses from. The call must include either DETable and DEColumn or Addresses.

Usage

Required Marketing Cloud Permissions

  • Administration, Access

Example Request 1 (Address Blob)

Host: https://YOUR_SUBDOMAIN.rest.marketingcloudapis.com
POST /messaging/v1/domainverification/bulk/insert
Content-Type: application/json
Authorization: Bearer YOUR_ACCESS_TOKEN

{
  "NotificationEmail": "somebody@salesforce.com",
  "Addresses": [ "somebody@gmail.com", "somebody@yahoo.com" ]
}

Example Request 2 (DE)

Host: https://YOUR_SUBDOMAIN.rest.marketingcloudapis.com
POST /messaging/v1/domainverification/bulk/insert
Content-Type: application/json
Authorization: Bearer YOUR_ACCESS_TOKEN

{
  "NotificationEmail": "somebody@salesforce.com",
  "DETable": "NotARealDE",
  "DEColumn": "NotARealColumn"
}

Example Response

HTTP/1.1 201 Created
{
"requestID": "be3c6442-9d8e-45be-a30a-704ad41c2641"
}
Last Updated: Jun 8, 2021