# Create eventgroup

Creates a new Eventgroup record. Canonical read model for an event group within the system domain.

Endpoint: POST /site/{siteId}/ahds/v1/eventgroup
Version: 1.0
Security: bearer

## Path parameters:

  - `siteId` (number, required)
    Site identifier

## Request fields (application/json):

  - `category` (string)
    High-level category or type of event group (e.g., workflow, reminder-set, campaign).

  - `description` (string)
    Detailed description of the event group.

  - `eventgroupId` (string, required)
    Stable, opaque identifier for the event group.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `extensions` (object)
    Vendor- or practice-specific extensions.

  - `locationId` (string)
    Primary location associated with this event group, if applicable.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `name` (string, required)
    Human-readable name or label for the event group.

  - `organizationId` (string)
    Owning organization or practice for this event group.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `status` (string, required)
    Lifecycle status of the event group.
    Enum: "active", "inactive", "archived"

## Response 201 fields (application/json):

  - `category` (string, required)
    High-level category or type of event group (e.g., workflow, reminder-set, campaign).

  - `createdAt` (string, required)
    Timestamp when the event group was created.
    Example: "2025-01-01T00:00:00.000Z"

  - `description` (string, required)
    Detailed description of the event group.

  - `eventgroupId` (string, required)
    Stable, opaque identifier for the event group.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `extensions` (object, required)
    Vendor- or practice-specific extensions.

  - `locationId` (string, required)
    Primary location associated with this event group, if applicable.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `name` (string, required)
    Human-readable name or label for the event group.

  - `organizationId` (string, required)
    Owning organization or practice for this event group.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `status` (string, required)
    Lifecycle status of the event group.
    Enum: "active", "inactive", "archived"

  - `updatedAt` (string, required)
    Timestamp when the event group was last updated.
    Example: "2025-01-01T00:00:00.000Z"


## Response 400 fields

## Response 401 fields

## Response 409 fields