Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.labelst.art/llms.txt

Use this file to discover all available pages before exploring further.

You can use webhooks to receive notifications about events that happen in your account. For example, you can use webhooks to receive notifications when a release is created, edited, or deleted.

​
Creating a webhook

To create a webhook, go to the Integrations page in the Settings section of your account. Click Add webhook and enter the name and URL of the webhook you want to create.

​
Configuring a webhook

It’s currently not possible to choose which events you want to receive notifications for. You will receive notifications for all events that are supported by the webhook.

​
Deleting a webhook

To delete a webhook, go to the Integrations page in the Settings section of your account. Click the Delete webhook button next to the webhook you want to delete.

​
Webhook payload

The payload of a webhook is a JSON object that contains information about the event that triggered the webhook. The payload will contain the following fields:
  • token: A unique identifier for the webhook that can be used to verify the authenticity of the webhook.
  • type: The type of event that triggered the webhook, such as release.created, release.updated, or release.deleted.
  • request: The payload of the request that triggered the webhook, such as metadata of the release that was created, updated, or deleted.
Here is an example of a webhook payload: 
{
    "token": "xxxxxx",
    "type": "release.created",
    "request": {
        "data": {
            "id":"30602",
            "gtin":"",
            "flags":[],
            "label":{"name":"AJ-28132 Records","score":100},
            "title":"Decaf",
            "genres":{
                "main":"Pop",
                "secondary":"Alternative"
            },
            "splits":[
                {
                    "created":"2024-05-08 18:36:47.196805",
                    "percentage":"100.0000000000000000",
                    "externalUser":{
                        "id":55084,
                        "email":"xxxxxx",
                        "lastName":"Allo",
                        "firstName":"Martin"
                    }
                }
            ],
            "status":"Analyzing",
            "tracks":{
                "list":[
                    {
                        "id":62317,
                        "num":1,
                        "isrc":"",
                        "audio":"xxxxxx",
                        "title":"Decaf",
                        "artists":[],
                        "preview":106,
                        "version":"",
                        "explicit":0,
                        "language":"en",
                        "songwriters":[
                            {
                                "name":"Allo Martin",
                                "type":"Composer"
                            },
                            {
                                "name":"Allo Martin",
                                "type":"Lyricist"
                            },
                            {
                                "name":"Allo Martin",
                                "type":"Producer"
                            },
                            {
                                "name":"Cecillie Carpenter",
                                "type":"Lyricist"
                            }
                        ],
                        "language_full":"English"
                    }
                ],
                "count":1
            },
            "actions":[],
            "artists":{
                "list":[
                    {
                        "name":"allo",
                        "type":"Artist"
                    },
                    {
                        "name":"bobby",
                        "type":"Artist"
                    }
                ],
                "displayArtist":"allo & bobby"
            },
            "artwork":{
                "url":"xxxxxx",
                "flags":[],
                "score":null
            },
            "canEdit":true,
            "canView":true,
            "created":"2024-05-08 18:36:47.117772",
            "exports":[],
            "updated":"2024-05-08 18:36:47.2137",
            "version":"",
            "language":"en",
            "metadata":{
                "ai_mastering":0,
                "ai_mastering_free":0,
                "ai_mastering_paid":0,
                "ls_exclude_beatport":true
            },
            "labelPage":false,
            "subgenres":{
                "main":"",
                "secondary":""
            },
            "externalId":"0",
            "externalUser":{
                "id":55088,
                "email":"xxxxxx",
                "score":100,
                "gravatar":"https://www.gravatar.com/avatar/xxxxxx?s=512&d=mp&r=r",
                "lastName":"Farag",
                "firstName":"Ali",
                "externalId":28131
            },
            "organization":{
                "id":1,
                "logo":"",
                "name":"Anti-Joy",
                "owner":1,
                "score":50
            },
            "release_date":"2024-05-08",
            "conversations":[],
            "deliveryNotes":null,
            "language_full":"English",
            "pendingUpdate":false,
            "latest_version":"",
            "pendingDelivery":false,
            "pendingTakedown":false
        }
    }
}

​
Verifying a webhook

To verify the authenticity of a webhook, you can send a POST request to the URL of the webhook with the token field of the payload as a POST field. The webhook should respond with a 200 OK status code if the token is valid or a 401 Unauthorized status code if the token is invalid. Here is an example of how to verify a webhook using curl: 
curl -X POST
    -H "Content-Type: application/json"
    -d '{"token": "abc"}' https://api.labelst.art/webhook/verify