Webhooks Reference

Return Archived

Emitted when a return is archived. Returns can be archived if are deleted either by the RMA Provider which created them or by the grader if they created it as a Work Capture return in Two Boxes

{
  "id": "c67e3019-61f6-43cf-97a0-f1b4cc286e46",
  "event_type": "return-archived",
  "event_data": {
 		"captured_rma": "RMA1234",
    "comments": null,
    "completed_at": null,
    "customer": {
      "email": "",
      "first_name": null,
			"full_name": "Demo Customer",
      "last_name": null,
      "tags": null
    },
    "grading_status": "archived_work_capture",
		"kind": "production",
    "line_items": [
      {
        "id": "f3a25cc5-6e2c-4c79-a6e7-eb5c2c99a143",
        "3pl": {
          "id": "a3cbee36-2dab-3162-0bd2-221bcad231b",
          "name": "Two Boxes Demo 3PL"
        },
        "barcode": "810047100843",
        "captured_lpn": null,
        "carrier": null,
        "child_reason": null,
        "comments": null,
        "consolidation_code": null,
        "consolidation_provider": null,
        "disposition": "Return to Stock",
			 	"expected_quantity": 1,	
        "expiration_date": null,
        "graded_attributes": [
          {
            "id": "944b204c-37a6-43f7-93f8-bbd9c1b8d02a",
            "merchant_grading_attribute": {
              "id": "d7d2b33d-954c-4ee4-ac3f-49a6d0a9027c",
              "grading_attribute": {
                "id": "3dd0ffb8-ba8e-4a2c-8d6d-9863812902a4",
                "title": "No defects"
              },
              "mga_type": "inspection",
              "vas_definition": null
            },
            "vas_successful": null
          }
        ],
        "grading_ended_at": null,
        "return_line_item_grading_status": "archived_work_capture",
        "lot_code": null,
        "lpn": "TB-00000751",
        "merchant": {
          "id": "d7f98be6-12a3-4b0f-a2f9-d679f8ecb11e"
        },
        "parent_reason": null,
        "product_variant": {
          "barcode": "810047100843",
          "id": "a66818e5-89b3-438e-80d5-c312496c2ce9",
          "name": "Connect T-Shirt Dress - Pink/Reflex Blue / 3XL",
          "sku": "3XL-CTD-PNKBLU"
        },
        "put_away_bin": "1-A-01",
				"quantity": 1,	
        "rma_line_item_id": "1a270443-ec68-4005-add6-58e1a0118c38",
        "site": {
          "id": "f01bee36-b5bb-4464-a03d-157217f33a92",
          "name": "Two Boxes Demo"
        },
        "sku": "3XL-CTD-PNKBLU",
        "storefront_line_item_id": "",
        "storefront_order_id": null,
        "storefront_order_name": null,
        "storefront_order_number": null,
        "storefront_product_id": null,
        "storefront_variant_id": null,
        "tracking_number": null,
        "transform_sku": null,
        "transform_upc": null,
        "upc": null,
        "work_capture": true
      }
    ],
    "linked_line_items": [],
    "links": {
      "actions": null,
      "portal": "https://portal.twoboxes.com/3pls/5c949afb-e493-4b67-a7fd-8d5928d23ee7/returns/a8006401-43d7-4365-b642-0b9eff0c6071",
      "self": "https://api.twoboxes.io/api/v1/returns/a8006401-43d7-4365-b642-0b9eff0c6071"
    },
		// BEING DEPRECATED DEC 30, 2025
    "merchant_integration": {
      "id": "c1b14fad-b84f-4f08-bb79-322d4a645976",
      "merchant": {
        "id": "fb31bc87-6397-468c-8e65-4de80f020c02",
        "name": "Two Boxes Demo"
      },
      "name": "Two Boxes Demo",
      "site": {
        "id": "4f85a652-5cf8-473f-8b12-582249b4c881",
        "name": "Demos"
      }
    },
		//
    "return_provider": "work-capture",
    "return_type": "work-capture",
    "rma": "6eWsHRsdpetDjMaXALLh",
    "rma_address": {
      "address_1": "",
      "address_2": null,
      "city": null,
      "company": null,
      "country_code": null,
      "phone_number": null,
      "province_code": null,
      "zip": ""
    },
    "rma_return_id": "",
    "rts": false,
    "store_front_provider": "noop",
    "undeliverable_shipping_charge": null,
    "work_capture": true
  }