Agent Actions

From answers to action

Most chatbots can only repeat what they were trained on. Yours can call any endpoint you own, in the middle of a conversation, and answer from the live response.

  • Any REST endpoint: GET, POST, PUT, PATCH or DELETE
  • Bearer, API key or basic auth, configured per action
  • Test an action against the real endpoint before it goes live

Where is order #4412?

lookupOrder200 OK42 ms

GETapi.acme.com/orders/{order_id}

Authorization: Bearer ••••••••

{ "status": "shipped", "carrier": "UPS", "eta": "Thu" }

Shipped yesterday via UPS. It should arrive Thursday.

What an action can do

An action is a description of one endpoint you own. The agent decides when a question needs it, fills in the parameters from the conversation, calls it, and answers from what comes back.

Look up live data

Order status, account balance, delivery date, ticket state. The agent reads it from your system at the moment it is asked, so the answer is never stale.

Change something

Actions are not read-only. Cancel a subscription, apply a refund, update an address, open a ticket. Any write endpoint you are willing to expose.

Authenticate per action

Each action carries its own credentials: bearer token, API key, basic auth, or none. One agent can talk to several systems without sharing a secret between them.

Send structured parameters

Typed parameters, including nested objects, so the agent sends a body your endpoint actually accepts. JSON, form fields or multipart, whichever your API expects.

Map the response

Point the agent at the fields that matter in the response so it quotes the delivery date rather than dumping raw JSON at your customer.

Test before you ship

Run an action against the real endpoint from the dashboard and see the actual response. You find out it works before a customer does.

How to set one up

  1. 01

    Describe the endpoint

    Give the action a name, a method and a URL, then add its parameters and headers. Tell the agent in plain language when it should be used.

  2. 02

    Add its credentials

    Choose bearer, API key or basic auth and paste the credential. It is stored against that one action, not shared across the agent.

  3. 03

    Test it, then publish

    Run it from the dashboard against your live endpoint. When the response looks right, the agent starts using it in real conversations.

Agent Actions in depth

The difference between answering and doing

A support agent trained only on your documentation can tell a customer what your refund policy is. It cannot tell them whether *their* refund has been processed. That second question is the one people actually ask, and it is the one that ends in a support ticket.

An action closes that gap. You describe one endpoint you already own, the agent works out when a question needs it, extracts the parameters from what the customer said, calls it, and answers from the response. The agent is not guessing. It is reading your system, at the moment it is asked.

This is what separates deflection from automation. A chatbot that deflects sends people to a help article. A chatbot with actions resolves the thing they came for and closes the conversation.

Any endpoint, not a fixed list of integrations

Most platforms give you a catalogue of integrations and you get what is in the catalogue. Actions invert that. If your system has an HTTP API, the agent can call it, whether that is a Rails monolith, an internal microservice, a legacy PHP endpoint, or a third-party product nobody has heard of.

You get all five methods (GET, POST, PUT, PATCH and DELETE), custom headers, and typed parameters including nested objects. Bodies can be encoded as JSON, form fields or multipart, which matters more than it sounds: plenty of older systems still expect form encoding and will reject a JSON body outright.

Authentication is configured on the action, not on the agent. Bearer token, API key, basic auth, or nothing at all. One agent can hold a read-only key for your orders service and a separate, narrower key for your billing service, and neither can be used to reach the other.

GET, POST, PUT, PATCH and DELETE, with JSON, form-encoded or multipart bodies. Authentication is set per action, not per agent, so one agent can hold a read-only key for your orders service and a narrower one for billing.

Pre-built actions for the tools you already run

Not everything needs to be wired by hand. Connect Calendly and your event types are pulled in as a dropdown, so booking a meeting from inside a conversation is a few clicks rather than an API contract. Connect HubSpot and your real pipelines, ticket stages and priorities appear the same way.

The custom-action builder and the pre-built ones are the same machinery, so you can start with a connected tool and drop down to a raw endpoint the moment you outgrow it. See the full list on the integrations page.

Calendly and HubSpot connect over OAuth, and your real event types, pipelines, ticket stages and priorities are pulled in as options. The custom builder and the pre-built ones are the same machinery.

What it costs and what to watch

Actions are included from the Basic plan upward, with the number of actions per agent rising by tier and becoming unlimited on Business. See pricing for the current limits.

Two things are worth thinking about before you expose a write endpoint. First, scope the credential: give the action the narrowest key that lets it do its job, because an agent with a broad admin token is an agent that can do broad admin things. Second, if the action can act on a specific customer record, pair it with verified user identity so the agent knows the person asking is genuinely that customer, rather than someone who typed their email address into a chat box.

Actions start on the Basic plan and are unlimited on Business. Give each action the narrowest credential that does its job, and pair anything account-specific with verified user identity.

Frequently asked questions

What is an agent action?

An action is a description of one HTTP endpoint you own: its method, its URL, its parameters, its headers and its credentials. Once you add it, the agent can decide on its own when a question requires that endpoint, fill in the parameters from the conversation, call it, and answer from the response.

Can the agent change data, or only read it?

Both. Actions support GET, POST, PUT, PATCH and DELETE, so an agent can cancel a subscription, update an address, apply a refund or open a ticket, not just look things up. You control exactly which endpoints it is given.

Do I need an API for this to work?

You need an HTTP endpoint the agent can reach. It does not need to be a public or a purpose-built API. Any REST endpoint you already have works, and older APIs that expect form-encoded bodies rather than JSON are supported.

How is the action authenticated?

Per action, not per agent. Each one carries its own credentials: a bearer token, an API key, basic auth, or none. That means a single agent can talk to several systems without any of them sharing a secret with the others.

Can I test an action before customers see it?

Yes. You can run an action from the dashboard against your real endpoint and inspect the actual response before the agent ever uses it in a live conversation.

How many actions can one agent have?

It depends on your plan. Actions start on the Basic plan, the limit rises on Pro, and Business has no cap. The current numbers are on the pricing page.

Keep exploring

Give your agent something to do

Connect one endpoint and watch the agent resolve a question it could only have deflected before.