---
title: "Submit lyrics"
method: POST
path: "/distribution/v1/lyrics"
tags: ["Lyrics"]
---

# Submit lyrics

`POST /distribution/v1/lyrics`

Submits plain-text lyrics for a track identified by ISRC. Returns a `lyrics_request_id` to track processing status. The output is plain-text lyrics indexed in the Musixmatch catalog.

## Request body

- SubmitLyricsRequest
  - `musixmatch_user_id` string, required — The Musixmatch user ID of the artist, obtained via token introspection of the user's access token
  - `isrc` string, required — International Standard Recording Code (ISRC) of the track
  - `lyrics` string, required — Plain-text lyrics as sung in the recording

## Response `202`

Lyrics submission accepted for processing.

- LyricsSubmitEnvelope
  - `message` string — Descriptive message of performed operation
  - `data` object
    - `lyrics` object
      - `lyrics_request_id` integer — Unique identifier for this lyrics submission, used to poll status
      - `status` 'pending' | 'progress' | 'success' | 'failure'

## Other responses

- `400` — Bad request — invalid or missing parameters
- `401` — Unauthorized — missing or invalid Bearer token
- `502` — Bad gateway — upstream service call failed or returned an unexpected response

---

[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)