---
title: "Generate a single use referral link"
method: POST
path: "/v1/referrals/{referral_campaign_id}/generate_link"
tags: ["Referrals"]
---

# Generate a single use referral link

`POST /v1/referrals/{referral_campaign_id}/generate_link`

## Request

- Base URL: `https://api.proof.com`
- URL: `https://api.proof.com/v1/referrals/{referral_campaign_id}/generate_link`
- Auth: API key in header `ApiKey`

## Path parameters

- `referral_campaign_id` string, required

## Request body

- ReferralCodeParams
  - `expires_at` string: ISO 8601 timestamp for when the single use code should expire. Default: 3 months from creation

## Response `200`

Success

- ReferralLinkObject
  - `link` string: Single use referral link to share with the signer.

## Other responses

- `400`: Bad Request
- `404`: Not Found

## Changes

- **2026-11-03** `9fbe2f178cd5`: 4 breaking, 2 warning, 2 info
  - added `subschema #1, subschema #2, subschema #3` to the `errors` response property `oneOf` list for the response status `400`
  - added `subschema #1, subschema #2, subschema #3` to the `errors` response property `oneOf` list for the response status `404`
  - the `errors` response's property type changed from `object` to no type for status `400`
  - the `errors` response's property type changed from `object` to no type for status `404`
  - …4 more

[Operation history](https://skmtc.dev/proof/apis/proof-business-api-specification/changes/v1/referrals/:referral_campaign_id/generate_link/post.md)

---

[API](https://skmtc.dev/proof/apis/proof-business-api-specification.md) - [All operations](https://skmtc.dev/proof/apis/proof-business-api-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/proof/apis/proof-business-api-specification/revisions/9fbe2f178cd5?raw)