Automations
What the brand does on its own: when something happens, a series of steps, with a dry run and a history.
Privacy and analytics
We use necessary technical cookies and, only with your consent, analytics and marketing pixels to improve the website and measure campaigns.
What the brand does on its own: when something happens, a series of steps, with a dry run and a history.
The exact input and output of each operation are in /api/v1/openapi.json with your token, or from an agent with nomad_describe.
What can start an automation (the brand’s event types) and what it can do (capabilities marked for automation, with the fields of each), generated from the capability contracts.
| Field | Value |
|---|---|
| Kind | Read |
| HTTP method | POST /api/v1/automations.catalog |
| MCP tool | automations_catalog |
| Scope | automations.read |
| Minimum role | Viewer |
| Human confirmation | No |
| Doors | Screens |
| Status | Available |
The brand’s automations with their state (draft, active, paused), step count, published version and whether the draft has unpublished changes.
| Field | Value |
|---|---|
| Kind | Read |
| HTTP method | POST /api/v1/automations.list |
| MCP tool | automations_list |
| Scope | automations.read |
| Minimum role | Viewer |
| Human confirmation | No |
| Doors | Screens |
| Status | Available |
One automation with the trigger and steps of its draft; send revision back as expectedRevision when saving.
| Field | Value |
|---|---|
| Kind | Read |
| HTTP method | POST /api/v1/automations.get |
| MCP tool | automations_get |
| Scope | automations.read |
| Minimum role | Viewer |
| Human confirmation | No |
| Doors | Screens |
| Status | Available |
Creates a draft automation, empty or from a recipe. It does nothing until it is completed and turned on.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/automations.create |
| MCP tool | automations_create |
| Scope | automations.write |
| Minimum role | Member |
| Human confirmation | No |
| Doors | Screens |
| Status | Available |
Saves the draft’s name, trigger and steps. What is published does not change until it is published again. With expectedRevision, an automation someone else saved meanwhile answers conflict.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/automations.save |
| MCP tool | automations_save |
| Scope | automations.write |
| Minimum role | Member |
| Human confirmation | No |
| Doors | Screens |
| Status | Available |
Checks the draft against the catalog, keeps it as a new version and makes the automation active. An incomplete one answers invalid_input (automation_incomplete).
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/automations.publish |
| MCP tool | automations_publish |
| Scope | automations.write |
| Minimum role | Admin |
| Human confirmation | No |
| Doors | Screens |
| Status | Available |
Pauses an automation, or turns it back on with its last published version (automation_not_published when it has none).
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/automations.set_active |
| MCP tool | automations_set_active |
| Scope | automations.write |
| Minimum role | Admin |
| Human confirmation | No |
| Doors | Screens |
| Status | Available |
Moves an automation to the trash and stops it; automations.restore brings it back paused.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/automations.trash |
| MCP tool | automations_trash |
| Scope | automations.write |
| Minimum role | Member |
| Human confirmation | Yes |
| Doors | Screens |
| Status | Available |
Brings an automation back from the trash, paused: turning it on is a separate decision.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/automations.restore |
| MCP tool | automations_restore |
| Scope | automations.write |
| Minimum role | Member |
| Human confirmation | No |
| Doors | Screens |
| Status | Available |
Says what the draft would do with the brand’s latest matching event, step by step, changing nothing: conditions evaluated, inputs filled and checked against each capability.
| Field | Value |
|---|---|
| Kind | Read |
| HTTP method | POST /api/v1/automations.test |
| MCP tool | automations_test |
| Scope | automations.read |
| Minimum role | Viewer |
| Human confirmation | No |
| Doors | Screens |
| Status | Available |
Starts the published version of an active automation now; the engine picks it up within a minute. automation_not_published when it is not active.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/automations.run |
| MCP tool | automations_run |
| Scope | automations.write |
| Minimum role | Member |
| Human confirmation | No |
| Doors | Screens |
| Status | Available |
Sends a failed run back to the step that failed; earlier steps are not repeated. automation_run_not_retryable when it was cut halfway, since that step may already be done.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/automations.runs.retry |
| MCP tool | automations_runs_retry |
| Scope | automations.write |
| Minimum role | Member |
| Human confirmation | No |
| Doors | Screens |
| Status | Available |
The latest runs of an automation (kept 30 days) with what each step did. It holds states and codes, never the values handled.
| Field | Value |
|---|---|
| Kind | Read |
| HTTP method | POST /api/v1/automations.runs.list |
| MCP tool | automations_runs_list |
| Scope | automations.read |
| Minimum role | Viewer |
| Human confirmation | No |
| Doors | Screens |
| Status | Available |
Sends an email in the brand’s name to the person of the event: who buys, writes or books. Only to an email of the event itself, never to a typed address. Up to 200 an hour per brand and 3 a day per person.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/automations.email.send |
| MCP tool | automations_email_send |
| Scope | automations.write |
| Minimum role | Admin |
| Human confirmation | No |
| Doors | Screens |
| Status | Available |
Leaves a notice for a person of the brand’s team, in the Inbox and by email as they prefer, linking to the automation.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/automations.team.notify |
| MCP tool | automations_team_notify |
| Scope | automations.write |
| Minimum role | Member |
| Human confirmation | No |
| Doors | Screens |
| Status | Available |
Adds the person of the event to a Mailing group, sending nothing. Only when they are already a customer (a paid order or a booking), the legal basis Mailing accepts without express consent; whoever unsubscribed stays out.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/automations.mailing.add |
| MCP tool | automations_mailing_add |
| Scope | automations.write |
| Minimum role | Member |
| Human confirmation | No |
| Doors | Screens |
| Status | Available |
POSTs the event and its data to an https address, signed with the Nomad-Signature header like Nömad’s webhooks. No private addresses or redirects; three attempts.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/automations.webhook.send |
| MCP tool | automations_webhook_send |
| Scope | automations.write |
| Minimum role | Admin |
| Human confirmation | No |
| Doors | Screens |
| Status | Available |
Says whether the brand already has the key its automation webhooks are signed with, and since when. The key itself is never shown again.
| Field | Value |
|---|---|
| Kind | Read |
| HTTP method | POST /api/v1/automations.webhook_secret.get |
| MCP tool | automations_webhook_secret_get |
| Scope | automations.read |
| Minimum role | Viewer |
| Human confirmation | No |
| Doors | Screens |
| Status | Available |
Creates the key the brand’s automation webhooks are signed with, or changes it. It is shown once; the previous one keeps signing for 24 hours.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/automations.webhook_secret.rotate |
| MCP tool | automations_webhook_secret_rotate |
| Scope | automations.write |
| Minimum role | Admin |
| Human confirmation | No |
| Doors | Screens |
| Status | Available |
Nödo turns what the brand describes in its own words into a draft automation built only from events and actions that exist. Saves nothing: the draft opens in the editor.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/automations.draft |
| MCP tool | automations_draft |
| Scope | automations.write |
| Minimum role | Member |
| Human confirmation | No |
| Doors | Screens |
| Status | Available |
Whether the automation already has an address to receive webhooks (only its end: the whole address is shown once), whether it has a signing key, whether it is listening for a test, the fields of the latest test call and the latest calls received.
| Field | Value |
|---|---|
| Kind | Read |
| HTTP method | POST /api/v1/automations.incoming.get |
| MCP tool | automations_incoming_get |
| Scope | automations.read |
| Minimum role | Viewer |
| Human confirmation | No |
| Doors | Screens |
| Status | Available |
Creates the address another tool calls to start the automation, or a new one. It is shown once; the previous one stops working at once.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/automations.incoming.rotate_url |
| MCP tool | automations_incoming_rotate_url |
| Scope | automations.write |
| Minimum role | Member |
| Human confirmation | No |
| Doors | Screens |
| Status | Available |
Creates the key the other tool signs its calls with (Nomad-Signature), or a new one. It is shown once; the previous one stops counting at once.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/automations.incoming.rotate_secret |
| MCP tool | automations_incoming_rotate_secret |
| Scope | automations.write |
| Minimum role | Member |
| Human confirmation | No |
| Doors | Screens |
| Status | Available |
For ten minutes the next call to the address starts nothing: it is kept for an hour so the brand can choose the data the automation will use from it.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/automations.incoming.listen |
| MCP tool | automations_incoming_listen |
| Scope | automations.write |
| Minimum role | Member |
| Human confirmation | No |
| Doors | Screens |
| Status | Available |
The brand’s webhooks with their state, and how many workspace webhooks also receive its events. Never the secret.
| Field | Value |
|---|---|
| Kind | Read |
| HTTP method | POST /api/v1/automations.webhooks.list |
| MCP tool | automations_webhooks_list |
| Scope | automations.read |
| Minimum role | Viewer |
| Human confirmation | No |
| Doors | Screens |
| Status | Available |
One of the brand’s webhooks with its state and failures. Never the secret.
| Field | Value |
|---|---|
| Kind | Read |
| HTTP method | POST /api/v1/automations.webhooks.get |
| MCP tool | automations_webhooks_get |
| Scope | automations.read |
| Minimum role | Viewer |
| Human confirmation | No |
| Doors | Screens |
| Status | Available |
An HTTPS endpoint that receives the chosen events of the brand, signed (Nomad-Signature). The signing secret (whsec_…) is returned once.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/automations.webhooks.create |
| MCP tool | automations_webhooks_create |
| Scope | automations.write |
| Minimum role | Admin |
| Human confirmation | No |
| Doors | Screens |
| Status | Available |
Changes the URL, events or description, or turns it on and off. Turning it on resets its failures and makes the caller answer for it.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/automations.webhooks.update |
| MCP tool | automations_webhooks_update |
| Scope | automations.write |
| Minimum role | Admin |
| Human confirmation | No |
| Doors | Screens |
| Status | Available |
Stops sending events to that endpoint and removes its delivery log.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/automations.webhooks.delete |
| MCP tool | automations_webhooks_delete |
| Scope | automations.write |
| Minimum role | Admin |
| Human confirmation | Yes |
| Doors | Screens |
| Status | Available |
Issues a new signing secret; the previous one keeps signing for 24 hours so receivers switch without downtime. Returned once.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/automations.webhooks.rotate_secret |
| MCP tool | automations_webhooks_rotate_secret |
| Scope | automations.write |
| Minimum role | Admin |
| Human confirmation | No |
| Doors | Screens |
| Status | Available |
Sends a signed test event (webhook.test) now and reports what the endpoint answered. Not stored in the log.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/automations.webhooks.test |
| MCP tool | automations_webhooks_test |
| Scope | automations.write |
| Minimum role | Admin |
| Human confirmation | Yes |
| Doors | Screens |
| Status | Available |
A brand webhook’s delivery log, newest first.
| Field | Value |
|---|---|
| Kind | Read |
| HTTP method | POST /api/v1/automations.webhooks.deliveries.list |
| MCP tool | automations_webhooks_deliveries_list |
| Scope | automations.read |
| Minimum role | Viewer |
| Human confirmation | No |
| Doors | Screens |
| Status | Available |
The exact body a delivery sent: the event with its ids and the names of the fields, never their values.
| Field | Value |
|---|---|
| Kind | Read |
| HTTP method | POST /api/v1/automations.webhooks.deliveries.get |
| MCP tool | automations_webhooks_deliveries_get |
| Scope | automations.read |
| Minimum role | Viewer |
| Human confirmation | No |
| Doors | Screens |
| Status | Available |
Sends an event from the log again, as a new delivery with its own retries. Only events the webhook subscribes to.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/automations.webhooks.deliveries.replay |
| MCP tool | automations_webhooks_deliveries_replay |
| Scope | automations.write |
| Minimum role | Admin |
| Human confirmation | Yes |
| Doors | Screens |
| Status | Available |