Call another system from a step
The Send HTTP request action calls another system's API.
| Field | Notes |
|---|---|
| Method | POST when left empty. |
| URL | A public https address. Private and local addresses are refused. |
| Headers | One per line, as Name: value. Values are hidden once saved, so they are safe for API keys. |
| Body | Usually JSON. You can insert trigger and step values. |
The request times out after 15 seconds, and at most 100 KB of the reply is read.
Later steps can use the reply:
| Value | What it holds |
|---|---|
{{steps.<step id>.status}} | The HTTP status code |
{{steps.<step id>.body}} | The reply as text |
{{steps.<step id>.json.<field>}} | A field of a JSON reply |
Safety rules
- Only
httpsaddresses are called. Anhttpaddress is refused when you save, with "the address must start with https://". - Private and local addresses are refused when the step runs, with "refusing to connect to non-public address", even when a public name points at one or a reply redirects to one.
- Header values are hidden once saved. Editing the step later keeps them unless you type new ones.
If the call fails
A timeout or a network error is treated as temporary: the run is tried again, up to 5 times in all. See Retries. Switch on Keep going if this step fails if the rest of the automation should carry on regardless.