Company Publishing
Webhooks

Create a Workspace post-event subscription

Changed on

Agency Workspace settings managers only. Personal webhook endpoints do not access Company subscriptions.

post/company/webhooks

Request

  • Base URL
    https://api.publora.com/api/v1
  • Auth
    API key in header x-publora-key

Headers

x-publora-clientstring

Optional client identifier accepted by every API-key-authenticated operation. Any non-empty value is preserved; api is used when absent. Setting mcp triggers the MCP access entitlement check.

X-Publora-Workspace-Idstring required

Exact accessible Company Workspace ID returned by Company context.

Idempotency-Keystring required

Stable key. After an uncertain response retry the identical body and key; use a new key for a new intended operation.

Request body

namestring

Trimmed, nonempty subscription name.

urlstring uri

Trimmed public HTTP(S) URL. Private/local destinations are refused and DNS is checked again at delivery. Redirects are not followed.

eventsstring[]
isActiveboolean

Defaults to true on create; unchanged when omitted on update. Enabling resets the failure count.

Response

Successful Workspace-scoped response. Mutation and idempotent response snapshot commit together; identical retries return the original result.

successtrue required

Changes