Data Extensions Asynchronous API

You can use the Marketing Cloud 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 Marketing Cloud completed the operation immediately. 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.

Install a package with an API Integration component.
Use your Client ID and Secret, obtain an OAuth access token. You use this token to authenticate your calls to the API.

HTTP Method	Resource	Description
POST	/data/v1/async/dataextensions/{id}/rows or /data/v1/async/dataextensions/key:{key}/rows	Insert 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}/rows	Upsert data into a data extension by ID or key.
GET	/data/v1/async/{requestid}/status	Retrieve 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}/results	Retrieve 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.