---
title: "Payload Mapping"
description: "Rename, restructure, or exclude fields in the outgoing JSON before dispatch using dot-notation paths."
url: "https://wpwebhooks.org/docs/payload-mapping/"
---

[WP Webhooks](https://wpwebhooks.org/) / [Docs](https://wpwebhooks.org/docs/) / Payload Mapping

Feature since v1.0.0

# Payload Mapping

Rename, restructure, or exclude fields in the outgoing JSON before dispatch using dot-notation paths.

Configure field mappings per webhook+trigger in the admin panel. Each mapping maps a source dot-notation path (e.g. `args.0.billing_email`) to a target path (e.g. `customer.email`). Fields not in a mapping can be passed through or excluded. Type casting (number, string, boolean, stringify) is supported on each mapped field.

## Dot-notation paths

Paths use dot notation to address nested fields: `args.0.line_items.0.product_id`, `user.meta.company`. Arrays are addressed by index. The field selector in the admin shows a live payload tree to build paths without guessing.

## Type casting

`number` — parses the value as float. `string` — coerces to string. `boolean` — casts truthy/falsy. `stringify` — JSON-encodes arrays or objects into a string before sending.

/ Demo

/ Related

[fswa\_webhook\_payload](https://wpwebhooks.org/docs/fswa-webhook-payload/)[fswa\_capture\_payload](https://wpwebhooks.org/docs/fswa-capture-payload/)[Code Glue](https://wpwebhooks.org/docs/code-glue/)[Conditional Dispatch](https://wpwebhooks.org/docs/conditional-dispatch/)

/Ready

## Your next automation is  
one sentence away.

[Install Plugin→](https://wordpress.org/plugins/flowsystems-webhook-actions/) [See the Plugin →](https://wpwebhooks.org/wordpress-webhook-plugin/)

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

## Structured data

```json
{"@context":"https://schema.org","@type":"TechArticle","name":"Payload Mapping — Feature — Webhook Actions Docs","description":"Rename, restructure, or exclude fields in the outgoing JSON before dispatch using dot-notation paths.","url":"https://wpwebhooks.org/docs/payload-mapping/","isPartOf":{"@type":"WebSite","name":"WP Webhooks","url":"https://wpwebhooks.org"},"about":{"@type":"SoftwareApplication","name":"Webhook Actions","applicationCategory":"WordPress Plugin"}}
```