Skip to content

Privacy and analytics

We use necessary technical cookies and, only with your consent, analytics and marketing pixels to improve the website and measure campaigns.

Privacy policyCookie policy
Docs
GuidesNömad MediaDevelopers
English
EspañolEnglishFrançaisDeutschItaliano

Start building

  • Your first API call
  • Limits, versions and headers

API

  • Brand API
    • Errors
    • Permissions and roles
    • Events and webhooks
    • Brand
    • Genome
    • Brand Kit
    • Library
    • Works
    • Calendar
    • Connections
    • Publishing
    • Inbox
    • Team
    • Account and team
    • Conversation
    • Memory
    • Questions
    • Media
    • Store
    • Plan
    • Orders
    • Activity
    • Workspace
    • Your account
    • Billing
    • Sync
    • Website and domains
    • Statistics
    • Mailing
    • Media
    • Apps
    • Automations
    • Events

MCP

  • MCP server

Connectors

  • Brand connectors
API/Brand API
Reference9 min read

Automations

What the brand does on its own: when something happens, a series of steps, with a dry run and a history.

Português
Русский
한국어
日本語
中文
हिन्दी
Open the app
On this page
  • automations.catalog · Automation catalog
  • automations.list · Automations of the brand
  • automations.get · One automation
  • automations.create · Create an automation
  • automations.save · Save an automation
  • automations.publish · Turn an automation on
  • automations.set_active · Turn an automation on or off
  • automations.trash · Delete an automation
  • automations.restore · Restore an automation
  • automations.test · Test an automation
  • automations.run · Run an automation
  • automations.runs.retry · Retry a run
  • automations.runs.list · Automation history
  • automations.email.send · Email the person
  • automations.team.notify · Notify a team member
  • automations.mailing.add · Add to a Mailing group
  • automations.webhook.send · Send to another tool (webhook)
  • automations.webhook_secret.get · Automation webhook signing
  • automations.webhook_secret.rotate · Create or change the signing key
  • automations.draft · Ask Nödo for an automation
  • automations.incoming.get · Incoming webhook address
  • automations.incoming.rotate_url · Create or change the incoming webhook address
  • automations.incoming.rotate_secret · Create or change the incoming webhook key
  • automations.incoming.listen · Listen for a test call
  • automations.webhooks.list · Brand webhooks
  • automations.webhooks.get · A brand webhook
  • automations.webhooks.create · Create a brand webhook
  • automations.webhooks.update · Update a brand webhook
  • automations.webhooks.delete · Delete a brand webhook
  • automations.webhooks.rotate_secret · Rotate a webhook secret
  • automations.webhooks.test · Test a webhook
  • automations.webhooks.deliveries.list · Webhook deliveries
  • automations.webhooks.deliveries.get · What a delivery sent
  • automations.webhooks.deliveries.replay · Replay an event

The exact input and output of each operation are in /api/v1/openapi.json with your token, or from an agent with nomad_describe.

automations.catalog · Automation catalog

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.

FieldValue
KindRead
HTTP methodPOST /api/v1/automations.catalog
MCP toolautomations_catalog
Scopeautomations.read
Minimum roleViewer
Human confirmationNo
DoorsScreens
StatusAvailable

automations.list · Automations of the brand

The brand’s automations with their state (draft, active, paused), step count, published version and whether the draft has unpublished changes.

FieldValue
KindRead
HTTP methodPOST /api/v1/automations.list
MCP toolautomations_list
Scopeautomations.read
Minimum roleViewer
Human confirmationNo
DoorsScreens
StatusAvailable

automations.get · One automation

One automation with the trigger and steps of its draft; send revision back as expectedRevision when saving.

FieldValue
KindRead
HTTP methodPOST /api/v1/automations.get
MCP toolautomations_get
Scopeautomations.read
Minimum roleViewer
Human confirmationNo
DoorsScreens
StatusAvailable

automations.create · Create an automation

Creates a draft automation, empty or from a recipe. It does nothing until it is completed and turned on.

