Flow.Documentation
ProfessionalAI Colleagues and knowledge

Building block: HTTP call

6 steps± 4 minVideoVerified 22 Oct 2026
  1. Step 1 · Open your development environment
  2. Step 2 · Create an HTTP call
  3. Step 3 · Set up the call
  4. Step 4 · Test with an order number
  5. Step 5 · Publish a version
  6. Step 6 · Give it to an agent

An HTTP call is a building block that calls one API, for example the order status at a supplier. You make it once, test it and publish it; after that workflows use it as a step and agents as a tool. The API's key lives in a connection: the server adds it, the building block and the agent never see it.

Watch the whole guide as a video6 steps in one film
Step 1 / 6

Open your development environment

In the portal, under Environments, click Development, and there Open. Flow opens in a new tab and you are signed in straight away.

  1. Click Development
Open your development environment · Click Development
  1. Click Open ↗
Open your development environment · Click Open ↗
Step 2 / 6

Create an HTTP call

Click ＋ next to General and choose HTTP call. Under Definition, give it a name and a description: an agent reads that description to decide when to use the tool. Add an input field for the order number.

  1. Click Add to General
Create an HTTP call · Click Add to General
  1. Click HTTP call
Create an HTTP call · Click HTTP call
  1. In Name, type Order status at partner
  2. In Description, type Looks up the status of an order at the partner, by order number.
Create an HTTP call · In Name, type Order status at partner; In Description, type Looks up the status of an order at the partner, by order number.
  1. Click ＋ Input field
Create an HTTP call · Click ＋ Input field
  1. In Name, type order
Create an HTTP call · In Name, type order
Step 3 / 6

Set up the call

Under Request, choose the connection to the partner. The URL field then becomes the path after the connection's base address. {{input.order}} puts the order number from the input into the path. Save the draft.

  1. Click Request
Set up the call · Click Request
  1. In Connection, choose Partner portal · http://127.0.0.1:62354/partner
  2. In Path, type /orders/{{input.order}}
Set up the call · In Connection, choose Partner portal · http://127.0.0.1:62354/partner; In Path, type /orders/{{input.order}}
  1. Click Save draft
Set up the call · Click Save draft
Step 4 / 6

Test with an order number

Under Test, give sample input and click Run test. The test really calls the API, exactly as a workflow or agent will later. You see the partner's answer, and in the logs the call with its status code.

  1. Click Test
Test with an order number · Click Test
  1. Click Code
Test with an order number · Click Code
  1. In Input, type {"order": "1042"}
Test with an order number · In Input, type {"order": "1042"}
  1. Click ▷ Run test
Test with an order number · Click ▷ Run test
Test with an order number · Passed, with the duration.
Test with an order number · In the logs: GET …/orders/1042 → 200.
Step 5 / 6

Publish a version

Happy? Publish a fixed version. Workflows and agents keep using that version until you choose a new one; what you change afterwards stays a draft.

  1. Click Publish version →
Publish a version · Click Publish version →
Publish a version · Version v1 is published and active.
Step 6 / 6

Give it to an agent

Open an agent. Under Brain → Tools are all published building blocks; tick the HTTP call and save. A GET counts as Reads; a call that changes something (POST, PUT, DELETE) is only offered once you allow writing in the guard rails.

  1. Click Agents
Give it to an agent · Click Agents
  1. Click the agent ‘Order helper’
Give it to an agent · Click the agent ‘Order helper’
  1. Click Order status at partner
Give it to an agent · Click Order status at partner
  1. Click Save
Give it to an agent · Click Save
Give it to an agent · The building block is on as one of the agent's tools.

This guide was carried out step by step on 22 Oct 2026 by an automated test on Flow (version 3e563176).