> ## 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.created

> Sent when a customer completes signup.

Triggered after the customer completes signup and the subscription is created. Nomos then initiates supplier switching: cancelling the previous supplier and registering with the grid operator.

If `lead` is set, the customer signed up from an existing lead.

## 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.created` 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>

    <ResponseField name="lead" type="string">
      ID of the related lead (starts with `lead_`).

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

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