---
title: "Activate a subscription"
method: POST
path: "/distribution/v1/subscriptions"
tags: ["Subscriptions"]
---

# Activate a subscription

`POST /distribution/v1/subscriptions`

Grants a Musixmatch premium plan to a user when they subscribe on the distributor's platform. The `plan_id` is the distributor's plan identifier; Musixmatch maps it internally to the corresponding Musixmatch plan.

## Request body

- ActivateSubscriptionRequest
  - `musixmatch_user_id` string, required — The Musixmatch user ID obtained via token introspection
  - `partner_user_id` string, required — The partner's internal user identifier
  - `plan_id` string, required — The distributor's plan identifier. Musixmatch maps this to the corresponding Musixmatch plan during onboarding.

## Response `201`

Subscription activated.

- SubscriptionEnvelope
  - `message` string — Descriptive message of performed operation
  - `data` object
    - `subscription` object
      - `musixmatch_user_id` string
      - `plan_id` string — Present when activating a subscription
      - `status` 'active' | 'revoked'

## Other responses

- `400` — Bad request — invalid or missing parameters
- `401` — Unauthorized — missing or invalid Bearer token

---

[API](https://skmtc.net/musixmatch/apis/lyrics-api.md) · [All operations](https://skmtc.net/musixmatch/apis/lyrics-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/musixmatch/lyrics-api/revisions/edbc169d5499/schema)