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

# subscription.activated

> Sent when a customer's supply starts.

Triggered on the supply start date, when energy delivery to the customer begins. Use this to mark the customer active in your own systems.

## Response body parameters

<ResponseField name="id" type="string" required>
  Unique event identifier (starts with `evt_`).
</ResponseField>

<ResponseField name="timestamp" type="string" required>
  ISO 8601 timestamp when the event was created.
</ResponseField>

<ResponseField name="topic" type="literal" required>
  Always `subscription.activated` for this event.
</ResponseField>

<ResponseField name="context" type="object" required>
  Event-specific data containing related resource IDs.

  <Expandable title="properties" defaultOpen>
    <ResponseField name="subscription" type="string" required>
      ID of the related subscription (starts with `sub_`).

      Fetch the full record via [`GET /subscriptions/{id}`](/api-reference/subscriptions/retrieve-a-subscription).
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```json Example payload theme={null}
  {
    "id": "evt_abc123def456ghi789jkl012",
    "timestamp": "2026-01-15T10:30:00.000Z",
    "topic": "subscription.activated",
    "context": {
      "subscription": "sub_abc123def456ghi789jkl012"
    }
  }
  ```
</RequestExample>
