Data Extensions Asynchronous API

Use REST API to create or update data in a data extension asynchronously.

In an asynchronous call, the API accepts your request and immediately provides a request ID. However, this immediate response doesn’t mean that the operation has completed. Instead, you must issue a separate request to find the status of the operation that you're trying to perform, and then you must issue another request to view the result of that operation.

Before you can use the asynchronous API, set up your development environment by completing these steps.

  1. Install a package with an API Integration component.
  2. Use your Client ID and Secret, obtain an OAuth access token. You use this token to authenticate your calls to the API.
HTTP MethodResourceDescription
POST/data/v1/async/dataextensions/{id}/rows or /data/v1/async/dataextensions/key:{key}/rowsInsert data into a data extension by ID or key. ID refers to the unique identifier of the data extension, and key refers to the external key (customer key) of the data extension.
PUT/data/v1/async/dataextensions/{id}/rows or /data/v1/async/dataextensions/key:{key}/rowsUpsert data into a data extension by ID or key.
GET/data/v1/async/{requestid}/statusRetrieve the status of an asynchronous request. Use the status to determine if the request is complete and whether there were errors in processing it.
GET/data/v1/async/{requestid}/resultsRetrieve the result of an asynchronous request. The result includes information about the data that was created or updated as a result of the request. It also includes information about errors that occurred while processing it.