---
title: "Managed Agents: Triggers Reference (CRM, Appointment, Scheduled, Webhook) and Follow-Ups"
description: "Reference for every Managed Agent trigger: contact, opportunity, appointment, scheduled and inbound webhook triggers with filters and limits, plus scheduled follow-ups."
url: https://help.aesthetixcrm.com/en/articles/2225-managed-agents-triggers-reference-crm-appointment-scheduled-webhook-and-follow-ups
collection: "Agent Studio"
updated: 2026-11-20
language: en
---

# Managed Agents: Triggers Reference (CRM, Appointment, Scheduled, Webhook) and Follow-Ups

Reference for every Managed Agent trigger: contact, opportunity, appointment, scheduled and inbound webhook triggers with filters and limits, plus scheduled follow-ups.

Triggers decide what starts a Managed Agent without anyone typing a message. You add and edit them in **AI Agents > Agent Studio > Managed Agents**, open the agent, then use the **Triggers** section and **\+ Add Trigger**. This guide documents the CRM, appointment, scheduled and inbound webhook triggers in full, plus Scheduled Follow-Ups, which let an agent that is already running pause and resume later.

> **Protect patient privacy.** Aesthetix CRM's AI features are not approved for Protected Health Information (PHI). Do not put PHI into an agent's instructions, files, memory, knowledge, or prompts, and do not design triggers or webhooks that pass clinical details (diagnoses, treatment notes, photos, medical history) into the agent. Use first names, appointment times and general service names only.

## How Triggers Work

A trigger is an event. When the event happens and the agent is published, the agent starts a run and receives the event's data as its starting context. One agent can have several triggers at once (for example Chat, an appointment trigger and a schedule), and existing triggers keep working when new ones are added. A run only starts if the agent is **published**. Drafts and unpublished agents ignore production events.

### Adding a trigger with the Trigger Picker

1.  Go to **AI Agents > Agent Studio** and open the **Managed Agents** tab.
    
2.  Open the agent and find the **Triggers** section.
    
3.  Click **\+ Add Trigger**.
    
