---
title: "POST /api/affiliate/connect"
method: POST
path: "/api/affiliate/connect"
tags: ["Affiliate"]
---

# POST /api/affiliate/connect

`POST /api/affiliate/connect`

## Request

- Base URL: `https://nowyourlink.com`
- URL: `https://nowyourlink.com/api/affiliate/connect`
- Auth: API key in cookie `nyl_sess`

Returns a fresh Express dashboard login link for a ready owned recipient, otherwise Stripe-hosted onboarding. Country applies only to account creation. Links stay inside the authenticated app and must not be stored or sent by email. A return redirect is not verification evidence.

## Request body

- object
  - `country` 'DE' | 'AT' | 'BE' | 'ES' | 'FI' | 'FR' | 'IE' | 'IT' | 'LU' | 'NL' | 'PT'

## Response `200`

Own partner data. Amounts are EUR cents. Cache-Control: no-store.

- object
  - `url` string, uri
  - `expires_at` string, date-time: Onboarding links only. Express dashboard login links omit this field.

## Other responses

- `400`: Invalid query, body or idempotency key.
- `401`: Session or delegated OAuth token required.
- `403`: Missing scope, inactive partner, unverified account or invalid Origin.
- `404`: Partner account is not activated.
- `409`: Payout threshold or Stripe verification requirements not met.
- `502`: Stripe unavailable. Retry the same request key after reconciliation.
- `503`: Integration not configured.

---

[API](https://skmtc.dev/nowyourlink/apis/nowyourlink-public-spotlight-api.md) · [All operations](https://skmtc.dev/nowyourlink/apis/nowyourlink-public-spotlight-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nowyourlink/apis/nowyourlink-public-spotlight-api/revisions/cd8408529b48?raw)