Connect a work giver by API
Give a work giver's own system a key, so their jobs arrive on your board and your time, sign-off and invoices go back to them.
Some work givers run their own system for the jobs they send to contractors, such as a facilities manager, a builder or a property manager. If their system can send jobs to Crewzy, you give it a key, and their jobs arrive on your board like any other. Your time, sign-off and invoice go back to their system when the job is done.
For a head contractor on Simpro, see Connect a head contractor instead.
Make the key
Go to Settings, Connections and press Connect by API.
- Under Work giver, choose the customer their jobs belong to, or A new customer and type their business name.
- Press Make the key.
- Copy the Key and the API address. The key is shown this once.
- Send both to the work giver, to put in their system on their record for your business. Their developers need the work giver API reference.
Treat the key like a password. Anyone holding it can send jobs to your board.
What happens then
The connection shows Waiting for their system until their system calls with the key and says where results go. After that it shows Working.
- Their jobs appear on your board, tagged connected, against the customer you chose.
- The details they set on the job, such as the title, the site and the due date, change only from their side. Your crew, the schedule, time and parts are yours.
- When a job is completed, the time on it and the sign-off go back to them. When you send an invoice for one of their jobs, it goes back to them too.
- If they cancel a job you have already started, it is flagged under To talk to the work giver about, rather than cancelled underneath you.
Anything their system will not take is listed under Sync issues with Retry.
A new key, or disconnecting
New key makes a new key and stops the old one at once. Their jobs stop arriving until they put the new key in their system. Use it if the key has gone somewhere it should not.
Disconnect stops their jobs coming in and throws the key away. Jobs already here stay. Reconnect makes a new key, which they put in their system again.