Set up maps with a Mapbox token

Couchwork can show your leads on a map and plan journeys between them. The maps come from a company called Mapbox. You create a free account with them, make a "token" (a long code that lets Couchwork draw their maps), and paste it into Couchwork.

Part 1: Make your Mapbox account

1. Go to mapbox.com and click Sign up. Follow the steps to create your account.
2. Add your card details first. In your Mapbox account, go to the billing page and add a card. This feels odd for something free, but Mapbox only lets you lock a token down to your own website once a card is on file, and locking it down is what keeps it safe.

Part 2: Create a token

1. In your Mapbox account, open the Tokens page (look for it in the account menu).
2. Click Create a token.
3. Give it a name you'll recognise, for example Couchwork.
4. Leave the default public permissions as they are.
5. Find the URL restrictions box and add the web address you use to open Couchwork, for example https://chat.yourcompany.com. Now the token only works from there, so nobody else can use it if they copy it.
6. Click Create token, then copy the token. It starts with pk.

Part 3: Give it to Couchwork

1. In Couchwork, click Settings → Integrations.
2. At the top, under Connected services, find the Maps card.
3. Paste your token into the Public token box.
4. Click Save token. Couchwork checks it with Mapbox and, if it's good, switches maps on. The card changes to On.

Click Test any time to check Mapbox still accepts the token. Turn off pauses maps without losing the token, and Remove deletes it.

Where you'll see maps

• On Leads, new Map and Routes buttons appear. Map shows your leads as pins, and Routes plans journeys between them and works out road distances.
• When you type an address into a contact or lead, Couchwork suggests matches as you type.