Data Extensions Async API

The Marketing Cloud REST API supports the ability to persist data into an identified data extension asynchronously.

Prerequisites

To use the Data Extensions Async APIs, complete the Marketing Cloud API authentication process.

  1. To get a client ID and secret, create an installed package with an API Integration component.
  2. Using the above credentials, get an OAuth access token for authenticating your API calls.
  3. Use the access token in the header to authenticate each subsequent call.

API Specification

HTTP MethodResourceDescription
POST/data/v1/async/dataextensions/{id}/rows or /data/v1/async/dataextensions/key:{key}/rowsAsynchronously insert data into an identified data extension by id or key, where id is the unique identifier of the data extension and key is the external key (customer key) of the data extension.
PUT/data/v1/async/dataextensions/{id}/rows or /data/v1/async/dataextensions/key:{key}/rowsAsynchronously upsert data into an identified data extension by id or key, where id is the unique identifier of the data extension and key is the external key (customer key) of the data extension.
GET/data/v1/async/{requestid}/statusRetrieve the status of the originally posted asynchronous request. Use the status to determine if the request has completed and whether or not there were errors in processing.
GET/data/v1/async/{requestid}/resultsOnce the request has been picked up by the asynchronous framework and passed off to the appropriate service for processing, use this resource to retrieve the results of that service operation.