- What are webhooks?
- How to configure webhooks
Restriction: You need to be signed in using an administrator's account in order to configure webhooks.
User Menu > Settings > Configuration Options > API > Webhooks
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
How to configure webhooks
To configure a webhook within your account, navigate to Settings > Configuration Options > API > Webhooks
EventThere are six available triggers:
- New Asset - When a new asset is uploaded to the library.
- Update Metadata - When an asset's tags, keywords, a description, etc. are added/removed/changed.
- Delete Asset - When an asset is deleted from the library.
- Add New Version - When a new version of an asset is added to the library.
- Relate Files - When a new set of assets is related.
- Assign to Album - When an asset is assigned to another album.
Webhook URLEnter the incoming webhook endpoint URL here.
Secure TokenIf 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 TypeChoose the type of message to be sent to the webhook URL.
ParametersCheck 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 a 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-