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
2. Set a name for your webhook, for example "Internal ticket system" and click on Create
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:
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
Comments