# Account group events

Account group events

Endpoint: POST Account Group events
Version: 1.111.0

## Request fields (application/json):

  - `id` (string, required)
    Event unique identifier

  - `created_at` (string, required)
    Date and time when the event was created. [RFC 3339-5](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6), [ISO8601 UTC](https://www.iso.org/iso-8601-date-and-time-format.html)

  - `type` (string, required)
    Event type
    Enum: "ACCOUNT_GROUP.CREATED", "ACCOUNT_GROUP.ACTIVATED", "ACCOUNT_GROUP.CLOSING_INITIATED", "ACCOUNT_GROUP.CLOSED", "ACCOUNT_GROUP.LOCKED"

  - `object` (any, required) — one of:
    - Account Group:
      - `id` (string, required)
        Account group unique identifier.
      - `created_at` (string, required)
        Date and time when the resource was created. [RFC 3339-5](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6), [ISO8601 UTC](https://www.iso.org/iso-8601-date-and-time-format.html)
      - `updated_at` (string, required)
        Date and time when the resource was last updated. [RFC 3339-5](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6), [ISO8601 UTC](https://www.iso.org/iso-8601-date-and-time-format.html)
      - `users` (array, required)
      - `users.id` (string)
        User unique identifier.
      - `users.type` (string)
        Relation type
* OWNER - Account Group Owner
* CHILD - Child Account Group Owner
* GUARDIAN - Child Account Group Guardian
        Enum: "OWNER", "CHILD", "GUARDIAN"
      - `status` (string, required)
        Status of the account group
* PENDING_APPROVAL - Account group approval is pending - the account group is visible through our API but cannot be acted on.
* ACTIVE - Account group is active - full functionality of the Investment API is accessible.
* CLOSING - Account group is closing.
* CLOSED - Account group is closed.
* LOCKED - Account group is locked for all actions.
        Enum: "PENDING_APPROVAL", "ACTIVE", "CLOSING", "CLOSED", "LOCKED"
      - `type` (string, required)
        Account group type.
* PERSONAL - Account group of a person holding assets on their own behalf.
* LEGAL_ENTITY - Account group of a legal entity holding assets on behalf of their users.
* FRENCH_PEA - Account group of a french resident holding assets in Plan d'Epargne en Actions.
* ISA - Account group of a UK resident holding assets in an individual savings account.
* CHILD - Account group of a child user holding assets in a child account.
        Enum: "PERSONAL", "LEGAL_ENTITY", "FRENCH_PEA", "ISA", "CHILD"
      - `securities_account_number` (string, required)
        Account unique identifier.
    - Business Account Group:
      - `id` (string, required)
        Account group unique identifier.
      - `created_at` (string, required)
        Date and time when the resource was created. [RFC 3339-5](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6), [ISO8601 UTC](https://www.iso.org/iso-8601-date-and-time-format.html)
      - `updated_at` (string, required)
        Date and time when the resource was last updated. [RFC 3339-5](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6), [ISO8601 UTC](https://www.iso.org/iso-8601-date-and-time-format.html)
      - `business_id` (string, required)
        Unique identifier for the business.
      - `status` (string, required)
        Status of the account group
* PENDING_APPROVAL - Account group approval is pending - the account group is visible through our API but cannot be acted on.
* ACTIVE - Account group is active - full functionality of the Investment API is accessible.
* CLOSING - Account group is closing.
* CLOSED - Account group is closed.
* LOCKED - Account group is locked for all actions.
        Enum: same as `status` in "Account Group" (5 values)
      - `type` (string, required)
        Account group type.
* BUSINESS - Account group of a business holding assets.
        Enum: "BUSINESS"
      - `securities_account_number` (string, required)
        Account unique identifier.

  - `webhook_id` (string, required)
    Webhook unique identifier.


## Response 200 fields