Workast Help Center

Search for answers to your questions by entering keywords below, or look through our knowledge base.

Incoming Webhooks

Incoming Webhooks are a simple way to create tasks inside To-do bot from external sources. They make use of normal HTTP requests with a JSON payload that includes the task text and some additional details. 
 
Creating a webhook URL
 
To get started, you need to create a webhook URL for the list where you would like to create tasks. You can create as many webhook URLs as you need.
 
1. Go to a list in your dashboard and click on Webhooks on the list menu
 
craete-webhooks-1.gif
 
2. Set a name for your webhook, for example "Internal ticket system" and click on Create
create-webhooks-2.png
3. From here, copy the webhook URL that was recently created https://hooks.todobot.io/....
NOTE: Keep this URL safe. Anyone that has access to the URL will be able to create tasks in your list.
 
Creating your first task
 
The webhook URL accepts the HTTP POST method with the header Content-Type: application/json and with the basic task details as JSON body.
 
If you are familiar with curl, you can try to create a task right away 
 
curl -XPOST -H "Content-type: application/json" -d '{"text": "A task from the new webhook URL"}' 'https://hooks.todobot.io/your-token'
 
More than just text for a task
 
You can add a description and due date to a task while you create. The field "text" is always required. Here is an example of a task with more details:
 
{
    "text": "Ticket #123 - Customer can't print invoice",
    "description": "When the customer logs into the portal, she clicks on the invoice but nothing happens.",
    "dueDate":"2017-07-14T20:11:43"
}
 
Note: dueDate should be in UTC
 
This is what the task looks like from the dashboard:
 
create-webhooks-3.png
Feedback
 
This is the first version of webhooks, and our first step towards connecting 3rd party apps with To-do bot. Please let us know if you have any questions or feedback: support@todobot.io
 
 
 
Was this article helpful?
4 out of 4 found this helpful

Comments