What are Webhooks?


Webhooks are automated messages sent from applications when something happens. They have a message which is sent to a unique URL - which is essentially the application's phone number or address.


As an example, let's look at text notifications. Say, you want to be notified by your bank through a text message when you make a new purchase- You provide the bank with your phone number, so they know where to send the message. Then, once you make a purchase, a message will be created by the bank and sent to your phone number. 


In this case, the bank is the webhook, your phone number is the webhook endpoint, and the content of the text is the automated message.



Using webhooks, Canto can send automated messages to external webhook endpoints.

These endpoints can be URLs provided by a third party application or your own custom built application.


These messages are triggered based on certain actions for an asset in the Canto main library-

Uploading a new asset, Deleting an asset, Updating asset metadata, Adding a new asset version


Canto Admins are able to configure webhooks-


To configure a webhook within your account, navigate to Settings > Configuration Options > API > Webhooks-


Event:



There are four available triggers-

  1. New Asset - When a new asset is uploaded to the library.
  2. Update Metadata - When tags, keywords, description, etc.on an asset are added/removed/changed.
  3. Delete Asset - When an asset is deleted from the library.
  4. Add New Version - When a new version of an asset is added to the library.


Webhook URL:

Enter the incoming webhook endpoint URL here.


Secure Token:

If the incoming webhook URL requires a token for authentication, enter the token here.

In case the URL does not require authentication, you can simply place the value "null" in the box.

    

Content Type:

Choose the type of message to be sent to the webhook URL-


JSON -


Form-


XML-



Parameters:

Check the box for the parameters of the asset to be sent over to the webhook URL.



Once all the necessary fields have been filled out, go ahead and click add-


Only one URL can be added for each event type, which allows a total of four webhook URLs to be active at one time.


To edit a previously setup webhook, select the pencil icon to the right of it-

To delete a previously setup webhook, select the trash icon to the right of it-