Skip to main content
Follow this order when an artist signs in with their own Musixmatch account. This page is the flow only. Parameters and responses stay on the linked endpoint pages. Every Distribution API call goes to https://api.musixmatch.com/ws/1.1/ with apikey and user_id query parameters. Tracks are always identified by ISRC, not by commontrack_id.

Call order

1

Get your credentials

Contact apisupport@musixmatch.com for the API key.Send Musixmatch your redirect_uri. Musixmatch issues a client_id, then a client_secret.
2

Authenticate the artist and activate the subscription

The artist signs in with their own Musixmatch account through the Authorization Code flow. Exchange the authorization code for tokens. Those calls use https://connect.musixmatch.com, as described on that page.Call POST /oauth/token-metadata and use the returned sub as user_id on every Distribution API call. Always store the latest refresh_token.Call distribution.subscription.post with plan_id, partner_user_id, and artists. Uploads are refused without an active subscription.
3

Deliver the release

Deliver the release even when the ISRC already exists on Musixmatch. The delivery provides the audio.Call distribution.files.post. It returns upload_url and file_id. HTTP PUT the release ZIP (ERN and audio) to upload_url with the header Content-Type: application/zip. That header is required.Call distribution.delivery.post with file_id. Poll distribution.delivery.get until status is success.
4

Prepare the lyrics

Pick one option.No lyrics. Call distribution.transcription.post with isrc. Sending language is recommended. Poll distribution.transcription.get until status is success. On success the response includes lyrics and subtitle.Lyrics and sync. Call distribution.sync.post with isrc, lyrics, and language. Poll distribution.sync.get until status is success. On success the response includes subtitle.Lyrics, no sync. Continue to the next step.
5

Publish the lyrics

This call is mandatory. A transcription or sync request does not publish anything by itself. After it completes, send the result with distribution.lyrics.post: isrc, lyrics, and subtitle when you have one. Pass subtitle as-is, in LRC. lyrics is required. If you already have lyrics and skipped transcription and sync, send those lyrics with the same call. Poll distribution.lyrics.get until status is success. The lyrics are then live in the catalog.