v2 Webhooks

Register a webhook (signing secret is shown once)

EP-023-T10. The server generates a signing secret whsec_… (returned ONCE), used to sign deliveries (X-P2M-Signature). url must be https and public (SSRF-guard). events — filter (empty = all). 403 if the tier has no webhooks_enabled or the tier's endpoint limit is reached.

post/api/v2/webhooks

Request

  • Base URL: https://pdf2md.dev
  • URL: https://pdf2md.dev/api/v2/webhooks
  • Auth: one of:
    • API key in cookie p2m_session
    • HTTP bearer

Request body

urlstring uri required

https, public host (SSRF-guard)

eventsstring[]

empty = subscribe to all events

descriptionstring

Response

Created

idstring uuid required
urlstring uri required
eventsstring[] required

subscribed events; [] = all

descriptionstring
enabledboolean required
failure_countinteger

consecutive failed exhausted deliveries

last_delivery_atstring date-time nullable
created_atstring date-time
secretstring required

Signing secret (whsec_…) for X-P2M-Signature — shown ONCE

Changes

No recorded changes to this operation across all 1 revision of this API.