Environments

Sparqle runs two isolated environments. Each has its own base URL and its own API key. Orders, labels, and webhooks never cross between them.

Environment	Base URL	Purpose
Test	`https://staging-v2.sparqle.tech`	Build and validate your integration. No real courier is dispatched.
Live	`https://v2.sparqle.com`	Production. Creating an order dispatches a real delivery.

Confirm the live base URL with your Sparqle contact before going to production — it is environment-specific and may differ from the value above.

Going live checklist

Swap the base URL and key

Move from staging-v2.sparqle.tech + test key to the live URL + live key.

Re-point your webhooks

Confirm your locationId

Live locationId values differ from test. Use the ones issued for production.

Run one real order end to end

Create, print the label, and confirm you receive the expected status webhooks before enabling at scale.