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:

  1. Choose the HTTP Method (GET or POST) and enter the URL of your endpoint.
  2. Choose a Sync Frequency: every 15 minutes, 30 minutes, hour, 6 hours, or 12 hours, or once a day.
  3. Click Add Header for any headers your API expects, such as an API key.
  4. If your API uses basic authentication, turn on Use Basic Authentication and enter the Username and Password.
  5. Turn on Enable Integration and click Save Changes.

For push:

  1. Turn on Enable Integration and click Save Changes.
  2. Open the integration again from Settings → Integrations and copy the URL under POST tasks to this URL.
  3. 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.