n8n
Automations are Basic and up. See Webhook automations for limits and details.
n8n is an automation platform you can self-host or use in the cloud. Connect TellDone to n8n using a Webhook node. Your n8n instance must be reachable from the internet over HTTPS, with a domain name (IP addresses are rejected).
Setup
In n8n
- Add a Webhook node to your workflow
- Set HTTP Method to POST
- Set a path (for example,
telldone) - (Optional) Enable Header Auth: Name =
Authorization, Value = your secret token - Copy the Production URL (not the test URL)
The Production URL only receives data while the workflow is active, so turn it on first.
In TellDone
- Go to Settings > Integrations > Automations
- Tap New automation, enter a name (for example, "n8n"), and paste the n8n production URL
- If you enabled Header Auth in n8n, enter the same token as the auth header in TellDone
- Choose which data types to send (Note, Note + audio on Ultra, Tasks, Events, Reports) and which triggers to use (Created, Updated, Completed, Deleted)
- Tap Save, then Test send to send a sample payload
Check the n8n execution log - you should see a payload with "test": true.
Routing by event type
Add a Switch node after the Webhook node to route data by event type:
- Routing field: the
eventvalue from the incoming data - Rule 1: equals
note.created- route to your notes actions - Rule 2: equals
task.created- route to your tasks actions - Rule 3: equals
calendar_event.created- route to your calendar actions - Rule 4: equals
report.created- route to your reports actions - If you also turn on the Updated, Completed, or Deleted triggers, add rules for those event types too, for example
task.completed
Connect each Switch output to the appropriate action node (Todoist, Google Calendar, Slack, etc.).
Useful expressions
When configuring action nodes, use these n8n expressions to access TellDone data:
| Expression | Description |
|---|---|
{{ $json.data.title }} | Title of the note, task, or event |
{{ $json.data.tags.join(', ') }} | Tags as a comma-separated string |
{{ $json.data.priority }} | Priority level |
{{ $json.data.due_date }} | Due date (tasks) |
{{ $json.data.summary }} | AI-generated summary (notes) |
{{ $json.event }} | Event type |
For the full list of fields in each data type, see Webhook automations - What gets sent.
Filtering test events
Add an IF node right after the Webhook node:
- Condition:
{{ $json.test }}is not true - True path: rest of your workflow
- False path: No Operation (discard test events)
Example workflows
- Webhook > Switch > Todoist: create tasks with priority and due date
- Webhook > Switch > Google Calendar: create events with time, location, and attendees
- Webhook > Switch > Slack: post daily reports to a channel
- Webhook > Switch > Google Sheets: log all notes as spreadsheet rows
- Webhook > Switch > Notion: save notes with tags and summary
Checking that requests come from TellDone
n8n can't verify TellDone's signature, because its nodes only see the parsed data, not the exact raw body that TellDone signed. Use Header Auth instead: turn it on in the Webhook node and enter the same token as the auth header in TellDone (steps 4 and 8). n8n then rejects any request without that token.
Disconnect
To stop sending data to n8n:
- Deactivate the workflow in n8n, or
- In TellDone, in Settings > Integrations > Automations, turn off the automation's Active switch or tap Delete automation
See also
- Webhook automations - payload format, delivery limits, and security
- Zapier - cloud automation alternative
- Make - cloud automation alternative