Skip to main content
Wire the user’s stack to fire when the record changes. Pass the destination URL and which events to fire on. Call list_triggers first to see the catalog of available event names.

​
Parameters

NameTypeRequiredDescription
urlstringyesThe destination URL the event is POSTed to.
eventsstring[]yesEvent names to fire on (see list_triggers for the catalog).
namestringOptional label for the trigger.

​
Returns

Trigger created for interaction.email_received → https://hooks.example.com/nous.

​
When to call it

  • When the user wants an external tool (n8n, a Slack relay, their own service) notified on a workspace event.
  • After list_triggers so you use valid event names.

​
Backed by

POST /v2/workspace/triggers — the agent setup surface, on the same trigger store as the dashboard. Logged to the Ops page.