FieldValue
KindWrite
HTTP methodPOST /api/v1/automations.create
MCP toolautomations_create
Scopeautomations.write
Minimum roleMember
Human confirmationNo
DoorsScreens
StatusAvailable

automations.save · Save an automation

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.

FieldValue
KindWrite
HTTP methodPOST /api/v1/automations.save
MCP toolautomations_save
Scopeautomations.write
Minimum roleMember
Human confirmationNo
DoorsScreens
StatusAvailable

automations.publish · Turn an automation on

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).

FieldValue
KindWrite
HTTP methodPOST /api/v1/automations.publish
MCP toolautomations_publish
Scopeautomations.write
Minimum roleAdmin
Human confirmationNo
DoorsScreens
StatusAvailable

automations.set_active · Turn an automation on or off

Pauses an automation, or turns it back on with its last published version (automation_not_published when it has none).

FieldValue
KindWrite
HTTP methodPOST /api/v1/automations.set_active
MCP toolautomations_set_active
Scopeautomations.write
Minimum roleAdmin
Human confirmationNo
DoorsScreens
StatusAvailable

automations.trash · Delete an automation

Moves an automation to the trash and stops it; automations.restore brings it back paused.

FieldValue
KindWrite
HTTP methodPOST /api/v1/automations.trash
MCP toolautomations_trash
Scopeautomations.write
Minimum roleMember
Human confirmationYes
DoorsScreens
StatusAvailable

automations.restore · Restore an automation

Brings an automation back from the trash, paused: turning it on is a separate decision.

FieldValue
KindWrite
HTTP methodPOST /api/v1/automations.restore
MCP toolautomations_restore
Scopeautomations.write
Minimum roleMember
Human confirmationNo
DoorsScreens
StatusAvailable

automations.test · Test an automation

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.

FieldValue
KindRead
HTTP methodPOST /api/v1/automations.test
MCP toolautomations_test
Scopeautomations.read
Minimum roleViewer
Human confirmationNo
DoorsScreens
StatusAvailable

automations.run · Run an automation

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.

FieldValue
KindWrite
HTTP methodPOST /api/v1/automations.run
MCP toolautomations_run
Scopeautomations.write
Minimum roleMember
Human confirmationNo
DoorsScreens
StatusAvailable

automations.runs.retry · Retry a run

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.

FieldValue
KindWrite
HTTP methodPOST /api/v1/automations.runs.retry
MCP toolautomations_runs_retry
Scopeautomations.write
Minimum roleMember
Human confirmationNo
DoorsScreens
StatusAvailable

automations.runs.list · Automation history

The latest runs of an automation (kept 30 days) with what each step did. It holds states and codes, never the values handled.

FieldValue
KindRead
HTTP methodPOST /api/v1/automations.runs.list
MCP toolautomations_runs_list
Scopeautomations.read
Minimum roleViewer
Human confirmationNo
DoorsScreens
StatusAvailable

automations.email.send · Email the person

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.

FieldValue
KindWrite
HTTP methodPOST /api/v1/automations.email.send
MCP toolautomations_email_send
Scopeautomations.write
Minimum roleAdmin
Human confirmationNo
DoorsScreens
StatusAvailable

automations.team.notify · Notify a team member

Leaves a notice for a person of the brand’s team, in the Inbox and by email as they prefer, linking to the automation.

FieldValue
KindWrite
HTTP methodPOST /api/v1/automations.team.notify
MCP toolautomations_team_notify
Scopeautomations.write
Minimum roleMember
Human confirmationNo
DoorsScreens
StatusAvailable

automations.mailing.add · Add to a Mailing group

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.

FieldValue
KindWrite
HTTP methodPOST /api/v1/automations.mailing.add
MCP toolautomations_mailing_add
Scopeautomations.write
Minimum roleMember
Human confirmationNo
DoorsScreens
StatusAvailable

automations.webhook.send · Send to another tool (webhook)

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.

FieldValue
KindWrite
HTTP methodPOST /api/v1/automations.webhook.send
MCP toolautomations_webhook_send
Scopeautomations.write
Minimum roleAdmin
Human confirmationNo
DoorsScreens
StatusAvailable

