Skip to content

Integration Actions ​

Integration actions let your agent reach another system: call an external API, or read and write a Google Sheet. Like every action, you attach them to the AI Agent's Action port, and the agent decides when to call them during a conversation, guided by the Instruction you write on each one.

NodeWhat it doesBest for
HTTP RequestCalls an HTTP API as a tool. You fix the URL. For the method, body, headers and authentication, you either specify them or let the AI fill them in per call.Looking something up or triggering something in a service you already have, such as an order API, a webhook, or a partner endpoint.
Google SheetsAdds, finds, reads, updates or deletes rows in one of your spreadsheets.Capturing leads, logging outcomes, or looking a person up in a sheet your team already works in.

Both carry the shared Tool Name (optional) and Instruction (required) fields described in Messaging actions.

Integration action vs. Integration sub-node

An HTTP Request action is one endpoint you configure yourself. An Integration sub-node connects a whole integration at once, and the actions you enable from it become tools the agent can call. Reach for HTTP Request for a single, simple API. For a set of related, reusable operations on your own systems, an Integration is the better fit.


HTTP Request (action) ​

The HTTP Request action: Tool Name, Instruction, and the Endpoint section with URL, a fixed GET method, no body, and AI-decided headers.

FieldWhat it doesOptionsDefaultShown when
Tool NameHow the AI refers to this tool. Blank → derived from the node label.
InstructionTell the AI WHEN to call this tool, WHAT inputs/payload to pass, and WHAT it returns — so it can decide whether and how to use the action. Blank → a generic default for the action.
Endpoint

The Endpoint section decides which parts you fix and which the AI fills in on each call:

FieldChoicesWhat it does
URL (required)—The endpoint, for example https://api.example.com/v1/orders/. Supports {{ variables }}. Internal or private network addresses are blocked.
MethodAI decides · FixedThe AI picks the HTTP method per call, or you set a Fixed method (GET, POST, PUT, PATCH, DELETE, HEAD).
PayloadAI decides the whole payload · Specify fields · Raw body · No bodyHow the request body is built. Specify fields gives one row per JSON key, each Fixed, a {{variable}}, or From AI. Raw body is a literal body (JSON or text) that supports variables.
HeadersAI decides all headers · Specify headersThe AI supplies the headers, or you list them one per row (fixed, variable, or from the AI).
AuthAI decides · SpecifyWith Specify, pick an Auth scheme: None, Bearer token, API key (header) (with an API key header name, default X-API-Key), or Basic (user:password). Then set the Auth secret as a fixed value, a variable, or from the AI.
Timeout (ms)—Maximum wait for a response. Default 30000, maximum 120000.

The API's response comes back to the agent as the tool result, and the agent uses it in its reply.

Secrets stay secret. A fixed Auth secret, and the fixed value of any credential header (Authorization, or a header named like an API key, token, secret or password), is stored encrypted. Once saved it reads Secret set — stored encrypted, not shown with Replace — there's no Generate or Rotate, because the value comes from the service you're calling. Renaming such a header clears its value so you re-enter it. Secrets are left out of copies, exports and templates, and masked in run logs and wherever the API echoes them back.

Example: order status lookup. Tool Name get_order_status. Instruction "Look up an order by its order number when the customer asks where their order is. Returns the order status and delivery date." URL https://api.example.com/v1/orders/. Method Fixed → GET. Payload No body. Auth Specify → Bearer token with your token as a fixed secret.

HTTP Request as a flow step ​

There's also an HTTP Request step in the node picker's Data group. It's a deterministic call that runs every time the flow reaches it, rather than when the agent decides. Its fields are simpler, and it stores the response in a variable for later steps.

Fields (flow step) ​

FieldWhat it does
URLThe endpoint to call, e.g. https://api.example.com/v1/orders. Supports {{ variables }} from earlier steps, so you can build the URL dynamically. Internal / private network addresses are blocked.
MethodGET, POST, PUT, PATCH, DELETE, or HEAD. Defaults to POST.
HeadersFixed request headers, entered as key/value pairs. Values support {{ variables }}.
AuthHow the request authenticates — see the auth options below.
BodyThe request body (JSON or plain text). Shown only for write methods — POST, PUT, and PATCH. Supports {{ variables }}.
Timeout (ms)How long to wait for a response before giving up. Defaults to 30000 (30 s); maximum 120000 (2 min).
Output VariableThe variable name where the response is stored for later steps. Defaults to __http_response__.
Accepted statusesWhich response statuses count as success, e.g. 200-299, 404. Default 200-299. Any other status marks the step as an error (the run shows Completed with errors) but the response is still passed on. See HTTP Request Node.

Authentication (flow step) ​

The Auth dropdown has four choices. Picking anything other than None reveals an Auth secret field where you enter the credential. It's stored encrypted and never shown again — use Replace to change it.

AuthWhat you enterHow it's sent
None—No authentication header is added.
Bearer tokenThe tokenSent as a standard bearer authorization header.
API key (header)The API keySent in a request header. A separate API key header field lets you name the header (default X-API-Key).
Basic (user:password)user:passwordSent as HTTP Basic authentication.

The response you capture (flow step) ​

The call's result is written to your Output Variable as a small object with these parts:

PartMeaning
statusThe HTTP status code returned (e.g. 200, 404).
oktrue for a 2xx status, false otherwise.
bodyThe response body returned by the service.
headersThe response headers.

Later steps read these with {{ ... }} references — for example, a Condition (IF/ELSE) node can branch on whether the call was ok, and an AI Agent node can use body in its reply. See Data & Variables for how variables flow between steps.

