nodes / builtin / core
HTTP Request
Makes a HTTP request and returns the response data
Formerly Http Request. The step was renamed in AWFlow 0.9; searching for the old name still finds it.
Call any web address or API and use the response in the next steps.
What it does
Section titled “What it does”HTTP Request sends a request (GET, POST, PUT, DELETE, PATCH, OPTIONS or HEAD) to URL, with the headers, query parameters and body you set, and returns what the server sends back.
- Authentication takes a saved connection: a bearer token, basic auth, or an API key sent in a header or in the query. The key stays out of the workflow. A connection locked to its Allowed sites is never sent anywhere else, not even after a redirect.
- Query Params are added to the URL for you, merged with any query already in it.
- Body is sent as JSON, as a URL-encoded form or as multipart form data, depending on Body Content Type.
- Redirects are followed by the browser (up to Max redirects, 5 by default) unless you turn Follow redirects off; the final address is checked again before the response is used.
- There is no time limit unless you set Timeout.
- The response is read as JSON, text or a file. Response format set to Autodetect (or left empty) decides from the server’s content type; File returns the body as a file under
$binary.data.
What the step returns
Section titled “What the step returns”New HTTP Request steps (version 2) choose under Return:
- One item per entry when the response is a list (default): a JSON list becomes one item per entry, so the next steps work on each entry. An object or a text stays one item; an empty list gives no items.
- One item per entry of a list inside the response: set Path to items, for example
data.items. - The whole response as one item:
{ data }, as older steps did.
Steps saved before AWFlow 0.9 keep returning { data }. Update in the step’s header switches them to version 2 while keeping The whole response as one item; if the last output was a list, the step suggests Split into items.
Raw JSON body
Section titled “Raw JSON body”Under Body, Write the body as offers Fields (one row per field, the default) or Raw JSON: the whole body as JSON text, sent with Content-Type: application/json. {{ }} works inside and is filled in JSON-aware: a mapped text lands quoted and escaped (a quote or a line break can’t break the JSON), numbers stay numbers. Text that isn’t valid JSON fails the step with a plain message.
Paste cURL
Section titled “Paste cURL”Paste cURL in the step’s header turns a curl command (copied from API docs or the browser’s network tools, bash or Windows style) into the step’s settings: method, URL, query, headers and body. A token, password or API key in the command becomes one connection draft, never a value in the step; save it and it is picked in the step. Unsupported options are listed as warnings.
Fetch every page
Section titled “Fetch every page”Options › Pagination fetches more pages with the same setup:
- Find the next page in: a next link (in the
Linkheader or a field of the body), a page or offset number you add to the query or the body (Parameter, Start at, Add each time), or a cursor (Field with the next cursor). - Stop when: there is no next page, the list is empty, a Status codes that stop answer comes, or a Stop expression is true.
- Return: one item per entry from every page (default), one item per page, or everything in one item. Path to the list says where the entries are.
- Max pages is 10 by default (at most 100); Wait between pages slows it down. When the limit cuts it short, a hint and the run log say so.
Under the settings, a line says what it will do: Will fetch up to 10 pages. Stops sooner when there’s no next link. For page numbers it spells out the values it sends (offset = 0, 100, 200 … 900); for a cursor, what keeps it going. After a run it adds how many entries each page had (Up to 10 pages, about 1,000 items (the last run got 100 per page)). When a run stops at Max pages while more pages exist, the Output shows an amber note (Stopped at 10 pages, the limit) with Raise to 25, and the Last run bar says more exist, with Raise.
Numbered areas in the screenshot: 1. What it will do, and what the last run got; 2. Stopped at 3 pages, the limit; 3. Raise to 25.
Errors as data
Section titled “Errors as data”By default a 4xx or 5xx answer fails the step, and the error shows the status, the status text and the start of the body. Turn on Options › Response › Never error to get the whole answer instead (status, statusText, headers, url, data) and decide yourself with an If. Network errors and timeouts still fail. With Try again automatically, a 429 or 503 with Retry-After is waited out (up to 5 minutes).
A file response (an image, a PDF, a download) arrives as binary data under the data key, ready for file uploads such as Slack File → Upload, Google Drive File → Create or Gmail attachments.
Send an idempotency key
Section titled “Send an idempotency key”Some services (payments such as Stripe, Adyen or PayPal) can ignore a request they already received, if it carries the same idempotency key. That way a retry never charges twice. In the step’s Advanced tab, turn on Send an idempotency key. It is off by default, and nothing is sent until you turn it on.
- Header name:
Idempotency-Keyby default, which most services use. Change it if your service expects another header. The key replaces a header of the same name that you set on the step. - Value sent: one key per run, step and item (shown as
run_… · Charge card · item 1). It stays the same when the step tries again (Try again automatically) and when a paused run continues. A new run gets a new key. - With pagination, only the first page’s request carries the key. The later pages go without it.
When a retry sends the request again, the run log says Item 1: sent again with the same idempotency key.
When to use it
Section titled “When to use it”- Call an API that has no dedicated node.
- Download a file or a JSON feed.
- Send data to a webhook (Zapier, Make, your own server).
For apps that have their own node, such as Slack or Notion, that node is easier. To read a web page as text, Get All Text from Link is simpler.
Inputs and settings
Section titled “Inputs and settings”| Setting | Type | What it does |
|---|---|---|
| Method | Choice | The request method to use. Options: GET, POST, PUT, DELETE, PATCH, OPTIONS, HEAD. Default: GET |
| URL (required) | URL | The address to call, e.g. https://api.example.com/items. |
| Authentication | Credential | The authentication to use to make the request. |
| Headers | Key-value pairs | The headers to send with the request. |
| Query Params | Key-value pairs | The query params to send with the request. |
| Body | Group | The body to send with the request. |
| Body › Body Content Type | Choice | Content-Type to use to send body parameters. Options: application/json, application/x-www-form-urlencoded, multipart/form-data. Default: application/json |
| Body › Write the body as | Choice | Options: Fields, Raw JSON. |
| Body › Body | Key-value pairs | The body to send with the request. |
| Body › JSON body | Code | |
| Options | Group | The options to send with the request. |
| Options › Redirects | Group | The options to send with the request. |
| Options › Redirects › Follow redirects | Toggle | When the address points somewhere else, go there instead. Default: On |
| Options › Redirects › Max redirects | Number | Browsers follow up to 20 redirects; 0 turns following off. Default: 20 |
| Options › Response | Group | The options for the response. |
| Options › Response › Include response header and status | Toggle | Whether to return the full response (headers and response status code) data instead of only the body. Default: Off |
| Options › Response › Never error | Toggle | Return 4xx and 5xx answers as normal output with status, headers and body. Offline, blocked, CORS and timeouts still fail: there’s no answer to return. Default: Off |
| Options › Response › Response format | Choice | The format in which the data gets returned from the URL. Options: autodetect, json, text, file. Default: autodetect |
| Options › Pagination | One of several shapes | Follow the next link, a page number or a cursor and fetch every page. |
| Options › Timeout | Number | How long to wait for the server to start answering before giving up. Leave empty to wait as long as it takes. |
Pagination changes shape with its How pages work choice:
3 choices · pick how pages work to see its settings
Settings for Next link
| Setting | Type | What it does |
|---|---|---|
| Find the next page in | Choice | Options: Link header (rel="next"), A field in the reply. |
| Field with the next link | Text | |
| Stop when | Choice | Options: There’s no next page, The list is empty, The reply has one of these status codes, An expression is true. |
| Status codes that stop | List | |
| Stop expression | Text | Stops when true, e.g. $response.body.has_more === false. Read the page as $response.body, $response.headers, $response.status and $page. |
| Path to the list | Text | Where the entries are in each page. |
| Return | Choice | Options: One item per entry, from every page, One item per page, Everything in one item. Default: One item per entry, from every page |
| Max pages | Number | Default: 10 |
| Wait between pages | Number |
Settings for Page number
| Setting | Type | What it does |
|---|---|---|
| Parameter | Text | |
| Send it in | Choice | Options: Query, Body (JSON). |
| Start at | Number | |
| Add each time | Number | Offset APIs: the page size. |
| Stop when | Choice | Options: There’s no next page, The list is empty, The reply has one of these status codes, An expression is true. |
| Status codes that stop | List | |
| Stop expression | Text | Stops when true, e.g. $response.body.has_more === false. Read the page as $response.body, $response.headers, $response.status and $page. |
| Path to the list | Text | Where the entries are in each page. |
| Return | Choice | Options: One item per entry, from every page, One item per page, Everything in one item. Default: One item per entry, from every page |
| Max pages | Number | Default: 10 |
| Wait between pages | Number |
Settings for Cursor
| Setting | Type | What it does |
|---|---|---|
| Field with the next cursor | Text | |
| Parameter | Text | |
| Send it in | Choice | Options: Query, Body (JSON). |
| Stop when | Choice | Options: There’s no next page, The list is empty, The reply has one of these status codes, An expression is true. |
| Status codes that stop | List | |
| Stop expression | Text | Stops when true, e.g. $response.body.has_more === false. Read the page as $response.body, $response.headers, $response.status and $page. |
| Path to the list | Text | Where the entries are in each page. |
| Return | Choice | Options: One item per entry, from every page, One item per page, Everything in one item. Default: One item per entry, from every page |
| Max pages | Number | Default: 10 |
| Wait between pages | Number |
Showing settings for Next link
Outputs
Section titled “Outputs”-
Output
With The whole response as one item, the item is { data }, the response body. Turn on Include response header and status to also get status, statusText, headers and the final url after redirects.
Dependencies and credentials
Section titled “Dependencies and credentials”- Authentication (connection): optional. See Create a connection.
Choose a connection of the kind your API expects: bearer token, basic auth (an empty password works, for keys like Stripe’s), or an API key in a header or the query. The field lists every non-sign-in connection with its kind and sites. See Add a connection.
Example workflow
Section titled “Example workflow”- A Context Menu trigger on a link.
- HTTP Request, POST to your webhook URL, Body Content Type
application/json, with a body fieldurl={{ $input.linkUrl }}. - Browser Notification: “Sent”.
Common issues
Section titled “Common issues”- “Response status: 401” or “403”. The credential is missing, wrong or lacks permission. Check the Authentication field and the key’s rights.
- “Response status: 404”. Check the URL and the query parameters.
- “URL validation failed”. The URL is malformed or not allowed. Use a full
https://address. - “Redirect blocked: …”. The request was redirected to an address that isn’t allowed (or, with a connection locked to its sites, to another site).
- Redirects off: with Follow redirects off (or Max redirects 0), a redirect fails with a clear message.
- It works in the extension but fails in the web app. Some sites refuse requests sent from another website (a browser rule called CORS). Run the workflow from the extension.
- The request times out. Set or raise Options › Timeout. Without one, the request waits as long as the server does.
- “Response is not valid JSON”. The server said JSON but sent something else; set Response format to Text to see it.
- The next step runs once per entry when you expected one item. The step splits lists (version 2). Choose The whole response as one item under Return.
Related nodes
Section titled “Related nodes”- Poll Until: call a URL repeatedly until it reports done.
- HTML Extract: pull values out of an HTML response.
- JSON: reshape a JSON response.
- HTTP Request Tool: let an AI agent make requests.