4.  Search by name or description, or browse a category.
    
    ![](https://files.us.gleap.ai/pf/g/640067b236b432d4bc3c20bb-711pVjPIRpa240Xxsh36ZVphBj20tqZIq1qKu0MMUOLh0yuAQZk3Fd75lYdD1VMufOBWnytqPdY.png?v=1&k=us1&s=api&e=1795348800&sig=NsrRWzSoXPiue-8kualFrNdoN6bpfiSjygdSISK0flY)
5.  Select a trigger. Its settings open in a side panel.
    
6.  Configure the settings and click **Save**. Closing the panel or clicking **Cancel** discards unsaved changes.
    
7.  To edit a trigger later, select it in the agent's Triggers section.
    

Picker categories: **Contacts, Tags, Opportunities, Appointments, Forms & Surveys, Communications, Scheduled**. The picker also has **Recently Used** and **Popular** lists. Triggers already configured show as **Added**. A **grayed out** trigger is unavailable with the current configuration.

Keyboard shortcuts in the picker: **Cmd+K or Ctrl+K** focuses search, **Up/Down arrows** move through the list, **Enter** selects the highlighted trigger, **Esc** closes the panel.

You can also describe a trigger to the AI builder in plain language, for example "Run this agent whenever someone books a consultation on my Botox calendar", and then review what it configured.

### All trigger types at a glance

<table style="min-width: 100px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p><strong>Trigger</strong></p></th><th colspan="1" rowspan="1"><p><strong>Fires when</strong></p></th><th colspan="1" rowspan="1"><p><strong>Filters and options</strong></p></th><th colspan="1" rowspan="1"><p><strong>Covered in</strong></p></th></tr><tr><td colspan="1" rowspan="1"><p>Chat</p></td><td colspan="1" rowspan="1"><p>A person messages the agent through a supported chat channel</p></td><td colspan="1" rowspan="1"><p>Depends on connected channels</p></td><td colspan="1" rowspan="1"><p>Building a Managed Agent guide</p></td></tr><tr><td colspan="1" rowspan="1"><p>Tag Changed</p></td><td colspan="1" rowspan="1"><p>A contact gains or loses a specified tag</p></td><td colspan="1" rowspan="1"><p>Tag and direction</p></td><td colspan="1" rowspan="1"><p>Building a Managed Agent guide</p></td></tr><tr><td colspan="1" rowspan="1"><p>Form Submitted</p></td><td colspan="1" rowspan="1"><p>A specified form is submitted</p></td><td colspan="1" rowspan="1"><p>Form selection; a PNG uploaded through a file-upload field is passed to the agent</p></td><td colspan="1" rowspan="1"><p>Building a Managed Agent guide</p></td></tr><tr><td colspan="1" rowspan="1"><p>Facebook Lead Form</p></td><td colspan="1" rowspan="1"><p>A contact submits a lead form on a connected Facebook Page</p></td><td colspan="1" rowspan="1"><p>Page, then all lead forms or specific forms</p></td><td colspan="1" rowspan="1"><p>Building a Managed Agent guide</p></td></tr><tr><td colspan="1" rowspan="1"><p>Survey Submitted</p></td><td colspan="1" rowspan="1"><p>Any selected survey receives a response</p></td><td colspan="1" rowspan="1"><p>One or more surveys</p></td><td colspan="1" rowspan="1"><p>Building a Managed Agent guide</p></td></tr><tr><td colspan="1" rowspan="1"><p>Contact Created</p></td><td colspan="1" rowspan="1"><p>A new contact is created</p></td><td colspan="1" rowspan="1"><p>None</p></td><td colspan="1" rowspan="1"><p>This guide</p></td></tr><tr><td colspan="1" rowspan="1"><p>Opportunity Created</p></td><td colspan="1" rowspan="1"><p>A new opportunity is created</p></td><td colspan="1" rowspan="1"><p>Pipeline, Opportunity Stage</p></td><td colspan="1" rowspan="1"><p>This guide</p></td></tr><tr><td colspan="1" rowspan="1"><p>Opportunity Status Changed</p></td><td colspan="1" rowspan="1"><p>An opportunity changes status</p></td><td colspan="1" rowspan="1"><p>Pipeline, Opportunity Stage, Opportunity Status</p></td><td colspan="1" rowspan="1"><p>This guide</p></td></tr><tr><td colspan="1" rowspan="1"><p>Customer Booked Appointment</p></td><td colspan="1" rowspan="1"><p>A new appointment is booked on a selected calendar</p></td><td colspan="1" rowspan="1"><p>Calendars (required)</p></td><td colspan="1" rowspan="1"><p>This guide</p></td></tr><tr><td colspan="1" rowspan="1"><p>Appointment Status Changed</p></td><td colspan="1" rowspan="1"><p>An existing appointment changes status</p></td><td colspan="1" rowspan="1"><p>Calendars (required), Statuses (optional)</p></td><td colspan="1" rowspan="1"><p>This guide</p></td></tr><tr><td colspan="1" rowspan="1"><p>Schedule</p></td><td colspan="1" rowspan="1"><p>A set time arrives</p></td><td colspan="1" rowspan="1"><p>Once, Set interval, Cron expression, end conditions</p></td><td colspan="1" rowspan="1"><p>This guide</p></td></tr><tr><td colspan="1" rowspan="1"><p>Inbound webhook</p></td><td colspan="1" rowspan="1"><p>An outside application sends a POST to the agent's webhook URL</p></td><td colspan="1" rowspan="1"><p>Name, optional shared-token verification</p></td><td colspan="1" rowspan="1"><p>This guide</p></td></tr><tr><td colspan="1" rowspan="1"><p>Invoked from a workflow</p></td><td colspan="1" rowspan="1"><p>A workflow reaches the Invoke Managed Agent action</p></td><td colspan="1" rowspan="1"><p>Workflow action settings</p></td><td colspan="1" rowspan="1"><p>Managed Agents: Invoke from Workflows and Deploy to API</p></td></tr><tr><td colspan="1" rowspan="1"><p>Invoked via API</p></td><td colspan="1" rowspan="1"><p>External software calls the agent through the Managed Agents API</p></td><td colspan="1" rowspan="1"><p>Private Integration token</p></td><td colspan="1" rowspan="1"><p>Managed Agents: Invoke from Workflows and Deploy to API</p></td></tr></tbody></table>

Existing agents and their triggers continue working without reconfiguration when you start using the Trigger Picker.

## Contact and Opportunity Triggers

These CRM triggers start an agent when contacts or opportunities are created or change status. They extend the Chat, Form Submitted, Tag Changed, Appointment and Schedule triggers rather than replacing them. Use the **Contacts** or **Opportunities** category in the picker.

### Contact Created

Fires every time a new contact is created in the CRM, however the contact arrived. There is no trigger-specific configuration.

-   **Data available to the agent:** the new contact record and its details.
    
-   **Med spa examples:** a welcome journey for a new lead, lead enrichment and qualification, new-patient onboarding reminders.
    
-   **Limits:** there is no filter, so every new contact starts a run. If you import a large contact list, expect one run per contact and consider whether you want this trigger enabled during the import.
    

### Opportunity Created

Fires when a new opportunity is created.

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p><strong>Filter</strong></p></th><th colspan="1" rowspan="1"><p><strong>What it does</strong></p></th></tr><tr><td colspan="1" rowspan="1"><p>Pipeline</p></td><td colspan="1" rowspan="1"><p>Only opportunities in the selected pipeline start the agent</p></td></tr><tr><td colspan="1" rowspan="1"><p>Opportunity Stage</p></td><td colspan="1" rowspan="1"><p>Only opportunities created in the selected stage start the agent</p></td></tr></tbody></table>

-   **Data available to the agent:** the opportunity and its contact, including its pipeline and stage.
    
-   **Med spa examples:** qualify a new "Consult Requested" opportunity, notify the front desk of a new high-value inquiry, run pipeline-specific follow-up for Injectables versus Laser.
    
-   **Limits:** follow any required-field indicators shown in Agent Studio. The filter fields are supported options, not guarantees about which are mandatory.
    

### Opportunity Status Changed

Fires when an opportunity changes status.

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p><strong>Filter</strong></p></th><th colspan="1" rowspan="1"><p><strong>What it does</strong></p></th></tr><tr><td colspan="1" rowspan="1"><p>Pipeline</p></td><td colspan="1" rowspan="1"><p>Limit to one pipeline</p></td></tr><tr><td colspan="1" rowspan="1"><p>Opportunity Stage</p></td><td colspan="1" rowspan="1"><p>Limit to one stage</p></td></tr><tr><td colspan="1" rowspan="1"><p>Opportunity Status</p></td><td colspan="1" rowspan="1"><p><strong>Open</strong>, <strong>Won</strong>, <strong>Lost</strong> or <strong>Abandoned</strong></p></td></tr></tbody></table>

-   **Data available to the agent:** the opportunity, its contact, and the new status, stage and pipeline.
    
-   **Med spa examples:** when a treatment-package opportunity is **Won**, start post-purchase onboarding and pre-treatment instructions; when one is **Lost**, send a gentle check-in a few days later and create a task for the patient coordinator.
    
-   **Limits:** only the four statuses above are supported.
    

### Setting up a CRM trigger

1.  Open the agent and click **\+ Add Trigger**.
    
2.  Pick **Contact Created**, **Opportunity Created** or **Opportunity Status Changed**.
    
3.  Set the filters (none for Contact Created).
    
4.  Write the agent's instructions and enable the tools it needs.
    
5.  Click **Save** in the trigger panel and test with a sample contact or opportunity.
    
6.  Publish the agent and review results in its **Activity** tab. If it did not run, check that the agent is published and the filters match.
    

## Appointment Triggers

Appointment triggers start an agent the moment a booking is created or its status changes. The agent receives appointment context, such as the calendar and status, so its instructions can reference those details. These triggers use the same real-time start-trigger system as the form, tag and chat triggers, so the testing, validation and publish steps are the same.

> **Native calendars only for AI booking.** Agents can book, reschedule or cancel appointments only on native Aesthetix CRM calendars, not on calendars synced from an EMR. Appointment triggers are built around calendars in your account. If your appointments live in an EMR and sync in, test carefully to confirm which events actually reach the agent before relying on a trigger, and do not instruct an agent to book into an EMR calendar.

### Trigger types

<table style="min-width: 75px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p><strong>Trigger (internal name)</strong></p></th><th colspan="1" rowspan="1"><p><strong>Fires when</strong></p></th><th colspan="1" rowspan="1"><p><strong>Typical use</strong></p></th></tr><tr><td colspan="1" rowspan="1"><p>Customer Booked Appointment (<code>appointment_booked</code>)</p></td><td colspan="1" rowspan="1"><p>A new appointment is successfully booked on one of the selected calendars</p></td><td colspan="1" rowspan="1"><p>Confirmation details, pre-appointment instructions, pre-qualifying questions</p></td></tr><tr><td colspan="1" rowspan="1"><p>Appointment Status Changed (<code>appointment_status</code>)</p></td><td colspan="1" rowspan="1"><p>An existing appointment's status changes</p></td><td colspan="1" rowspan="1"><p>Outcome-based flows</p></td></tr></tbody></table>

Statuses you can filter on: **Confirmed, Cancelled, Showed, No Show, Rescheduled**.

Outcome examples for Appointment Status Changed:

-   **Showed:** send a thank-you and aftercare education link.
    
-   **No Show or Cancelled:** start a reschedule or win-back conversation.
    
-   **Confirmed:** send directions, parking and arrival instructions.
    

### Advanced filters

<table style="min-width: 100px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p><strong>Filter</strong></p></th><th colspan="1" rowspan="1"><p><strong>Applies to</strong></p></th><th colspan="1" rowspan="1"><p><strong>Required</strong></p></th><th colspan="1" rowspan="1"><p><strong>Behavior</strong></p></th></tr><tr><td colspan="1" rowspan="1"><p>Calendars</p></td><td colspan="1" rowspan="1"><p>Both triggers</p></td><td colspan="1" rowspan="1"><p>Yes, at least one</p></td><td colspan="1" rowspan="1"><p>The agent runs only for events on the selected calendars. You cannot save the trigger without one.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Appointment Statuses</p></td><td colspan="1" rowspan="1"><p>Appointment Status Changed only</p></td><td colspan="1" rowspan="1"><p>No</p></td><td colspan="1" rowspan="1"><p>Narrow to specific statuses. If left empty, the agent runs on every status change on the selected calendars.</p></td></tr></tbody></table>

Patterns that work well:

-   Select only consultation calendars, not internal or admin calendars.
    
-   Create one agent flow per service line, for example Injectables Consult, Laser Consult, Skin Care Follow-Up.
    
-   Run on any status change for an internal calendar to feed internal notifications.
    
-   Start with one high-value calendar, confirm the logic works, then expand.
    

### Configure in the visual builder

1.  Open the Managed Agent and its Triggers section.
    
2.  Add **Customer Booked Appointment** or **Appointment Status Changed**.
    
    ![](https://files.us.gleap.ai/pf/g/640067b236b432d4bc3c20bb-Jd4VvSJ4wXXH1DcbcKA600KHwfdSTVTSmCFCCgfFju8wz6xQt7IDcLAGWHWaV5AgN2oiCrV5QYY.png?v=1&k=us1&s=api&e=1795348800&sig=6Ny0IkZdtj8z06bT3-X2PDIwgYDBhea0RNvE3zm7C8M)
3.  Select at least one calendar. Built-in validation requires it before you can save.
    
4.  For Appointment Status Changed, optionally select statuses.
    
    ![](https://files.us.gleap.ai/pf/g/640067b236b432d4bc3c20bb-MyCGgSStOuFzq0OkMKjA9H5XmQoNng81vF6FycbmJu4K4OedVs30LAkzGq2Kz598t3NWXgl6PqR.png?v=1&k=us1&s=api&e=1795348800&sig=NA9dCw3MaZx6DVWjtw9VP6pGiPSHaiU6tXL079keX4w)
5.  Save, test and publish so real appointment events start the agent.
    

### Configure with Builder Chat

Describe the automation in natural language, for example "Start this agent whenever someone books a consultation on my Sales calendar" or "Run this agent when a facial appointment is marked as No Show". The builder picks the trigger type, attaches it to the agent, and sets calendar and status filters. Afterward, open the trigger to verify the calendars and statuses, adjust prompts, and run tests before going live.

### Prepare and test

1.  Confirm the calendars are active and that appointment types, time zones and availability are correct.
    
2.  Design the agent's logic around appointment context: date and time, service or appointment type, and status. Typical steps are tagging the contact (for example "Consult Booked" or "No-Show Recovery Sent"), sending an SMS or email, and notifying staff.
    
3.  Use the test tools to simulate events. A separate test calendar and test contact keep real patients out of the test.
    
4.  Check the Activity feed and Agent Logs for correct metadata, then publish and monitor.
    

### Appointment events in the Activity feed

Appointment-triggered runs are easy to spot: a dedicated **calendar icon**, an **Appointment** event tag, and metadata showing the calendar and the status at the time the agent started. Use these to troubleshoot why a contact received a message and to confirm your filters work.

## Scheduled Triggers

A Schedule trigger starts a Managed Agent at a set time or on a repeating cadence, with no manual kickoff. Every scheduled run executes the complete agent: instructions, skills and CRM actions. The schedule becomes active when the agent is published.

### Schedule modes

<table style="min-width: 75px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p><strong>Mode</strong></p></th><th colspan="1" rowspan="1"><p><strong>Use it for</strong></p></th><th colspan="1" rowspan="1"><p><strong>Settings</strong></p></th></tr><tr><td colspan="1" rowspan="1"><p>Once</p></td><td colspan="1" rowspan="1"><p>One run at a specific date and time (end-of-month review, one-time reminder, a report before a meeting)</p></td><td colspan="1" rowspan="1"><p>Date and time. It does not repeat.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Set interval</p></td><td colspan="1" rowspan="1"><p>Repeating at a regular cadence</p></td><td colspan="1" rowspan="1"><p>Interval number with unit <strong>Minutes, Hours, Days, Weeks or Months</strong>; optional specific weekdays; an end condition</p></td></tr><tr><td colspan="1" rowspan="1"><p>Cron expression</p></td><td colspan="1" rowspan="1"><p>Advanced timing that an interval cannot express</p></td><td colspan="1" rowspan="1"><p>A cron expression</p></td></tr></tbody></table>

For a cron expression, enter the schedule in standard cron syntax, for example `0 9 * * 2-4` for 9:00 AM on Tuesday through Thursday, and review it carefully before publishing so it represents the cadence you intend.

![](https://files.us.gleap.ai/pf/g/640067b236b432d4bc3c20bb-8gkXIY39Q8rJih45a20gXXhGqxczVZp2nAdjVurYpkMQ2fbdRyzOmHUfMuQU9GzTS824lUP0VgK.png?v=1&k=us1&s=api&e=1795348800&sig=SfPUTv4_RFuJvqtOSpMwRZF3fVWa45nORoQNto4J570)

### End conditions for recurring schedules

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p><strong>End condition</strong></p></th><th colspan="1" rowspan="1"><p><strong>Behavior</strong></p></th></tr><tr><td colspan="1" rowspan="1"><p>Never</p></td><td colspan="1" rowspan="1"><p>Runs until you change or remove the schedule</p></td></tr><tr><td colspan="1" rowspan="1"><p>On a specific date</p></td><td colspan="1" rowspan="1"><p>Stops after the selected date (good for time-limited campaigns such as a monthly promotion)</p></td></tr><tr><td colspan="1" rowspan="1"><p>After a set number of runs</p></td><td colspan="1" rowspan="1"><p>Stops after the specified number of executions</p></td></tr></tbody></table>

### Multiple schedules on one agent

Add more than one schedule to the same agent when it needs different cadences with the same instructions. Example: a daily check of tomorrow's consults, a weekly summary every Monday, and a one-time review at the end of the month. Each schedule is configured separately in the Triggers area.

### Natural-language scheduling

Tell the builder what you want, such as "Run this every Tuesday, Wednesday and Thursday at 9 AM until the end of the month." The builder configures the trigger. Always review the dates, times, weekdays and end condition it set.

### Timezone

Scheduled triggers use your account's local timezone. Verify the account timezone before publishing so runs do not fire earlier or later than expected, especially for business-hours schedules and deadline-based campaigns.

### Setup

1.  Open the Managed Agent and click **Edit Agent**, then **Add trigger**.
    
    ![](https://files.us.gleap.ai/pf/g/640067b236b432d4bc3c20bb-wxdkQJoFyBISxpIooJRxAflinfOtzckstoiR9GUzLd7HrTNUTbViLOGi9X4zqqnxFrG8cjxpeGe.png?v=1&k=us1&s=api&e=1795348800&sig=An5pC4bkXPAE1XNx6u5IJj_bqlx9dHgdlO-sx25vO-c)
2.  Select **Schedule**.
    
3.  Choose **Once**, **Set interval** or **Cron expression**.
    
    ![](https://files.us.gleap.ai/pf/g/640067b236b432d4bc3c20bb-agTLMJVJr5GVUekS6GabJM89plDxDHBl1amZuVWvIKOB6PK2BFZWYGmdLSyIdyAJcbsmY4ysKhY.png?v=1&k=us1&s=api&e=1795348800&sig=2e0GH6GeodRsKVFjWGdVd5VbaKxPi0yzAbiiWiFJEQA)
4.  Enter the date and time, or the interval, weekdays and end condition, or the cron expression.
    
    ![](https://files.us.gleap.ai/pf/g/640067b236b432d4bc3c20bb-HYhFBNEVRWKaEoJk7lP7ceiOYZbCZGarGLOmKj9tAOm4fYcaKr4BSM57FSBOFMaUdalGPMMWK1p.png?v=1&k=us1&s=api&e=1795348800&sig=47UnK6a-7r24tK8XPbWNffvugFH3FXPLPZv05sj1cbY)
5.  Review the schedule in your account's timezone.
    
6.  Add another schedule if needed.
    
7.  Publish the agent.
    

Every scheduled run is logged in the agent's Activity feed. For step-level detail, see the Agent Logs guide.

### Scheduled Trigger versus Workflow Scheduler

A Schedule trigger starts a Managed Agent, which reasons and uses its skills and CRM actions. The Scheduler trigger in Marketing > Workflows starts a workflow that runs fixed workflow actions and logic. Use a Schedule trigger when an agent should do the work, and a workflow Scheduler when the process is better handled with workflow actions.

## Inbound Webhook Triggers

An Inbound webhook trigger starts a Managed Agent when an outside application sends an HTTP POST to the trigger's unique URL. The agent reads the incoming data using its instructions, so you do not need a separate workflow or field mapping. This is different from a workflow's Inbound Webhook trigger, which requires field mapping inside the workflow.

Example: when a retail or e-commerce store records an order for a skincare product, it posts the order details to the agent, which finds the matching contact and adds an internal note.

> Do not send PHI in webhook payloads. Send only the minimum identifiers the agent needs, such as an email address and an order or product name.

### How it works

1.  An external application sends an HTTP POST.
    
2.  If verification is enabled, the request is verified.
    
3.  The agent receives the request data as its initial input.
    
4.  The agent processes the data using its instructions.
    
5.  The run appears in the agent's Activity feed.
    
    ![](https://files.us.gleap.ai/pf/g/640067b236b432d4bc3c20bb-IrLi4Y5H6zDEP90SlK2MpcpmLjIdc9ktAQk8nYkSMixgcPvOFfDhYKm6uLXM05M9dAd7HXz7WDT.png?v=1&k=us1&s=api&e=1795348800&sig=iMlGw2GrXMu672uXaPl33cNGT91asm0-l8qVtkhO9fs)

The webhook works only while the agent is published. Unpublishing the agent or removing the trigger disables its URL.

### Request data and limits

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p><strong>Setting</strong></p></th><th colspan="1" rowspan="1"><p><strong>Limit or behavior</strong></p></th></tr><tr><td colspan="1" rowspan="1"><p>Request method</p></td><td colspan="1" rowspan="1"><p>POST</p></td></tr><tr><td colspan="1" rowspan="1"><p>Supported formats</p></td><td colspan="1" rowspan="1"><p>JSON, form data, XML, plain text, multipart</p></td></tr><tr><td colspan="1" rowspan="1"><p>Data the agent can read</p></td><td colspan="1" rowspan="1"><p>Request body, query parameters, and permitted headers</p></td></tr><tr><td colspan="1" rowspan="1"><p>Maximum payload</p></td><td colspan="1" rowspan="1"><p>256 KB</p></td></tr><tr><td colspan="1" rowspan="1"><p>Request rate</p></td><td colspan="1" rowspan="1"><p>Up to 60 requests per minute (confirm how the limit is scoped before building a high-volume integration)</p></td></tr><tr><td colspan="1" rowspan="1"><p>Successful acceptance</p></td><td colspan="1" rowspan="1"><p>HTTP 202 with a run ID. This means accepted and queued, not finished.</p></td></tr></tbody></table>

If the sender uses specific field names, put them in the agent's instructions, such as "the customer's email is in `customer.email`".

### Securing requests

Shared-token verification is optional but recommended when the sender supports headers. When enabled, the sender must include the token in one of these headers:

-   `X-Webhook-Token`
    
-   `Authorization: Bearer`
    

Requests without a valid required token are rejected with HTTP 401. The token is shown only when generated, so copy it immediately. You can regenerate it in the webhook settings, then update the sending application. Keep the webhook URL and token private.

### Multiple webhook triggers

One agent can have several Inbound webhook triggers, each with its own name, URL and message, for example **New Order** and **Refund Requested**. Give each a clear name and tell the agent how to handle its data.

### Responses and errors

<table style="min-width: 75px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p><strong>Status</strong></p></th><th colspan="1" rowspan="1"><p><strong>Meaning</strong></p></th><th colspan="1" rowspan="1"><p><strong>What to check</strong></p></th></tr><tr><td colspan="1" rowspan="1"><p>202</p></td><td colspan="1" rowspan="1"><p>Request accepted</p></td><td colspan="1" rowspan="1"><p>Review the run in Activity</p></td></tr><tr><td colspan="1" rowspan="1"><p>401</p></td><td colspan="1" rowspan="1"><p>Authentication failed</p></td><td colspan="1" rowspan="1"><p>Token and header</p></td></tr><tr><td colspan="1" rowspan="1"><p>404</p></td><td colspan="1" rowspan="1"><p>Webhook not found</p></td><td colspan="1" rowspan="1"><p>The webhook URL</p></td></tr><tr><td colspan="1" rowspan="1"><p>410</p></td><td colspan="1" rowspan="1"><p>Webhook unavailable</p></td><td colspan="1" rowspan="1"><p>Whether the trigger and agent are active</p></td></tr><tr><td colspan="1" rowspan="1"><p>413</p></td><td colspan="1" rowspan="1"><p>Request too large</p></td><td colspan="1" rowspan="1"><p>Reduce the payload below 256 KB</p></td></tr><tr><td colspan="1" rowspan="1"><p>415</p></td><td colspan="1" rowspan="1"><p>Unsupported format</p></td><td colspan="1" rowspan="1"><p>Format and Content-Type header</p></td></tr><tr><td colspan="1" rowspan="1"><p>429</p></td><td colspan="1" rowspan="1"><p>Too many requests</p></td><td colspan="1" rowspan="1"><p>Slow down and follow the Retry-After header</p></td></tr></tbody></table>

**Duplicates:** if a sender retries a delivery, a supported duplicate is recognized by an idempotency key, a webhook event ID, or a matching request body within a short period. Instead of starting another run, the original run is returned.

### Setup steps

1.  Open the Managed Agent, find **Triggers** and click **Add trigger**, then select **Inbound webhook** and name it.
    
2.  Write instructions telling the builder how to use the incoming data.
    
3.  Open the trigger settings. Under **Verification**, select **Shared token header**, generate the token, copy it securely, and save.
    
4.  Save, review the instructions, and publish the agent.
    
5.  In the Inbound webhook settings, click **Copy** beside **Webhook URL**. The URL is created when you save and becomes active when you publish.
    
6.  In the external application, choose **POST**, paste the URL, configure the data to send, and add the token header if verification is on.
    
7.  Send a test request, then check **Last request** in the trigger settings and open the linked run.
    
8.  Open the agent's **Activity** tab, select the **Webhook received** entry, and review the request and output. Adjust instructions as needed. Use synthetic data or a test contact for any agent that can send messages or update records.
    
    ![](https://files.us.gleap.ai/pf/g/640067b236b432d4bc3c20bb-FH0p9hcuVPoHALAEOT8aKqIxD4THMDkhZS6S6ugV8qM5kI0sjhYV0vZknQ4ST5ezbJhvO5WKyRY.png?v=1&k=us1&s=api&e=1795348800&sig=3UvZnvp-RfJ_32alM06dtdvI2SwjjkOEYPMCA2U52Fs)

## Scheduling Follow-Ups

Scheduled Follow-Ups let a running Managed Agent perform an action, wait, and resume with its earlier conversation context. Example: when someone books a consultation, the agent prepares a brief an hour before, creates a follow-up task after the visit, and checks days later whether the patient rebooked.

A Scheduled Trigger starts an agent at a set time. A Scheduled Follow-Up lets an agent that has already started pause and resume. You create and manage follow-ups by describing them to the AI builder.

![](https://files.us.gleap.ai/pf/g/640067b236b432d4bc3c20bb-wnpHOUfsxcyYHKRvtt3ydhQzd3UjvlTQEcPQjY8J7vzhPC2iQvUh4LyrdsjAkPo5jByHyRv89LU.png?v=1&k=us1&s=api&e=1795348800&sig=WjT9szrXnTIajucx88TV_V52PbgtfbPjlb-uWAEhLXA)

### Schedules and timing

Each step has its own timing and instructions. Actions can run:

-   **After a delay**, for example two hours after the agent starts.
    
-   **Before an event**, for example one hour before an appointment.
    
-   **After an event**, for example 30 minutes after an appointment ends.
    

Waiting periods range from **5 minutes to 30 days**. Times display in your account's timezone.

Example consultation follow-up schedule:

1.  One hour before the consult, prepare a short brief on the lead's interests.
    
2.  Thirty minutes after the consult, create a follow-up task for the coordinator.
    
3.  Three days after, create a manager review task if the opportunity has not progressed.
    

### Scheduling around events

Event-based timing works for appointments and other supported events such as webinars or open houses. If an appointment is rescheduled, the agent checks the updated details and adjusts applicable future reminders. If it is canceled, related follow-ups can be skipped.

### Conditions and stop rules

-   A **condition** controls whether a step runs, for example "send the reminder only if the contact has not replied".
    
-   A **stop rule** ends the remaining follow-ups, for example "stop once the contact books".
    

Describe both to the AI builder or adjust them in the schedule editor.

### Editing

Ask the builder, for example "Change the first reminder to two hours before the appointment" or "Send the reminder by SMS instead of email", or edit directly in the schedule editor, where you can review actions, add follow-ups, change conditions and manage stop rules. When you publish an updated plan, agents that are already waiting switch to the newly published plan.

### Monitoring and canceling waiting runs

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p><strong>Status</strong></p></th><th colspan="1" rowspan="1"><p><strong>Meaning</strong></p></th></tr><tr><td colspan="1" rowspan="1"><p>Waiting</p></td><td colspan="1" rowspan="1"><p>Paused until the next scheduled action</p></td></tr><tr><td colspan="1" rowspan="1"><p>Completed</p></td><td colspan="1" rowspan="1"><p>Finished successfully</p></td></tr><tr><td colspan="1" rowspan="1"><p>Failed</p></td><td colspan="1" rowspan="1"><p>Could not be completed</p></td></tr><tr><td colspan="1" rowspan="1"><p>Skipped</p></td><td colspan="1" rowspan="1"><p>The scheduled action did not run</p></td></tr></tbody></table>

1.  Go to **AI Agents > Agent Studio** and open the Managed Agent.
    
2.  Select **Activity**.
    
3.  Find the run marked **Waiting**.
    
4.  Review the resume time, open the run for step details, or click **Cancel wait** to stop it.
    
    ![](https://files.us.gleap.ai/pf/g/640067b236b432d4bc3c20bb-Unr1woeYkCN0UPf2hrYJoiflbqZAEqn4Er4uHIkQXTLbiMiImpUuBGfpyk6F7VFs83wbqcqxf73.png?v=1&k=us1&s=api&e=1795348800&sig=2PhgT-wKY7JwGWeWRdbSeXSvM0zI5usxql7mU-4nf54)

Unpublishing the agent stops its pending follow-up runs.

### Testing and billing

**Test Agent** runs the follow-up sequence and skips the waiting periods. Tests can still send real messages and perform real actions, so use your own contact details. Waiting is free whether it lasts 10 minutes or 30 days. Applicable AI usage charges apply when the agent resumes and performs work.

### Setup steps

1.  Open the Managed Agent (click **Edit agent** if updating).
    
2.  Describe the plan to the AI builder. Example: "When someone books a consultation, prepare a brief one hour before the appointment. Create a follow-up task 30 minutes after it ends. If the opportunity has not progressed after three days, create a manager review task. Stop the remaining follow-ups if the opportunity is won or lost."
    
3.  Review the timeline, each step's time, conditions and stop rules. Ask for changes, or click **Save changes** in the schedule editor.
    
    ![](https://files.us.gleap.ai/pf/g/640067b236b432d4bc3c20bb-RWeMxI7fboUKTkhr8sayGzMyUssRTB3opja5CfPBcVoZG2RXKlMYK1SgpsUVGJBSunnsSUnJQmk.png?v=1&k=us1&s=api&e=1795348800&sig=VC3bhbQf9OiZTG5D-FmIEZ2k4AmhVsH3mztA7yk8u8Y)
4.  Open **Test Agent** with your own contact and run the scenario.
    
5.  Publish the agent and confirm it shows as published.
    
6.  Monitor waiting runs in **Activity**.
    

## Frequently Asked Questions

**Does Contact Created need any configuration?**

No. It has no trigger-specific settings, so every new contact starts a run. Opportunity Created and Opportunity Status Changed add Pipeline and Stage filters, and the status trigger adds an Opportunity Status filter (Open, Won, Lost or Abandoned).

**Can an agent book appointments on my EMR calendar?**

No. AI appointment booking works only with native Aesthetix CRM calendars, not EMR calendars. Appointment triggers are designed around calendars in your account, so test any EMR-synced setup before relying on it.

**What happens if I leave the appointment status filter empty?**

The agent runs on every status change for appointments on the selected calendars. At least one calendar is always required.

**Which timezone do schedules and follow-ups use?**

Your account's local timezone. Check it before publishing a schedule.

**Does the agent have to be published for triggers to work?**

Yes. Schedules, webhooks, appointment triggers and CRM triggers all require a published agent. Unpublishing disables webhook URLs and stops pending follow-up runs.

**Does HTTP 202 from a webhook mean the agent finished?**

No. It means the request was accepted and queued. Check the run in Activity.

**What is the webhook payload limit and rate?**

256 KB per request and up to 60 requests per minute, with POST only. Larger payloads return 413 and excess requests return 429.

**Can I send patient health details through a webhook or into an agent?**

No. Aesthetix CRM's AI features are not approved for PHI. Send only minimal non-clinical identifiers and keep medical details out of instructions, files, memory, knowledge and prompts.

**Am I charged while a follow-up is waiting?**

No. Waiting is free. Charges apply when the agent resumes and does work.

**Can I stop a recurring schedule automatically?**

Yes. Choose an end date, a maximum number of runs, or let it run until you change it.
