Skip to main content

HTTP Request

HTTP Request sends a request to an external system and records the result.

Use it when the workflow must call an API, send a webhook-style notification, update an external tool, or ask another system to perform work.

Settings​

HTTP Request Builder configures request, credentials, retry behavior, and body.

Request settings:

  • Method: GET, POST, PUT, PATCH, or DELETE.
  • URL: Supports Liquid variables.
  • Timeout: Request timeout in milliseconds. The maximum is 60000 ms.
  • Query Parameters: Key/value rows. Values support Liquid variables.
  • Headers: Header/value rows. Values support Liquid variables.
  • Body Mode: None, JSON, or text.
  • Body Template: JSON or text body. Liquid variables are supported.

Credentials:

  • Auth Credential: At most one auth credential. Supported auth types are basic auth, bearer token, and API key.
  • Signing Credential: At most one signing credential. Signing uses HMAC credentials.

Retry settings:

  • Enable retries: Turns retry behavior on.
  • Max Attempts: 1 to 5.
  • Retry Strategy: Constant, Linear, or Exponential.
  • Retry Delays: Comma-separated durations such as 1s, 5m, or 2h. Each retry delay must be 7 days or less.
  • Retry on network errors.
  • Retry on timeouts.
  • Retry on HTTP Statuses: Defaults to 408, 429, 500, 502, 503, and 504.

Outputs​

HTTP Request exposes two routes:

  • Success
  • Failure