set_trigger

Create an outbound event trigger (a webhook) so an external tool is notified when something happens in the workspace — a new contact, a reply, a meeting booked.

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

Name	Type	Required	Description
url	string	yes	The destination URL the event is POSTed to.
events	string[]	yes	Event names to fire on (see list_triggers for the catalog).
name	string		Optional 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.