Connect Workiz
What connecting Workiz does and how to get its key and connect it.
Workiz is field-service software. This article explains what connecting it does and how to connect it.
What it does
Connecting it copies your Workiz clients' names and numbers into your company contacts, so a client who calls shows by name before anyone picks up. Calls aren't logged back into Workiz.
Contacts sync every 6 hours (Workiz can only send everything at once), with a full sync each day that also removes contacts deleted there. Sync now on Contacts brings changes in straight away.
Before you start
- Plan: The Developer API add-on.
- On our side: a company administrator connects it, once, for the whole company.
Get your api token from Workiz
- In Workiz, switch on Developer API from the Feature center.
- Go to your profile icon, Settings > Integrations > Developer, and open the v1 tab.
- Click Generate API Credentials if none are shown, then copy the API Token.
Connect it
- In the portal, go to Contacts and click Connect a CRM (or Connect another CRM). You can also start from Company > Integrations.
- Choose Workiz and fill in:
- Click Connect & sync. The first sync runs straight away and says how many contacts came across.
- API token: the v1 tab
If it says Needs attention
The connection's card on Company > Integrations shows the last error. The usual causes:
- The key was reset, expired or deleted in Workiz: make a new one and connect again with it.
- The person who made the key lost access or left: make the key as someone who is staying.
- Regenerating the credentials replaces the token and stops this connection until you paste the new one in.
Press Sync now on the connection to try again straight away. To stop, press Disconnect: contacts already copied stay in your contacts.
