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

  1. Open Settings → Administration → Members → AI agents.
  2. On an active agent's row, click the bell icon, Notify this agent.

Step 2: Configure the webhook

  1. Enter a Name and the Endpoint URL. Only HTTPS endpoints are accepted.
  2. Choose the Events: Task assigned to an agent, Agent removed from a task, Record created, Record updated, Stage changed, or Status changed.
  3. Choose the Modules to watch: Task, Project, Ticket, Deal, Contact, or Entity.
  4. Leave Receive live events on, then click Create webhook.
  5. 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

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