---
title: "Create Affiliate Link"
method: POST
path: "/v1/ambassador/links"
tags: ["ambassador", "Ambassador"]
---

# Create Affiliate Link

`POST /v1/ambassador/links`

## Request body

- AffiliateLinkCreate
  - `slug` string, required — URL slug like 'ai', 'agents', 'code'
  - `name` string, nullable — Optional name/description for this link

## Response `201`

Successful Response

- AffiliateLinkResponse
  - `id` integer, required
  - `affiliate_id` integer, required
  - `slug` string, required
  - `name` string, nullable
  - `clicks` integer, required
  - `conversions` integer, required
  - `is_active` boolean, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/kodik/apis/kodik-api.md) · [All operations](https://skmtc.dev/kodik/apis/kodik-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kodik/kodik-api/revisions/55c71b347360/schema)