Skip to main content
Shopify Admin Webhooks let you trigger Shopify Admin GraphQL calls from Firmhouse webhook events. This is useful when you want to automate Shopify updates from lifecycle events in Firmhouse, for example adding tags when a subscription is activated.

​
Enable the feature in New Features

Before this webhook type can be used, enable it in your project:
  1. In Firmhouse, open your project.
  2. Go to New Features in the sidebar.
  3. Find Shopify Admin Webhooks.
  4. Enable the feature toggle.
After enabling, you can create outgoing webhooks with the Shopify Admin content type.

​
Create a Shopify Admin webhook

  1. Go to Apps in the sidebar.
  2. Open Webhooks and click Configure.
  3. Click New outgoing webhook.
  4. Enter a Name.
  5. Set Content type to Shopify Admin.
  6. Choose an Event.
  7. Add your payload template (see below).
  8. Click Save.

​
Template format

The template must render valid JSON with a top-level query field.
  • query is required and must contain a GraphQL query or mutation.
  • variables is optional.
Example: 
{
  "query": "mutation tagsAdd($id: ID!, $tags: [String!]!) { tagsAdd(id: $id, tags: $tags) { node { id } userErrors { field message } } }",
  "variables": {
    "id": "{{ subscription.shopify_customer_id }}",
    "tags": ["subscription-active"]
  }
}
If template validation fails, check that:
  • The rendered payload is valid JSON.
  • query exists at the top level.
  • GraphQL syntax is valid.

​
How delivery works

For Shopify Admin webhooks:
  • Firmhouse sends the request to Shopify Admin GraphQL.
  • The request is sent as application/json.
  • X-Shopify-Access-Token is added automatically.
  • Http-Firmhouse-Signature is included like other outgoing webhooks.
  • Failed responses are retried automatically (up to 3 attempts).

​
Verify and troubleshoot

Open the webhook detail page and inspect Webhook event log:
  • Request body
  • Response code
  • Response body
If a request fails, fix the template/query and use Resend.