Added
New Events and Fields
August 19th, 2025 by Brian Goodman
We’ve released a few updates to the Two Boxes webhooks service that introduces new event types and important payload changes. Please review the details below and update your integrations accordingly.
New Webhook Event Types We’ve added three new events to give you more visibility into return lifecycle changes:
return-archived
- Emitted when a return is archived. Returns can be archived either by the RMA Provider that created them, or by a grader if the return was created as a Work Capture return in Two Boxes.
return-line-item-archived
- Emitted when a line item is removed from a return. This applies only to Work Capture and Bulk Returns created directly by associates in Two Boxes.
return-added
- Emitted when a new line item is added to a return. This can occur when a new item is added to a Work Capture return, when a line is added to a Bulk Return, or when an unexpected item is added to an RMA return.
Payload Updates We’ve updated the webhook payloads with the following changes:
Return Details object
- Added: "return_type": string → Denotes the type of return. Possible values:
- rma, work-capture, rts, import, unexpected-item, bulk-capture
- Added: "kind": string → Denotes the kind of return. Possible values:
- production, test
- Removed: "refund_status" → This field has been removed, as it was not being populated (always returned as an empty string).
Return Line Item object
- Added: "quantity": int → Represents the number of units associated with the line item. Relevant to bulk-capture type returns only for now.