# Swiyu DID Registered

Delivered when a DID was created and published to the Identifier Registry for an environment. Verification works from here on.
This is a **system event** about your environment's configuration, not a per-resource event. It is delivered to every configured webhook endpoint regardless of the per-event subscription grid.

Endpoint: POST swiyu.did_registered
Version: 1.2.0

## Header parameters:

  - `X-Webhook-Event` (string, required)
    Event type (same as `event` field in body).

  - `X-Webhook-Signature` (string, required)
    HMAC-SHA256 hex digest of the raw request body. Verifying is **recommended** — see the [Webhooks guide](../guides/webhooks.md#verifying-signatures).

  - `X-Webhook-Timestamp` (string, required)
    Delivery time in Unix seconds. Not covered by the signature; for replay protection check the signed body's `timestamp` instead.

  - `X-Webhook-Signature-Previous` (string)
    Present during the 24-hour secret rotation grace period — signature with the previous secret.

## Request fields (application/json):

  - `event` (string, required)
    Event type identifier (same value as the `X-Webhook-Event` header).

  - `tenant_id` (string, required)
    Your organization ID.
    Example: 550e8400-e29b-41d4-a716-446655440000

  - `timestamp` (string, required)
    When the event occurred (RFC 3339 UTC).
    Example: 2026-05-16T10:00:00Z

  - `data` (object, required)

  - `data.tenant_id` (string, required)
    Your organization ID.
    Example: 550e8400-e29b-41d4-a716-446655440000

  - `data.environment` (string, required)
    Environment whose swiyu integration changed.
    Enum: "beta", "production"

  - `data.action` (string, required)
    What changed. `configured` — connection credentials saved; `deconfigured` — the integration removed; `reconfigured` — the stored credentials replaced; `refresh_token_replaced` — only the refresh token swapped in; `did_registered` — a DID published (verification is now possible); `issuing_enabled` — a status list created and issuance switched on.
    Enum: "configured", "deconfigured", "reconfigured", "refresh_token_replaced", "did_registered", "issuing_enabled"

## Response 200:

  - `200` (unknown)
    Event acknowledged — return any `2xx` status to confirm receipt.