Example — check an order, then reply ​

  1. Add an HTTP Request step (from the Data group) after your trigger.
  2. URL: https://api.example.com/orders/ (pulling order_id from an earlier step).
  3. Method: GET.
  4. Auth: Bearer token, and paste your token into Auth secret.
  5. Output Variable: leave it as __http_response__ (or name it order).
  6. Wire the node into an AI Agent node that reads {{ order.body }} to answer the customer.

Google Sheets (action) ​

The Google Sheets action works with one of your spreadsheets through your own connected Google account. Connect an account once on the Connections page first. The setup (your Google OAuth app, the two required APIs, connecting) is covered in Google Sheets provider setup.

The Google Sheets action: Instruction, "What this node does" set to Add a row, and the Destination pickers.

Options ​

Each Google Sheets node does one operation. Wire a second node if the agent needs to both write and look up. The three destination pickers (Google connection, Spreadsheet, Tab) all read live from your connected account, so you never paste a raw ID.

FieldWhat it doesOptionsDefaultShown when
Tool NameHow the AI refers to this tool. Blank → derived from the node label.
InstructionTell the AI WHEN to call this tool, WHAT inputs/payload to pass, and WHAT it returns — so it can decide whether and how to use the action. Blank → a generic default for the action.

Operation ​

FieldWhat it doesOptionsDefaultShown when
What this node doesAdd a row (the original behaviour), look rows up by a column value, or read rows back. One operation per node — wire a second Google Sheets node if the agent needs both.Add a row · Add several rows at once · Add a row, or update the person if they are already there · Update an existing row · Find rows by a column value · Read rows · Blank a row’s values (keeps the row) · Delete a row entirely · Add a tab to this spreadsheet · Create a new spreadsheetappend_row

Destination ​

FieldWhat it doesOptionsDefaultShown when
Google connectionWhich connected Google account this node uses. Connect one at Connections (Add → Google Sheets) first.
SpreadsheetPick from the spreadsheets in the connected account — no manual ID needed.
TabThe worksheet/tab this node works on.Sheet1

Row ​

FieldWhat it doesOptionsDefaultShown when
How to fill the rowLet the AI decide: it captures the fields named in your prompt (e.g. "save name, email, and enquiry") and writes a row — the sheet's header row defines the columns (created/extended automatically). Map columns: define each column yourself (From AI / Fixed value / workflow Variable).Let the AI decide (recommended) · Map specific columnsautoWhat this node does is Add a row
ColumnsOne row per sheet column (left→right). Each value is captured From AI in the chat, a Fixed value, or a workflow Variable. Use “Load columns from sheet” to pull the header row.How to fill the row is Map specific columns; What this node does is Add a row

Lookup ​

FieldWhat it doesOptionsDefaultShown when
Match on columnThe header that identifies a person or record — e.g. "phone" or "Email". For Find it is what gets searched; for Update and Add-or-update it is the KEY the row is located by. Leave blank only for Find, to let the AI choose the column at call time.What this node does is Find rows by a column value or Update an existing row or Add a row, or update the person if they are already there or Delete a row entirely or Blank a row’s values (keeps the row)
Max rows to returnUpper bound on rows handed back to the AI (1-500). Large results are also trimmed to fit the model tool-result budget - whole rows are dropped and the reply reports how many.50

Advanced ​

FieldWhat it doesOptionsDefaultShown when
If a value starts with “=”Store it as text (recommended). A value beginning with “=” is a FORMULA to Google Sheets, and cells the AI fills come from what the customer typed — so “=IMPORTRANGE(...)” in a chat could otherwise run inside your spreadsheet. Dates, numbers and phone numbers are unaffected either way.Store it as text (recommended) · Let it act as a spreadsheet formulaescape

Operations group as: Write (Add a row · Add several rows at once · Add a row, or update the person if they are already there · Update an existing row), Read (Find rows by a column value · Read rows), Destructive — only wire these deliberately (Blank a row’s values (keeps the row) · Delete a row entirely), and Structure (Add a tab to this spreadsheet · Create a new spreadsheet).

Example: log a captured lead ​

  1. Add a Google Sheets action to the agent's Action port.
  2. Instruction: "Save the caller's name, email and enquiry as a new lead once they've shared them."
  3. What this node does: Add a row.
  4. Google connection, Spreadsheet, Tab: pick them from the lists.
  5. How to fill the row: leave Let the AI decide. The name, email and enquiry become the sheet's columns automatically. If you want strict columns, switch to Map specific columns and click Load columns from sheet.

Google Sheets as a flow step (read-only) ​

There is also a separate read-only Google Sheets flow step that loads rows from a sheet into a workflow variable on every run, without needing an agent to call it — the same relationship HTTP Request as a flow step has to the HTTP Request action. It isn't offered in the node picker.

Source ​

FieldWhat it doesOptionsDefaultShown when
Google connectionWhich connected Google account to read from.
SpreadsheetPick from the spreadsheets in the connected account.
TabThe worksheet/tab to read.Sheet1

Filter ​

FieldWhat it doesOptionsDefaultShown when
Only rows where columnLeave blank to read the whole tab.
equalsThe value to match. Use {{ variable }} to take it from an earlier step.
Max rowsUpper bound on rows written to the variable (1-500).50

Output ​

FieldWhat it doesOptionsDefaultShown when
Store rows inWorkflow variable the rows land in for downstream nodes.sheet_rows

See also ​