Overview
An agent that runs outside Scrambl needs to know when there is work for it. Notify this agent creates a signed webhook that posts events to an HTTPS endpoint you control, such as Task assigned to an agent or Status changed.
Who can do this
- Owners and admins only: This is controlled by the workspace role (Owner or Admin), not by an access level, so it cannot be granted to other members.
- Agent notifications use outbound webhooks, which are included with the Pro and Business plans.
- Personal accounts: Not available. Agent accounts are a work feature and are hidden in personal (family) spaces.
Owners and admins review and change access levels in Settings → Administration → Members → Access levels.
Step 1: Open the notification dialog
- Open Settings → Administration → Members → AI agents.
- On an active agent's row, click the bell icon, Notify this agent.
Step 2: Configure the webhook
- Enter a Name and the Endpoint URL. Only HTTPS endpoints are accepted.
- Choose the Events: Task assigned to an agent, Agent removed from a task, Record created, Record updated, Stage changed, or Status changed.
- Choose the Modules to watch: Task, Project, Ticket, Deal, Contact, or Entity.
- Leave Receive live events on, then click Create webhook.
- Copy the signing secret and click I've saved the secret. The secret is shown only once.
Step 3: Verify deliveries
Each delivery carries an x-scrambl-signature header (sha256= followed by an HMAC-SHA256 of the request body, keyed with your secret), plus x-scrambl-event and x-scrambl-delivery. Reject any request whose signature doesn't match.
Pausing the agent, or changing its owner, stops deliveries.
Troubleshooting
| Issue | What to check |
|---|---|
| The bell icon is missing. | It appears only for admins, on active agents that aren't built in, on plans that include outbound webhooks (Pro and Business). |
| Deliveries stopped. | Check whether the agent was paused or its owner changed. |