Skip to main content

HTTP Request

Use this action when you need to call an external API or webhook from a workflow or agent action.

Best for

  • Sending data to external systems
  • Fetching information before later steps continue
  • Downloading files for later storage or messaging steps

Main fields

FieldWhat it does
MethodChooses the HTTP method, such as GET or POST
URLThe target endpoint
HeadersAdds custom request headers
BodySends data for methods like POST or PATCH
Return as bufferReturns raw file data instead of text or JSON
Enable cacheReuses identical responses inside the same run when possible

What later steps can use

Request results are usually available at:

  • step(N).status
  • step(N).data
  • step(N).headers

Tips

  • Store API keys and other sensitive header values as secrets instead of plain text.
  • Use buffer mode when the response is a file, image, or PDF.
  • Check the status code before assuming the request succeeded.