Skip to the content
Get an API key
  1. API reference
  2. Connect your users

Start a sign-in with one service

GET/{slug}/{integrationType}/auth
Host: https://app.musicapi.com
Core + Managed TransfersBrowser page · no credential

A page, not a JSON call. Skips the service picker and sends the user straight to the sign-in of one service. This works even for a service that is off in your dashboard.

Path parameters

slug
stringrequired

Your account slug.

integrationType
stringrequired

The service id, for example spotify, appleMusic, tidal.

Query parameters

returnUrl
urirequired

Where the user comes back to. It must be one of your Return URLs (Dashboard, Settings).

requestOneTimeToken
boolean · false

Add a one-time token to the callback. With it, your backend or app reads the raw service tokens once.

uniqueId
uuid

A UUID v4 that you make. Poll GET /app/integrations/byUniqueId/{uniqueId} with it.

forwardFailures
boolean · false

Send the user back to returnUrl at once when the sign-in fails.

merchantUserId
string

Your own id for this user. It is stored on the connected user and in the usage data.

Response

302A redirect to the service's sign-in page.