Payload
The data carried by a webhook or API call. When a client fills your contact form, the webhook payload contains their name, email, message, and metadata. Your automation parses this payload to trigger the right actions.
Expert insight
The payload a webhook actually sends often differs from what its documentation describes, especially for optional fields that are simply omitted rather than sent as null when empty. Workflows that assume a field will always be present in the payload break the first time a real-world event doesn't include it.
In a real workflow
The Stripe webhook payload contains the event type and the object, such as the invoice that was paid.
Common mistakes
- Logging full payloads that contain personal or payment data.
- Assuming payload structure never changes.
Complexity level
Anyone can understand this no technical background needed.
Related terms
Webhook
A real-time HTTP notification sent from one app to another when an event occurs.…
JSON (JavaScript Object Notation)
The universal data format for APIs and webhooks. When Stripe sends a payment eve…
API (Application Programming Interface)
A set of rules that allow two software applications to communicate. Most automat…
See it in action
Want Payload built into your automation?
Book a free audit and we'll show you exactly how this applies to your business.
Get my free automation plan →Who we build for
Run a firm, an agency or an online store? We automate the work behind it.
Done-for-you n8n workflows and Claude AI agents, fixed price, maintained for you.
- Professional firms Onboarding, documents, billing and reporting run on their own. See what we automate →
- Agencies and SaaS teams Custom n8n and Claude builds, client reporting and internal tools. See what we automate →
- E-commerce brands Orders, support, returns and stock handled without the busywork. See what we automate →
More in Core concepts
Keep exploring
Polling
Checking an external service for changes at regular intervals (e.g., "…
REST API
The most common API architecture. Uses standard HTTP methods (GET, POS…
RPA (Robotic Process Automation)
Software robots that mimic human actions in a UI clicking buttons, cop…
Router node
A workflow step that splits execution into multiple paths based on con…
Trigger
The event that starts an automation. Common triggers: form submission,…
Workflow template
A pre-built automation that can be imported and customised. PURIST's W…
Go deeper
Guides that cover Payload
$env and Credentials in the n8n Code Node: What Works and What Doesn't
The n8n Code node can read environment variables and custom variables, but never stored credentials. What to use instead, and how to fix "access to env vars denied".
Fix n8n "The requested webhook is not registered" (Test and Production)
The 404 "webhook is not registered" error almost always means the URL and the workflow state do not match. Five causes and the exact fix for each, test and production.
n8n Webhook URL: Test vs Production, and How to Change It
Every n8n Webhook node has two URLs. When to use each, how to set a clean path, and how to make self-hosted n8n show your real domain instead of localhost.