Create or update up to 5,000 items with a single API request using bulk actions
Bulk actions enable you to create or modify up to 5,000 items with a single API request. They are particularly useful if you want to create or modify a large number of items while keeping the number of API requests minimal. Learn more in our dedicated guide.
Bulk actions are excluded from throughput and latency service levels.
Attribute | Description |
---|---|
id string | The bulk action ID. |
object | Always |
target_object | The object related to the bulk action. |
action | The action to execute on the items included in the bulk action:
|
status | The status of the bulk action. Either |
total_items | The number of items included in the bulk action. |
total_successful | The number of items successfully processed. |
total_failed | The number of items that failed to be processed. |
processed_at | The UTC timestamp when the bulk action was processed. |
created_at | The UTC timestamp of the creation of the bulk action. |
Below is an example of a bulk action object:
{
"id": "daa012d7-542e-412c-859e-9777079ffda4",
"object": "bulk_action",
"target_object": "payment_order",
"action": "create",
"status": "executed",
"total_items": 200,
"total_successful": 198,
"total_failed": 2,
"processed_at": "2024-03-17T16:17:02.445697Z",
"created_at": "2024-03-17T16:16:40.445697Z"
}