---
title: "Link Start"
method: POST
path: "/auth/apple/link/start"
tags: ["auth"]
---

# Link Start

`POST /auth/apple/link/start`

## Request

- Base URL: `https://api.tickertrac.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tickertrac.com/auth/apple/link/start`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Request body

- AppleStart
  - `code_challenge` string, required
  - `next` string
  - `acquisition_token` string, nullable
  - `writer_referral_code` string, nullable
  - `acquisition_source` string, nullable
  - `cta_placement` string, nullable
  - `hero_variant` string, nullable
  - `acquisition_channel` string, nullable
  - `acquisition_entry` string, nullable
  - `acquisition_medium` string, nullable
  - `acquisition_campaign` string, nullable
  - `acquisition_creative` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tickertrac/apis/tickerrag-api.md) · [All operations](https://skmtc.dev/tickertrac/apis/tickerrag-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tickertrac/apis/tickerrag-api/revisions/3c7eb0f6425d?raw)