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_).

string

required

ISO 8601 timestamp when the event was created.

literal

required

Always subscription.created for this event.

object

required

Event-specific data containing related resource IDs.

Hide properties

string

required

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

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"
  }
}

Subscriptions

Invoices

Meter Orders

subscription.created

Response body parameters

​Response body parameters

Response body parameters