automations.webhook_secret.get · Automation webhook signing

Says whether the brand already has the key its automation webhooks are signed with, and since when. The key itself is never shown again.

FieldValue
KindRead
HTTP methodPOST /api/v1/automations.webhook_secret.get
MCP toolautomations_webhook_secret_get
Scopeautomations.read
Minimum roleViewer
Human confirmationNo
DoorsScreens
StatusAvailable

automations.webhook_secret.rotate · Create or change the signing key

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.

FieldValue
KindWrite
HTTP methodPOST /api/v1/automations.webhook_secret.rotate
MCP toolautomations_webhook_secret_rotate
Scopeautomations.write
Minimum roleAdmin
Human confirmationNo
DoorsScreens
StatusAvailable

automations.draft · Ask Nödo for an automation

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.

FieldValue
KindWrite
HTTP methodPOST /api/v1/automations.draft
MCP toolautomations_draft
Scopeautomations.write
Minimum roleMember
Human confirmationNo
DoorsScreens
StatusAvailable

automations.incoming.get · Incoming webhook address

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.

FieldValue
KindRead
HTTP methodPOST /api/v1/automations.incoming.get
MCP toolautomations_incoming_get
Scopeautomations.read
Minimum roleViewer
Human confirmationNo
DoorsScreens
StatusAvailable

automations.incoming.rotate_url · Create or change the incoming webhook address

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.

FieldValue
KindWrite
HTTP methodPOST /api/v1/automations.incoming.rotate_url
MCP toolautomations_incoming_rotate_url
Scopeautomations.write
Minimum roleMember
Human confirmationNo
DoorsScreens
StatusAvailable

automations.incoming.rotate_secret · Create or change the incoming webhook key

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.

FieldValue
KindWrite
HTTP methodPOST /api/v1/automations.incoming.rotate_secret
MCP toolautomations_incoming_rotate_secret
Scopeautomations.write
Minimum roleMember
Human confirmationNo
DoorsScreens
StatusAvailable

automations.incoming.listen · Listen for a test call

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.

FieldValue
KindWrite
HTTP methodPOST /api/v1/automations.incoming.listen
MCP toolautomations_incoming_listen
Scopeautomations.write
Minimum roleMember
Human confirmationNo
DoorsScreens
StatusAvailable

automations.webhooks.list · Brand webhooks

The brand’s webhooks with their state, and how many workspace webhooks also receive its events. Never the secret.

FieldValue
KindRead
HTTP methodPOST /api/v1/automations.webhooks.list
MCP toolautomations_webhooks_list
Scopeautomations.read
Minimum roleViewer
Human confirmationNo
DoorsScreens
StatusAvailable

automations.webhooks.get · A brand webhook

One of the brand’s webhooks with its state and failures. Never the secret.

FieldValue
KindRead
HTTP methodPOST /api/v1/automations.webhooks.get
MCP toolautomations_webhooks_get
Scopeautomations.read
Minimum roleViewer
Human confirmationNo
DoorsScreens
StatusAvailable

automations.webhooks.create · Create a brand webhook

An HTTPS endpoint that receives the chosen events of the brand, signed (Nomad-Signature). The signing secret (whsec_…) is returned once.

FieldValue
KindWrite
HTTP methodPOST /api/v1/automations.webhooks.create
MCP toolautomations_webhooks_create
Scopeautomations.write
Minimum roleAdmin
Human confirmationNo
DoorsScreens
StatusAvailable

automations.webhooks.update · Update a brand webhook

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.

FieldValue
KindWrite
HTTP methodPOST /api/v1/automations.webhooks.update
MCP toolautomations_webhooks_update
Scopeautomations.write
Minimum roleAdmin
Human confirmationNo
DoorsScreens
StatusAvailable

automations.webhooks.delete · Delete a brand webhook

Stops sending events to that endpoint and removes its delivery log.

FieldValue
KindWrite
HTTP methodPOST /api/v1/automations.webhooks.delete
MCP toolautomations_webhooks_delete
Scopeautomations.write
Minimum roleAdmin
Human confirmationYes
DoorsScreens
StatusAvailable

