Workflow triggers

Customer segment triggers

Workflow Companion can start a Shopify Flow workflow when a customer segment is created, updated, or deleted.

Available triggers

  • Segment created — starts when a customer segment is created.
  • Segment updated — starts when a customer segment is updated.
  • Segment deleted — starts when a customer segment is deleted.

How to turn them on

  1. In Settings → Triggers, select Manage in the Resource lifecycle row and turn on Customer segments.
  2. In Shopify Flow, build a workflow that starts with the trigger you need.

Workflow payload details

Segment created and Segment updated send:

  • Segment — the segment:
    • id — its ID, for example gid://shopify/Segment/123456789.
    • legacyResourceId — its numeric ID, for example 123456789.
    • name — its name.
    • query — the query that selects its customers, in Shopify's segment query language. For example, amount_spent > 1000.
  • Occurred at — when Shopify says the segment was created or updated, in ISO 8601 UTC. For example, 2026-09-23T14:05:06.123Z.

On Segment updated, name and query are the ones the segment has after the update.

Segment deleted sends:

  • Segment — the deleted segment:
    • id — its ID.
    • legacyResourceId — its numeric ID.
  • Occurred at — when Shopify says the segment was deleted, in ISO 8601 UTC.

Important considerations

  • Runs aren't guaranteed to start in the order the changes happened. Occurred at says when each one did.