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

# Leads & Checkout Links

> Designed for one-tap signup.

## Pre-fill the checkout with what you already know

Create a lead with everything you know about the prospect, and the response includes a pre-filled checkout link. Send it however you want (email, SMS, in-app, QR code) and the customer confirms instead of typing. Every field you set on the lead is one field they don't see, and the link stays valid until the lead converts or is deleted.

```
https://{plan.slug}.checkout.energy/?id={lead.id}
```

<Frame caption="Example: opening a lead link drops the customer on the checkout with their data pre-filled">
  <img src="https://mintcdn.com/riverslate/rFuRSKXuhnC74OsD/images/leads.png?fit=max&auto=format&n=rFuRSKXuhnC74OsD&q=85&s=287c70f93e08ca2e5e0460acb14f797b" alt="Hosted checkout opened from a lead link, with name, address, previous supplier, meter, and IBAN already filled in" width="2766" height="1608" data-path="images/leads.png" />
</Frame>

## What goes on a lead

Create leads via the [dashboard](https://dashboard.nomos.energy/leads) or API ([Create a lead](/api-reference/leads/create-a-lead)). The minimum useful lead carries `plan`, an `address` with at least a `zip`, and a `meter.estimated_usage`. Add `customer`, `payment_method`, and `previous_supplier` as you collect them; every field you set is one field the customer doesn't see.

## Attribution

Set `created_by` when you create the lead. It's the email of the rep or agent credited for the conversion. Combined with `metadata` (UTMs, campaign IDs, internal user IDs), you have everything needed to attribute every signup back to the prospecting flow that produced it.

When the lead converts, a [`subscription.created`](/webhooks/events/subscription-created) webhook fires with the lead ID in the event context. The lead also carries `subscription` and `subscribed_at`. Poll [Retrieve a lead](/api-reference/leads/retrieve-a-lead) if that fits your stack better than webhooks.

## FAQ

<AccordionGroup>
  <Accordion title="How long does the link stay valid?">
    Indefinitely, as long as the lead hasn't been converted or deleted. Send
    follow-up reminders without re-creating the lead.
  </Accordion>

  <Accordion title="Can the customer edit pre-filled data?">
    Yes. Every field is editable in the form; the lead provides defaults, not a
    lock.
  </Accordion>

  <Accordion title="What if I don't have a previous supplier yet?">
    Omit `previous_supplier`. The customer picks one in the form. Move-ins don't
    need a previous supplier at all.
  </Accordion>

  <Accordion title="Can multiple subscriptions come from one lead?">
    No. A lead converts to exactly one subscription. Create a new lead for a
    second product.
  </Accordion>
</AccordionGroup>