automations.webhooks.rotate_secret · Rotate a webhook secret

Issues a new signing secret; the previous one keeps signing for 24 hours so receivers switch without downtime. Returned once.

FieldValue
KindWrite
HTTP methodPOST /api/v1/automations.webhooks.rotate_secret
MCP toolautomations_webhooks_rotate_secret
Scopeautomations.write
Minimum roleAdmin
Human confirmationNo
DoorsScreens
StatusAvailable

automations.webhooks.test · Test a webhook

Sends a signed test event (webhook.test) now and reports what the endpoint answered. Not stored in the log.

FieldValue
KindWrite
HTTP methodPOST /api/v1/automations.webhooks.test
MCP toolautomations_webhooks_test
Scopeautomations.write
Minimum roleAdmin
Human confirmationYes
DoorsScreens
StatusAvailable

automations.webhooks.deliveries.list · Webhook deliveries

A brand webhook’s delivery log, newest first.

FieldValue
KindRead
HTTP methodPOST /api/v1/automations.webhooks.deliveries.list
MCP toolautomations_webhooks_deliveries_list
Scopeautomations.read
Minimum roleViewer
Human confirmationNo
DoorsScreens
StatusAvailable

automations.webhooks.deliveries.get · What a delivery sent

The exact body a delivery sent: the event with its ids and the names of the fields, never their values.

FieldValue
KindRead
HTTP methodPOST /api/v1/automations.webhooks.deliveries.get
MCP toolautomations_webhooks_deliveries_get
Scopeautomations.read
Minimum roleViewer
Human confirmationNo
DoorsScreens
StatusAvailable

automations.webhooks.deliveries.replay · Replay an event

Sends an event from the log again, as a new delivery with its own retries. Only events the webhook subscribes to.

FieldValue
KindWrite
HTTP methodPOST /api/v1/automations.webhooks.deliveries.replay
MCP toolautomations_webhooks_deliveries_replay
Scopeautomations.write
Minimum roleAdmin
Human confirmationYes
DoorsScreens
StatusAvailable
PreviousAppsNextEvents

In this section

  • Errors
  • Permissions and roles
  • Events and webhooks
  • Brand
  • Genome
  • Brand Kit
  • Library
  • Works
Can't find what you need? Write to usWrite to usGo to the app
© 2026 Nömad · Nömad documentationLinkedInInstagramThreadsFacebookTikTokYouTubeX
Go to nomad.oooBack to top

On this page

  • automations.catalog · Automation catalog
  • automations.list · Automations of the brand
  • automations.get · One automation
  • automations.create · Create an automation
  • automations.save · Save an automation
  • automations.publish · Turn an automation on
  • automations.set_active · Turn an automation on or off
  • automations.trash · Delete an automation
  • automations.restore · Restore an automation
  • automations.test · Test an automation
  • automations.run · Run an automation
  • automations.runs.retry · Retry a run
  • automations.runs.list · Automation history
  • automations.email.send · Email the person
  • automations.team.notify · Notify a team member
  • automations.mailing.add · Add to a Mailing group
  • automations.webhook.send · Send to another tool (webhook)
  • automations.webhook_secret.get · Automation webhook signing
  • automations.webhook_secret.rotate · Create or change the signing key
  • automations.draft · Ask Nödo for an automation
  • automations.incoming.get · Incoming webhook address
  • automations.incoming.rotate_url · Create or change the incoming webhook address
  • automations.incoming.rotate_secret · Create or change the incoming webhook key
  • automations.incoming.listen · Listen for a test call
  • automations.webhooks.list · Brand webhooks
  • automations.webhooks.get · A brand webhook
  • automations.webhooks.create · Create a brand webhook
  • automations.webhooks.update · Update a brand webhook
  • automations.webhooks.delete · Delete a brand webhook
  • automations.webhooks.rotate_secret · Rotate a webhook secret
  • automations.webhooks.test · Test a webhook
  • automations.webhooks.deliveries.list · Webhook deliveries
  • automations.webhooks.deliveries.get · What a delivery sent
  • automations.webhooks.deliveries.replay · Replay an event