---
title: "Link experience to price variant"
method: POST
path: "/price_variants/{price_variant_id}/experiences"
tags: ["PriceVariants"]
---

# Link experience to price variant

`POST /price_variants/{price_variant_id}/experiences`

## Request

- Base URL: `https://api.crevio.co/v1`
- URL: `https://api.crevio.co/v1/price_variants/{price_variant_id}/experiences`
- Auth: API key in header `Authorization`

Links an experience to a price variant so buying that variant grants the experience. Back-grants access to everyone who already bought.

## Path parameters

- `price_variant_id` string, required

## Headers

- `Idempotency-Key` string

## Request body

- PriceVariantExperienceRequest
  - `experience_id` string, required: Experience ID or slug to link

## Response `201`

Experience linked

- Experience
  - `id` string, required
  - `object` string, required
  - `name` string, required
  - `slug` string, required
  - `description` string, nullable, required
  - `access_type` 'secret' | 'open', required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `type` string, required
  - `active_grants_count` integer, required
  - `details` object, required: Type-specific fields, shaped by the experience's `type`. Mirrors what PATCH accepts under `details` (see the per-type *DetailsRequest schemas), plus read-only collections (e.g. a course's `chapters`).

## Other responses

- `400`: Bad request
- `401`: Authentication required
- `403`: Forbidden
- `404`: Resource not found
- `422`: Validation error
- `429`: Rate limit exceeded — 600 requests per minute per credential. Retry after the number of seconds in `Retry-After`.
- `500`: Internal server error

---

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