HTTP Action Agent
The HTTP Action Agent evaluates incoming messages (for example email or chat) and, when they match defined rules, calls external HTTP APIs. Typical uses include creating CRM leads, opening tickets, or notifying downstream systems.
It is a Pro agent type.
What it does
- Reads user or listener input and decides if a configured action applies
- Extracts structured fields (email, name, company, message summary) for the API call
- Sends authenticated requests to URLs you define
- Skips the call when input does not clearly qualify (conservative matching)
When to use it
Use the HTTP Action Agent when email or chat should trigger real systems: CRM contact creation, marketing automation, internal webhooks, or custom backends. It fits squads that already process mail with the Email Response Agent or handle webhooks.
Configuration
Configure from the agent instance in the dashboard:
- HTTP actions: one or more actions, each with a name, target URL, HTTP method, and qualification description (when the agent should fire).
- Payload schema: fields to send in the request body.
- Credentials: bearer tokens or other auth needed by the API.
Each action includes a plain-language qualification prompt so the agent only calls the API when appropriate.
Typical usage
Add to a sequential squad after agents that normalize or enrich the message. Connect Gmail listeners for sales inquiries that should create leads in HubSpot or similar systems.