Parameters

Parameter	Description
url	Required. The full URL, with http:// or https://. Surrounding spaces are removed.
body	Optional. The request body, sent as written. Without it, an empty body is sent. The Content-Type is not set by the engine: add it with $httpAddHeader when the API needs one.

Behavior

• The request is sent and the command waits for the response (within the command execution time budget). The function itself returns an empty string: the response is kept for $httpStatus (status code) and $httpResult (body). Each new request replaces the stored response of the previous one.
• Only http:// and https:// URLs are accepted. An empty URL raises HTTP request URL cannot be empty.; any other scheme raises an error.
• Headers added with $httpAddHeader before the call are sent with this request only.
• A network failure (connection refused, DNS error, …) raises an error; an HTTP error status (404, 500, …) does not: read it with $httpStatus.

Examples

Post Webhook Notification

$httpAddHeader[Content-Type;application/json]
$httpPost[https://api.example.com/webhooks;{"event":"member_join","user":"$username"}]
$title[HTTP POST Request]
$description[Payload dispatched. Status code: **$httpStatus**]
$color[#00BCD4]