Connect AI clients to Spur messaging and audience workflows

Use SPUR segments when

• You need Spur-native filters like Spur tags, message activity, workflow state, or website events.
• You just imported a CSV cohort and want one tag-based audience for broadcasts.
• The audience logic is campaign-specific and does not need to exist in Shopify admin.

Use Shopify segments when

• You want Shopify-native audience logic for reuse in Shopify marketing or discount workflows.
• Rules rely on Shopify customer facts like amount spent, number of orders, or subscription status.
• You want Spur to sync and use the same segment definition already managed in Shopify.

CSV import to broadcast audience

1. Run customer_import_csv_validate, then customer_import_csv_start, and poll customer_import_csv_status.
2. Find the latest import tag with contact_tag_search (query: Imported on).
3. Create one SPUR segment using segment_create with customSegment.spurTags and operator SPUR_TAGS=true.
4. Use that segment in broadcast_create and launch with broadcast_launch.

Shopify-native segment lifecycle

1. Call shopify_segment_query_reference to get syntax and examples before writing queries.
2. Validate query syntax with shopify_segment_validate before create or update.
3. Create or update with shopify_segment_create or shopify_segment_update.
4. Sync with shopify_segment_sync, then discover segment IDs via segment_search with type=SHOPIFY.