National Commerce Docs
n8n flows

Create ShipHero Hooks (Helper)

Operator helper for registering and managing per-brand ShipHero webhooks that push shipment updates to the Cloudflare Worker handler.

An operator helper for registering ShipHero webhooks per brand, so ShipHero pushes shipment updates to the project's Cloudflare Worker handler. Run by hand during brand onboarding and setup.

At a glance

  • Status: Inactive
  • Trigger: Manual only, an operator helper run by hand.
  • Runs on: One target brand at a time, keyed by n8n_id.
  • Talks to: ShipHero (public GraphQL webhook create/list/delete); Supabase (Brands lookup); Cloudflare Worker (shiphero-handler receiver).

How it works

  1. Edit Fields sets the target brand's n8n_id.
  2. Supabase looks up the Brands record by n8n_id, including shiphero_access_token.
  3. Register Shipment Hook On Shiphero sends a GraphQL webhook_create mutation for a "Shipment Update" hook pointing at the Cloudflare Worker shiphero-handler...workers.dev/process_shiphero_shipment?brand=<n8n_id>, and ShipHero returns the hook's shared signature secret.
  4. Disconnected helper nodes exist for manual use: Get Shiphero Hooks lists hooks and Delete Shipment Hook On Shiphero runs a webhook_delete.

Notes

  • The "Delete Shipment Hook" node has a hardcoded ShipHero bearer JWT embedded inline.
  • The returned shared_signature_secret is stored elsewhere to verify inbound webhook signatures.

Get the 2FA Code

Retrieves a two-factor authentication code to support the ShipHero web login flow.

Supabase RPC: Secret Insert/Read

Reference scenario that inserts and reads back an encrypted secret through Supabase RPCs instead of plaintext columns.

On this page

At a glanceHow it worksNotesRelated