fswa_webhook_payload

Filters the per-webhook outgoing payload after field mapping, immediately before HTTP dispatch.

/ Signature

apply_filters( 'fswa_webhook_payload', $payload, $webhook_id, $trigger, $original_payload )

/ When it fires

Fires once per webhook delivery, after field mapping and type casting but before the HTTP request is sent. Also fires during synchronous dispatch and queue job execution.

/ Parameters

Name	In	Type	Req	Description
$payload	param	array	yes	The mapped payload about to be dispatched.
$webhook_id	param	int	yes	Webhook configuration ID.
$trigger	param	string	yes	The WordPress action name.
$original_payload	param	array\|null	—	Pre-mapping payload, or `null` if no mapping was applied.

/ Returns

array Modified payload. Must remain an array.

/ Examples

Inject site URL and current time into every delivery

add_filter( 'fswa_webhook_payload', function ( $payload, $webhook_id, $trigger, $original ) {
    $payload['_meta'] = [
        'site'      => home_url(),
        'sent_at'   => gmdate( 'c' ),
        'webhook'   => $webhook_id,
    ];
    return $payload;
}, 10, 4 );

Modify payload only for a specific webhook

add_filter( 'fswa_webhook_payload', function ( $payload, $webhook_id, $trigger, $original ) {
    if ( $webhook_id !== 42 ) return $payload;
    // Rename a field for this webhook only
    $payload['contact_email'] = $payload['billing_email'] ?? '';
    unset( $payload['billing_email'] );
    return $payload;
}, 10, 4 );

/ Related

fswa_payload Payload Mapping Code Glue

Ready

Stop losing webhooks.
Start logging them.

Install Plugin→ See the Plugin →

$ wp plugin install flowsystems-webhook-actions --activate