subscription.created

{
  "id": "evt_mi4f0oda6x9m7gcsvjk0ole1",
  "timestamp": "2026-01-15T10:30:00.000Z",
  "topic": "subscription.created",
  "context": {
    "subscription": "sub_mi4f0oda6x9m7gcsvjk0ole1",
    "lead": "lead_mi4f0oda6x9m7gcsvjk0ole1"
  }
}

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

string

required

Unique event identifier (starts with evt_).

timestamp

string

required

ISO 8601 timestamp when the event was created.

topic

literal

required

Always subscription.created for this event.

context

object

required

Event-specific data containing related resource IDs.

Hide properties

subscription

string

required

ID of the related subscription (starts with sub_).Fetch the full record via GET /subscriptions/{id}.

lead

string

ID of the related lead (starts with lead_).Fetch the full record via GET /leads/{id}.

{
  "id": "evt_mi4f0oda6x9m7gcsvjk0ole1",
  "timestamp": "2026-01-15T10:30:00.000Z",
  "topic": "subscription.created",
  "context": {
    "subscription": "sub_mi4f0oda6x9m7gcsvjk0ole1",
    "lead": "lead_mi4f0oda6x9m7gcsvjk0ole1"
  }
}

Retries

subscription.confirmed

Subscriptions

Invoices

Meter Orders

subscription.created

Response body parameters

​Response body parameters

Response body parameters