Setting up a custom integration
Connect your own system to Routelink with a pull, push, or manual sync.
A custom integration is for when you own the system that holds orders and want a direct connection, without Shopify, Xero, or Zapier in the middle.
Before you start
- A Routelink Business plan (custom integrations are not on Starter or Professional)
- An endpoint you control, or the ability to POST to Routelink
1. Add the integration
In Routelink, go to Settings → Integrations, click Add Integration on the Custom card, and enter an Integration Name you’ll recognize later.
2. Choose a sync method
Pick a Sync Method:
- Pull: Routelink fetches tasks from your endpoint on a schedule.
- Push: your system POSTs tasks to a URL Routelink generates after the first save.
- Manual: tasks are only synced when you trigger it yourself, from Plan → Add Tasks → Import from Integration.
We recommend Pull. Routelink checks your endpoint on a schedule you choose, so nothing on your side has to remember to send orders, and a missed run is picked up on the next one.
3. Configure the connection
For pull:
- Choose the HTTP Method (GET or POST) and enter the URL of your endpoint.
- Choose a Sync Frequency: every 15 minutes, 30 minutes, hour, 6 hours, or 12 hours, or once a day.
- Click Add Header for any headers your API expects, such as an API key.
- If your API uses basic authentication, turn on Use Basic Authentication and enter the Username and Password.
- Turn on Enable Integration and click Save Changes.
For push:
- Turn on Enable Integration and click Save Changes.
- Open the integration again from Settings → Integrations and copy the URL under POST tasks to this URL.
- Send tasks to that URL from your system.
Either way, your endpoint or payload needs to use a format Routelink can read. Email [email protected] to agree the field mapping before you go live.
4. Test it
Send or fetch a single test task and confirm it appears in the inbox with the right address, reference, and contact details.
Next steps
Still stuck? Email [email protected] and we'll help you out.