> ## Documentation Index
> Fetch the complete documentation index at: https://docs.finventi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Account Restriction Creation Failed

> Webhook notification sent when creating an account restriction fails

<Note>
  This webhook is sent when an account restriction creation request has failed.
</Note>

## Webhook Structure

<ParamField body="id" type="string (UUID)" required>
  Unique identifier for this event
</ParamField>

<ParamField body="time" type="string (ISO 8601)" required>
  Timestamp of when the event occurred
</ParamField>

<ParamField body="correlationId" type="string">
  Identifier to correlate the request with the response. Present when provided in the original request.
</ParamField>

<ParamField body="type" type="string" required>
  The type of event. Value: `account.restriction-creation-failed`
</ParamField>

<ParamField body="data" type="object" required>
  The event data containing the details below
</ParamField>

### Data Fields

<ParamField body="data.accountId" type="string (UUID)" required>
  Unique identifier of the account for which restriction creation failed
</ParamField>

<ParamField body="data.source" type="string" required>
  Restriction source. Available values: `CLIENT`, `PLAIS`
</ParamField>

<ParamField body="data.externalRef" type="string">
  External reference associated with the restriction request
</ParamField>

<ParamField body="data.errors" type="array" required>
  List of errors that caused the failure

  <Expandable title="Error object properties">
    <ParamField body="code" type="string" required>
      Error code indicating the reason for the failure
    </ParamField>

    <ParamField body="message" type="string">
      Description of the error
    </ParamField>
  </Expandable>
</ParamField>

## Error Codes

<Note>
  New error codes may be added in future versions. Consumers should handle unknown codes gracefully.
</Note>

| Code                | Description           |
| ------------------- | --------------------- |
| `ACCOUNT_NOT_FOUND` | Account not found     |
| `UNKNOWN_ERROR`     | Unknown error         |
| `SYSTEM_ERROR`      | Internal system error |

## Request Example

```json theme={null}
{
  "id": "a3f8e2b1-5c7d-4e9f-b8a2-1d4c6e9f0a3b",
  "time": "2026-01-22T13:47:21Z",
  "correlationId": "550e8400-e29b-41d4-a716-446655440000",
  "type": "account.restriction-creation-failed",
  "data": {
    "accountId": "019bdb2a-960f-789d-8955-21720e6cdeed",
    "source": "PLAIS",
    "externalRef": "PLAIS-2026-12345",
    "errors": [
      {
        "code": "ACCOUNT_NOT_FOUND",
        "message": "Account not found"
      }
    ]
  }
}
```