---
title: "Set custom referral code"
method: PUT
path: "/v1/referral/code"
tags: ["referral"]
---

# Set custom referral code

`PUT /v1/referral/code`

## Request

- Base URL: `https://api.slideforge.dev`
- URL: `https://api.slideforge.dev/v1/referral/code`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Set a custom referral code. 3-20 characters, alphanumeric and hyphens only. Case-insensitive (stored uppercase).

## Request body

- SetCodeRequest: PUT /v1/referral/code body.
  - `code` string, required: Custom referral code (alphanumeric + hyphens)

## Response `200`

Code set successfully

- unknown

## Other responses

- `400`: Invalid code format
- `409`: Code already taken
- `422`: Validation Error

---

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