Data Extensions Async API
The Marketing Cloud REST API supports the ability to persist data into an identified data extension asynchronously.
To use the Data Extensions Async APIs, complete the Marketing Cloud API authentication process.
- To get a client ID and secret, create an installed package with an API Integration component.
- Using the above credentials, get an OAuth access token for authenticating your API calls.
- Use the access token in the header to authenticate each subsequent call.
HTTP Method | Resource | Description |
---|---|---|
POST | /data/v1/async/dataextensions/{id}/rows or /data/v1/async/dataextensions/key:{key}/rows | Asynchronously 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}/rows | Asynchronously 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}/status | Retrieve 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}/results | Once 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. |