---
title: "Create an offer link"
method: POST
path: "/offer_links"
tags: ["offer-links"]
---

# Create an offer link

`POST /offer_links`

This call requires an offer ID and a subscription ID, either as `subscription_id` from ProsperStack or `platform_subscription_id` from your connected subscription platform, e.g. Stripe.

## Request body

- union
  - object
    - `offer_id` string, required
    - `subscription_id` string, required
  - object
    - `offer_id` string, required
    - `platform_subscription_id` string, required

## Response `201`

Created

- OfferLink
  - `id` string, required
  - `url` string, required
  - `subscriber_id` string, required
  - `subscription_id` string, required
  - `offer_id` string, required
  - `status` 'created' | 'viewed' | 'accepted' | 'invalid' | 'expired', required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `400` — Error
- `401` — Error

---

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