Auth

Send a passwordless sign-in link to an email address

post/auth/magic-link

Request

  • Base URL: https://api.nippy.host
  • URL: https://api.nippy.host/auth/magic-link
  • Auth: none declared

Request body

emailstring email required

Email address to send the magic sign-in link to

callbackPathstring

Path to embed in the magic link, relative to the app origin (e.g. "/dashboard")

refstring

First-touch acquisition channel (e.g. "cli", "mcp", "extension", a launch slug). Recorded on the user only if this request creates the account; ignored for existing users.

checkoutPlan'basic' | 'pro'

When set, the magic link returns the user straight into Stripe Checkout for this paid plan after their email is verified (verify-then-checkout, ADR 0030). Only personal-eligible tiers; the Team plan needs an org.

checkoutInterval'month' | 'year'

Billing cadence for the carried checkout intent.

checkoutCurrency'usd' | 'gbp' | 'eur' | 'chf'

Presentment currency for the carried checkout intent; omitted lets Stripe localize.

Example request

{
  "email": "john@example.com",
  "callbackPath": "/verify-email",
  "ref": "cli"
}

Response

A magic link will be emailed if the address is valid. The response is identical regardless of whether an account already exists.

messagestring required

Changes

No recorded changes to this operation across all 1 revision of this API.