403 after enforcing an app IP allowlist, check the actual outbound address or ASN of each failing worker. Since November 11, 2026, Shopify supports mixing up to 250 IP addresses/CIDR ranges with up to 10 ASNs, plus up to 10 countries limiting ASN traffic.On this page
Why this happens or what changed
Older setup guidance often treats IP and ASN entries as mutually exclusive. Shopify’s new configuration allows both in the same list. A request is allowed if it matches an eligible IP entry or an eligible ASN entry. Country restrictions apply to ASN matches, not the explicitly listed IP addresses. An ASN covers other tenants on the provider’s network, so it is not equivalent to your own dedicated egress IP.
Practical fix
- Open Dev Dashboard → app → Settings → IP allowlist and inspect the active entries.
- Identify the outbound IP and hosting ASN for each API caller, including background jobs, queue consumers, and regional failover.
- Add dedicated IPs or narrow CIDR ranges where available. Use an ASN only where fixed egress is impractical, and limit eligible countries to actual hosting regions.
- Do not assume the country filter narrows a separately entered static IP; treat each allow rule as an independent path.
- Test the configuration against recent traffic before enabling enforcement. Roll out during a monitored window and preserve a recovery procedure.
Production considerations
Separate a network-level HTTP 403 from a GraphQL response containing authorization errors: the latter may indicate missing scopes or resource permissions. Log HTTP status, request origin, job type, and a non-sensitive correlation identifier; never log Admin API tokens. When a provider changes egress dynamically, the failure may affect only scheduled tasks or one deployment region.
How to test this
- Run the same harmless Admin GraphQL query from each known egress region.
- Compare HTTP status before and after enforcement; inspect response status separately from GraphQL errors.
- Verify an explicitly listed static IP works even if it is outside an ASN country restriction.
- Verify a permitted ASN region works and an excluded test origin is rejected.
- Trigger a queue job and scheduled sync, then monitor for intermittent 403s across regions.

