---
title: "Subscribe a URL to workflow events — for yourself, the organization, or one unit (and the units inside it). Payloads are value-free."
method: POST
path: "/api/v1/webhooks"
tags: ["Organizations"]
---

# Subscribe a URL to workflow events — for yourself, the organization, or one unit (and the units inside it). Payloads are value-free.

`POST /api/v1/webhooks`

## Request

- Base URL: `https://philforms.com`
- URL: `https://philforms.com/api/v1/webhooks`
- Auth: HTTP bearer

## Request body

- object
  - `url` string, required
  - `event` string[]: "*" or: fill.completed, fill.rejected, capture.completed, batch.completed, schedule.ran, draft.submitted, draft.approved, draft.returned, member.joined, member.removed, key.created, key.revoked, key.rotated, policy.updated
  - `format` 'json' | 'slack': json = signed event (X-PDFPhile-Signature); slack = { text } for Slack / Google Chat / Teams incoming webhooks
  - `unit_id` string

## Response `201`

{ webhook (with secret) }

---

[API](https://skmtc.dev/philforms/apis/philforms-api.md) · [All operations](https://skmtc.dev/philforms/apis/philforms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/philforms/apis/philforms-api/revisions/a43bf313729c?raw)