Webhooks

Webhooks gives you a way of knowing when an event related to one of your jobs has happened.
E.g. when a song is mastered successfully.

There is no limit to how many webhooks you can have.

Example: Webhook POST request body from Masterchannel

json

{
  'file_ref': 'd2b00fd2-7837-44a8-b1b4-1dcbda5998b2',
  'event': 'MASTER_COMPLETED',
  'estimated_completion_date': '2022-09-15T12:36:19Z',
  'completion_date': '2022-09-15T12:35:42Z'
}

Validating a Webhook call (optional)

All webhook calls coming from Masterchannel to your assigned webhook.url will have x-signature in it's header. If the computed hash (HMAC/SHA-256) of the webhook_call.body using the secret key from webhook.secret equals the value of the webhook_call.header['x-signature'], then you can be assured that the webhook call came from Masterchannel!

Example:

javas

// The secret attached to your webhook, retrievable by our endpoints
var secret = webhook.secret;

// The request our backend sent your URL, e.g. when a song was successfully mastered
var body = webhook_call.body();

if(hmac(body, secret) == webhook_call.headers["x-signature"]){
  // The request is valid
} else {
  // The request is invalid
}