Webhook Notifications

Create a webhook endpoint

Create a new webhook endpoint for the organization. Returns the signing secret (shown only once). Maximum 5 endpoints per organization. Outbound URL rules: the URL must be https and must point at a publicly reachable host. Credentials in the URL, single-label or internal host names (localhost, *.local, *.internal, *.home.arpa), and hosts that are or resolve to loopback, private (RFC1918), link-local (including cloud metadata), CGNAT, IPv6 unique-local/link-local, or other non-public addresses are rejected with 400. The host is resolved and re-checked again before every delivery and every redirect hop.

post/orgs/{org_id}/webhooks

Request

  • Base URL: https://api.mnemom.ai/v1
  • URL: https://api.mnemom.ai/v1/orgs/{org_id}/webhooks
  • Auth: HTTP bearer

Path parameters

org_idstring required

Organization identifier (e.g. org-abc12345)

Request body

urlstring uri required

HTTPS URL that will receive webhook POST requests

descriptionstring

Human-readable description of this endpoint

event_typesstring[]

Event types to subscribe to. Empty array means all events. See the webhook event catalog for the full list and per-event payload schemas.

Response

Webhook endpoint created. Response includes signing_secret (shown only once).

endpoint_idstring

Unique identifier (whe-xxxxxxxx)

billing_account_idstring
urlstring uri
descriptionstring
signing_secretstring

32-byte hex-encoded HMAC signing secret. Only returned on creation and rotation.

event_typesstring[]

Subscribed event types. Empty array means all events.

is_activeboolean
consecutive_failuresinteger
disabled_atstring date-time nullable
disabled_reasonstring nullable
created_atstring date-time
updated_atstring date-time

Changes

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