Webhook Parameters - Mapping Webhook Payload Fields
When configuring a webhook:
-
The automation's trigger step may include an Example Output, which defines the expected data structure for subsequent steps.
-
In rare cases, the webhook payload sent by the third-party system does not match the format expected by Playblocks.
-
Use Webhook Parameters to map fields from the incoming webhook payload to the fields defined in the Example Output:
Note:If mapping is not defined, the system assumes identical field names as shown in the example output.
-
Mapping ensures that the automation receives the correct data in the correct format.
-
Example Scenario
-
The Example Output includes a field named file_sha1.
-
A later step in the automation relies on this field.
-
The third-party system sends a payload in these format:
{ "data": { "sha1": "7041b2e3f978a9e1d3e073c486647eb06fa00ce5" } }
-
-
Since the incoming payload uses a different structure and field name, create a mapping so the automation receives the value in the expected file_sha1 field.
-
Steps to Create a Mapping
-
Go to Webhook Parameters in the webhook configuration.
-
Map the incoming field (data.sha1) to the expected field (file_sha1).
-