Skip to content
Open AccessReferences / Create new partner

Create new partner

Required scope: soa-create-partner

Create a new partner so that users of that partner can be linked to Spotify users. Returns the partner ID to use in subsequent requests managing partner information, user linking, and entitlements.

Authorization scopes



This endpoint requires the payload to be provided as a JWT.

The payload has the following fields:

partner_namestringyesThe display name of the partner to create
entrypoint_urlstringyesUsed to initiate the account linking flow from Spotify surfaces. Must be served over SSL (https). See Entrypoint URL


On success the response contains the ID of the newly created partner

  • partner_id

Response sample

{  "partner_id": "1234567890aBcDeFgHiJkL"}