Overview

You can integrate any third-party software with Auto Purchase Orders using the app’s built-in webhooks. A webhook is an event-driven communication mechanism that automatically sends data between applications. In our case, data is sent from Auto Purchase Orders to 3rd-party software.

With webhooks, you can integrate services such as QuickBooks, Xero, Google Sheets, and many more.

Currently, only three events are available:

1. purchase_orders/create – triggered when a purchase order is created.
2. purchase_orders/update – triggered when a PO is updated.
3. purchase_orders/complete – triggered when a PO is marked as complete.

This is a sample JSON payload that the app sends in a webhook:

{
  "id": 1,
  "po_number": "2",
  "date_created": "2025-02-23",
  "expected_date": null,
  "supplier": {
    "company": "Burberry California",
    "comment": null,
    "country": null,
    "created_at": "2025-02-03T18:01:48.323Z",
    "currency_code": "USD",
    "address": {
      "id": 12410984,
      "company": "Burberry California",
      "contact_name": null,
      "phone": null,
      "address_line_1": null,
      "address_line_2": null,
      "city": null,
      "country": null,
      "country_code": null,
      "postal_code": null,
      "region": null,
      "__typename": "Address"
    },
    "email_recipients": [
      {
        "email": "d@magicbits.io",
        "name": "Dan"
      }
    ]
  },
  "billing_address": {
    "id": 12410827,
    "company": null,
    "contact_name": null,
    "phone": "",
    "address_line_1": "Miami Street",
    "address_line_2": "",
    "city": "Hanahan",
    "country": "United States",
    "country_code": "US",
    "postal_code": "29410",
    "region": "South Carolina",
    "__typename": "Address"
  },
  "shipping_address": {
    "id": 12410827,
    "company": null,
    "contact_name": null,
    "phone": "",
    "address_line_1": "Miami Street",
    "address_line_2": "",
    "city": "Hanahan",
    "country": "United States",
    "country_code": "US",
    "postal_code": "29410",
    "region": "South Carolina",
    "__typename": "Address"
  },
  "currency": "USD",
  "comment": null,
  "products": [
    {
      "id": 1304297,
      "properties": [],
      "variant_id": "gid://shopify/ProductVariant/41201003298919",
      "product_id": "gid://shopify/Product/7207040974951",
      "inventory_item_id": "gid://shopify/InventoryItem/43300489592935",
      "supplier_ref": "80979681005-S",
      "tax_percent": null,
      "variant_title": "Coal / S",
      "product_title": "Aran Wool Blend Polo Shirt",
      "image_src": "https://cdn.shopify.com/s/files/1/0585/9154/3399/files/D9BE1B45-8122-469E-8E34-76174C652189.jpg?v=1738604332",
      "quantity": 3,
      "sku": "80979681005-S",
      "is_shopify": true,
      "line_items": [],
      "unit_price": {
        "pure": "1155.00",
        "currency_code": "USD"
      },
      "line_item_id": null
    },
    {
      "id": 1304298,
      "properties": [],
      "variant_id": "gid://shopify/ProductVariant/41201003331687",
      "product_id": "gid://shopify/Product/7207040974951",
      "inventory_item_id": "gid://shopify/InventoryItem/43300489625703",
      "supplier_ref": "80979681005-M",
      "tax_percent": null,
      "variant_title": "Coal / M",
      "product_title": "Aran Wool Blend Polo Shirt",
      "image_src": "https://cdn.shopify.com/s/files/1/0585/9154/3399/files/D9BE1B45-8122-469E-8E34-76174C652189.jpg?v=1738604332",
      "quantity": 3,
      "sku": "80979681005-M",
      "is_shopify": true,
      "line_items": [],
      "unit_price": {
        "pure": "1155.00",
        "currency_code": "USD"
      },
      "line_item_id": null
    },
    {
      "id": 1304299,
      "properties": [],
      "variant_id": "gid://shopify/ProductVariant/41201003364455",
      "product_id": "gid://shopify/Product/7207040974951",
      "inventory_item_id": "gid://shopify/InventoryItem/43300489658471",
      "supplier_ref": "80979681005-L",
      "tax_percent": null,
      "variant_title": "Coal / L",
      "product_title": "Aran Wool Blend Polo Shirt",
      "image_src": "https://cdn.shopify.com/s/files/1/0585/9154/3399/files/D9BE1B45-8122-469E-8E34-76174C652189.jpg?v=1738604332",
      "quantity": 3,
      "sku": "80979681005-L",
      "is_shopify": true,
      "line_items": [],
      "unit_price": {
        "pure": "1155.00",
        "currency_code": "USD"
      },
      "line_item_id": null
    }
  ],
  "authorized_by": null,
  "completed_at": null,
  "created_at": "2025-02-23T09:17:40.288Z",
  "updated_at": "2025-02-23T09:17:40.288Z",
  "shipping_and_handling_price": {
    "pure": "55.00",
    "currency_code": "USD"
  },
  "shopify_order_id": null,
  "shopify_order_name": null,
  "shopify_order_ids": [],
  "shopify_order_names": []
}

Creating a webhook

In order to register a webhook, open the app > Settings > Webhooks, and find the Register webhook button.

In the modal that opens, select a topic and provide the URL to which the app should send the webhook.