Trigger Shopify Flow workflows

​

Enable the feature in New Features

1. In Firmhouse, open your project.
2. Go to New Features in the sidebar.
3. Find Shopify Flow Triggers.
4. Enable the feature toggle.

​

Create a Shopify Flow trigger 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 Flow trigger.
6. Choose an Event.
7. Add your payload template (see below).
8. Click Save.

​

Template format

• custom_payload is expected to be an array of key/value objects.
• key must be a string.
• value must be a string.
• If the template renders blank, Firmhouse sends an empty custom_payload array.

{
  "custom_payload": [
    {
      "key": "plan_name",
      "value": "{{ subscription.active_plan.name }}"
    },
    {
      "key": "status",
      "value": "{{ subscription.status }}"
    },
    {
      "key": "full_name",
      "value": "{{ subscription.full_name }}"
    },
    {
      "key": "next_billing_date",
      "value": "{{ subscription.next_billing_date }}"
    }
  ]
}

​

React to a skipped recurring order

{
  "custom_payload": [
    {
      "key": "subscription_id",
      "value": "{{ subscription.id }}"
    },
    {
      "key": "reason",
      "value": "{{ recurring_order_skip.reason }}"
    }
  ]
}

• minimum_amount_not_reached
• unavailable_product
• out_of_stock

​

Why this is more reliable

​

How delivery works

• Firmhouse sends a flowTriggerReceive mutation 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

• Request body
• Response code
• Response body

​

Related articles

• Adding, managing, and removing webhooks
• Use Shopify Admin Webhooks
• Shopify Flow documentation