Webhooks are a simple way for two systems to “talk” to each other automatically.
When something happens in Docket, like a job being completed, a webhook sends a message containing those details to another system of your choice.
Think of it like a notification system: you do something → our system automatically sends data to your other tool → that tool can take action right away.
This helps keep your systems in sync without someone needing to manually export data from one system and uploading it to another.
Here are a few examples of common webhooks that are used frequently:
- Sending task completion info to a CRM or ERP system.
- Triggering automations in tools like Zapier or Make (Integromat).
- Updating customer records in real time.
- Notifying external teams or systems when work is done.
Before You Start
Here are a few things to know before you continue:
- You must be the Account Owner in order to set up a webhook in your Docket account.
- Only 1 webhook can be set up in your Docket account at this time.
- Our Support team cannot help with setting up, managing, or troubleshooting a webhook that you’ve set up in your Docket account.
- We strongly recommend making sure that the receiving system can accept JSON data before setting up a webhook in Docket.
Available Webhooks in Docket
There are three types of webhooks currently available in Docket:
- Rental Task Completed
- Task Completed
- Job Completed
When a task, job, or rental task is completed, the webhook sends the following data to your receiving system.
| Field | Description |
| task_number | The unique number for the completed task |
| customer_name | The name of the customer tied to the task |
| customer_email | The customer’s email address |
| task_address | The address where the work occurred |
| completion_date | The date the task was completed |
| completion_time | The time the task was completed |
| assigned_driver | The driver who completed the task |
| asset_type | The type of asset involved (dumpster, cart, etc…) |
| task_type | The type of task (pickup, delivery, etc…) |
| contact_name | The name of the contact person on the task |
| contact_email | The contact’s email address |
Each time a completion occurs, this data is sent as a small, structured message (in JSON format) to your specified webhook URL.
How To Set Up a Webhook in Docket
We strongly recommend making sure that the receiving system can accept JSON data before setting up a webhook in Docket.
You can easily create a webhook by following the below instructions:
- Click on Account in the bottom left of the navigation menu.
- Click on Settings at the top.
- Click on Notifications.
- Click on “View” under Webhooks.
- Toggle on Enable Webhook.
- Enter the URL for where you want Docket data to be sent.
- Select your Trigger Types from the dropdown menu. You can select more than one.
- Select the Authentication Type from the dropdown menu.
- Add your custom script with what data you want to send into the Custom Payload JSON field. Use the Available Variables to make your script even more dynamic!
- Don’t forget to click “Save Settings” in the top right corner!
TIP: Click the “Reset to Default Payload” button at the bottom to clear the Custom Payload JSON field and start over.
After you click “Save Settings”, the webhook will be enabled for your account. From then on, whenever a job or task is completed, Docket will automatically send the information to your specified URL via this new webhook.
Here’s an example of what the JSON script for a webhook might look like in the Custom Payload JSON field:
If your webhook ever stops working, double-check that your URL is still active and that your receiving system isn’t blocking the request.
You can also test your webhook beforehand with free tools like Webhook.site.
If you have any questions, please reach out to our Support team through the chat widget on the bottom right of this page or by sending an email to support@yourdocket.com!