---
title: "Login link overview"
icon: "file-lines"
description: "Generate single-use magic links for customer access"
---

> For the complete documentation index, see [llms.txt](/llms.txt).

Generate a single-use magic link that takes the customer directly into iwoca's platform – to select an offer, send documents, or draw down funds.

<CardGroup cols={1}>
  <Card title="Get login link" icon="code" href="/api-reference/login-link/get-customers-login-link">
    `GET` /customers/\{customer_id\}/login_link/
  </Card>
</CardGroup>

## Essentials

<Steps>
  <Step title="You must be the customer's most recent introducer">
    You can only generate a link for a customer you introduced most recently.
    If another partner – or iwoca directly – has picked the customer up since, you'll get `403 Forbidden`.
  </Step>
  <Step title="Link is single-use">
    Each generated URL can only be used once.
    Generate a fresh link each time you need to redirect the customer.
  </Step>
  <Step title="Tell us which offer you're linking to">
    Pass the customer's chosen offer as `offer_id` – for example `GET /customers/{customer_id}/login_link/?offer_id=550e8400-e29b-41d4-a716-446655440000`.
    It's optional, and the link is always returned whether you include it or not.
  </Step>
  <Step title="Destination depends on state">
    Where the customer lands depends on their application progress – they may be selecting an offer, providing documents, or drawing down immediately.
  </Step>
</Steps>

## Reference

<AccordionGroup>
  <Accordion title="Destination by application state">
    | State | Customer experience |
    |---|---|
    | No offers selected | Lands in offer selection process |
    | Confirmed offer selected | Can immediately draw down |
    | Sample/indicative offer selected | Asked to provide documentation |
  </Accordion>
</AccordionGroup>