Create a share

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Send a DISCO playlist to another DISCO inbox.

Ensure the playlist is not set to 'Streaming only' and you share the playlist to another DISCO, i.e. not within your own DISCO.

The associated playlist will be delivered to the recipient's DISCO inbox and it will trigger an email notification to yourself and to the recipient (or recipients. You can send to multiple inboxes in the same call.)

If you specify a message in your body, it will display in three places:

  1. On top of the playlist in the recipient's inbox
  2. In the email notification sent to the recipient
  3. In the email notification sent to yourself

Attributing the share to another person

By default, the share is attributed to the user associated with the API token. You can attribute the share to a specific individual to reflect the person who triggered the action.

When a share is attributed to a specific person, for example, [email protected], the following happens:

  1. Alex will receive an email notification confirming the share.
  2. The recipient's email notification will have [email protected] in the Reply-To field.
  3. The recipient's DISCO inbox will show Alex as the sender of the playlist.

Security Notice: To prevent email spoofing, attribution is only permitted for email domains that have been added to an allowlist we maintain. To add a new domain to your account's allowlist, please contact us at [email protected].

Body Params
int32
required

id of playlist to share (must be present if track_id not present)

int32
required

id of track to share (must be present if playlist_id not present)

string
required

share message, can be an empty string. Will be visible to recipient of share.

recipients
object

list of recipients

boolean
Defaults to false

send share notification without tracklist included.

string

Name of the person you want to attribute the share to

string

Email of the person you want to attribute the share to

Responses

Language
Credentials
OAuth2
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json