Skip to main content
Limited Release
This action is in limited release and is not generally available.

Perform an HTTP Request

The Perform an HTTP Request action calls external APIs and webhooks, then stores the response for later workflow steps.

When to Use This Action

  • You need to call a REST endpoint that does not have a dedicated workflow action
  • You want to send a GET, POST, PUT, or DELETE request
  • You need to send request headers, query parameters, or a POST/PUT body

Configuration

Personality / Credential / Call

FieldDescription
API PersonalityOptional. Select a personality to preconfigure authentication and base URL.
CredentialCredential used by the selected API Personality.
API MethodOptional predefined method from the selected personality.
PathCustom path appended to the personality base URL when no API Method is selected.
HTTP MethodThe request method: GET, POST, PUT, or DELETE.
AcceptsAccept header value used for the request.
URLFull https:// URL for direct-call mode (when no API Personality is selected).

Inputs

FieldDescription
Method ParametersDynamic parameters for a selected API Method.
Querystring PropertiesKey/value pairs added to the URL query string.
Request HeadersCustom HTTP headers sent with the request.
POST Body TypeFor POST requests only. Choose JSON or FORM encoding.
POST Body FieldsFor POST requests only. Key/value pairs used as JSON properties or FORM fields.
PUT Body TypeFor PUT requests only. Choose JSON or FORM encoding.
PUT Body FieldsFor PUT requests only. Key/value pairs used as JSON properties or FORM fields.

Result Handling

FieldDescription
Response FormatChoose how the response is stored: decoded body, raw body string, or full response object.
Error HandlingChoose what the workflow should do when the remote service returns an error.

Example: JSON POST Body

Set these values:

  • HTTP Method: POST
  • POST Body Type: JSON
  • POST Body Fields:
    • id => {{custom.foo}}
    • domain => {{email.from.address}}
    • notify => true

This sends a JSON body equivalent to:

{
"id": "{{custom.foo}}",
"domain": "{{email.from.address}}",
"notify": "true"
}

Returned Variables

If you set Store the results in Variable, this action returns one of the following based on Response Format:

  • Decoded response body object
  • Raw response body string
  • Full response object including status code, headers, and body

Availability

This action is currently limited release.