{
  "generated_from": "hookdeck/webhook-registry",
  "registry_commit": "a24c8d9784c9e9fe937c63f76adbce108201378f",
  "registry_committed_at": "2026-11-19T08:56:09Z",
  "disclaimer": "Independent reference. Not affiliated with Shopify.",
  "vendor": "shopify",
  "event": "returns/approve",
  "resource": "returns",
  "url": "https://hookdeck.com/webhooks/shopify/events/returns#returns%2Fapprove",
  "description": "Return approved and moved to OPEN",
  "trigger": null,
  "listed_in": "https://shopify.dev/docs/api/admin-graphql/latest/enums/WebhookSubscriptionTopic",
  "confidence": "documented",
  "schema_source": "from Shopify docs (example)",
  "identified_by": "x-shopify-topic header",
  "payload": {
    "provenance": "doc-example",
    "value_realism": "doc-example-values",
    "field_count": 26,
    "key_fields": [
      {
        "path": "id",
        "type": "integer",
        "example": "123134564567890"
      },
      {
        "path": "status",
        "type": "string",
        "example": "open"
      }
    ],
    "delivery": {
      "title": "From Shopify docs",
      "content_type": "application/json",
      "headers": []
    },
    "body": {
      "id": 123134564567890,
      "admin_graphql_api_id": "gid://shopify/Return/123134564567890",
      "status": "open",
      "order": {
        "id": 4783296544821,
        "admin_graphql_api_id": "gid://shopify/Order/4783296544821"
      },
      "total_return_line_items": 2,
      "name": null,
      "return_line_items": [
        {
          "id": 987654321,
          "admin_graphql_api_id": "gid://shopify/ReturnLineItem/987654321",
          "fulfillment_line_item": {
            "id": 4463854417760,
            "admin_graphql_api_id": "gid://shopify/FulfillmentLineItem/4463854417760",
            "line_item": {
              "id": 4176556606960,
              "admin_graphql_api_id": "gid://shopify/LineItem/4176556606960"
            }
          },
          "quantity": 1,
          "return_reason": "size_too_small",
          "return_reason_note": "",
          "customer_note": null,
          "restocking_fee": {
            "id": 283749348573489,
            "admin_graphql_api_id": "gid://shopify/RestockingFee/283749348573489",
            "price": {
              "shop_money": {
                "amount": "10.0",
                "currency_code": "XXX"
              },
              "presentment_money": {
                "amount": "10.0",
                "currency_code": "XXX"
              }
            }
          }
        },
        {
          "id": 987654322,
          "admin_graphql_api_id": "gid://shopify/ReturnLineItem/987654322",
          "fulfillment_line_item": {
            "id": 7219216693661,
            "admin_graphql_api_id": "gid://shopify/FulfillmentLineItem/7219216693661",
            "line_item": {
              "id": 7014063798651,
              "admin_graphql_api_id": "gid://shopify/LineItem/7014063798651"
            }
          },
          "quantity": 1,
          "return_reason": "size_too_large",
          "return_reason_note": "",
          "customer_note": null,
          "restocking_fee": null
        }
      ],
      "return_shipping_fees": [
        {
          "id": 987654321547866,
          "admin_graphql_api_id": "gid://shopify/ReturnShippingFee/987654321547866",
          "price": {
            "shop_money": {
              "amount": "10.0",
              "currency_code": "XXX"
            },
            "presentment_money": {
              "amount": "10.0",
              "currency_code": "XXX"
            }
          }
        }
      ],
      "exchange_line_items": [
        {
          "id": 987654321283476,
          "admin_graphql_api_id": "gid://shopify/ExchangeLineItem/987654321283476",
          "line_item": null
        }
      ],
      "total_exchange_line_items": 1
    }
  }
}