# WebhookSubscription

[All API schemas](/api-reference/schemas/)

<code>object</code> — Additional properties rejected

| Field | Required at this level | Type | Description and constraints |
| --- | --- | --- | --- |
| <code>subscriptionId</code> | Yes | <code>string</code> | Min length: <code>3</code>; Max length: <code>160</code> |
| <code>url</code> | Yes | <code>string</code> | Format: <code>uri</code> |
| <code>eventTypes</code> | Yes | Array of <code>string</code> | — |
| <code>secretHash</code> | Yes | [Hash](/api-reference/schemas/hash/) | — |
| <code>active</code> | Yes | <code>boolean</code> | — |
| <code>maximumAttempts</code> | Yes | Constant <code>8</code> | — |
| <code>createdAt</code> | Yes | <code>string</code> | Format: <code>date-time</code> |
| <code>secretReference</code> | Yes | <code>string</code> | — |

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

Exact definition: <code>#/components/schemas/WebhookSubscription</code> in the [OpenAPI contract](/openapi/liquidity-operating-system-v2.openapi.json).