Bulk action object

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.

AttributeDescription
id
string
The bulk action ID.
object
string
Always bulk_action.
target_object
string
The object related to the bulk action. payment_order and internal_account are currently supported.
action
string
The action to execute on the items included in the bulk action:
  • For payment_order, create, approve, and cancel are supported
  • For internal_account, create is supported
status
string
The status of the bulk action. Either created, processing, or executed.
total_items
integer
The number of items included in the bulk action.
total_successful
integer
The number of items successfully processed.
total_failed
integer
The number of items that failed to be processed.
processed_at
datetime
The UTC timestamp when the bulk action was processed.
created_at
datetime
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"
}