> For the complete documentation index, see [llms.txt](https://docs.notionapps.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.notionapps.com/automation/webhooks-and-integrations/webhook-technical-reference.md).

# Webhook Technical Reference

## Webhook Technical Reference

This page is for makers and technical admins who need to connect NotionApps automation to an external system.

### Outbound webhook pattern

An outbound webhook sends data from NotionApps to another system.

Recommended payload fields:

* event name
* app id or app name
* workflow name
* source record id
* source record title
* requester
* status
* timestamp
* fields required by the receiving system

### Inbound webhook pattern

An inbound webhook starts or updates work in NotionApps from another system.

The receiving workflow should validate required fields before creating user-visible work. Missing data should create an exception rather than a silent failure.

### Security rules

* Do not put secrets in user-facing messages.
* Use a secure endpoint.
* Verify signatures or shared secrets when available.
* Limit the payload to fields the destination needs.
* Treat failed delivery as an exception.

### Testing

1. Send a test payload.
2. Confirm NotionApps receives or sends the expected data.
3. Confirm Workflow Status or Linked App Exchange shows success.
4. Send a bad payload deliberately.
5. Confirm Exception Resolution explains the problem.