Webhook Context Variables and Methods Reference

A number of context variables and methods are available for use in webhook scripts. View suggestions while editing the match script or function editing windows by typing Ctrl + Space. These variables and methods are described below.

Incoming Context Variables

NameDescription
FLX_MESSAGE_IDUnique id for the incoming webhook message
FLX_PRISTINE_PAYLOADPristine (untouched) payload from the sender. Use this payload when generating hmac strings
FLX_REMOTE_ADDRRemote address of the incoming request. If using a reverse proxy, this will be the address of the proxy, NOT the address of the original sender. A reverse proxy will typically pass the original sender address as a new header 'x-forwarded-for'.
FLX_REMOTE_HOSTRemote host of the incoming request. If using a reverse proxy, this will be the host of the proxy, NOT the host of the original sender.
HTTP_HEADERSMap of the incoming request headers. See 'Accessing Map Values' below.
PAYLOAD

Map of incoming payload. See 'Accessing Map Values' below.

If the webhook payload cannot be converted to JSON, it will be passed as a simple string

QUERY_PARAMSMap of the incoming request query parameters. See 'Accessing Map Values' below.

Outgoing Context Variables

NameDescription
EVENTThe Event payload for the Outgoing Webhook. For more information see Events

Accessing Map Values

Map Values can be accessed a number of ways. Here are a few common ones:

  • HTTP_HEADERS['header-key-with-dash']
  • QUERY_PARAMS.paramWithNoDash
  • PAYLOAD.get('key')
  • EVENT.payload.workflowExecutionId

Function Classes (Incoming Webhooks)

ClassDescription
FLEXDEPLOYFunctions for performing actions in FlexDeploy
HMACFunctions for generating an hmac string
LOGFunctions for printing log messages
GITHUBFunctions for getting information from a GitHub payload
BITBUCKETFunctions for getting information from a Bitbucket payload
SLACKUtility functions for interacting with Slack
GITLABFunctions for getting information from a GitLab payload
BITBUCKET_SERVERFunctions for getting information from a Bitbucket Server payload
AZUREFunctions for getting information from an Azure Git payload. Available @since 5.4.0.4

Function Classes (Outgoing Webhooks)

ClassDescription
FLEXDEPLOYFunctions for performing actions in FlexDeploy
EMAILFunctions for formatting and sending emails
LOGFunctions for printing log messages
RESTObject exposing REST functions. For more info see Using the REST object.
MICROSOFTTEAMSFunctions for formatting and sending Teams messages
SLACKFunctions for formatting and sending Slack messages