Skip to main content
Through the Pinata App you can create Webhooks for particular events fired from the Pinata API for your account specifically, like uploading or deleting a file.

​
Setup

Navigate to the Webhooks Tab inside the Pinata App and click “Add Endpoint” in the top right. webhooks create On the New Endpoint page you can put in a URL for your server endpoint that will receive the events. Additionally you can give it a description, which events it will subscribe to, and more advance options like rate limiting. Once you have your options selected click “Create” at the bottom.
If you don’t have an endpoint for your app or server yet, you can create a test one by clicking on the Svix Play link below the URL input.
webhooks form Once your Webhook is created you will be taken to the dashboard where you can see incoming logs and events that are fired. Try triggering one of the events that you’ve selected for your webhook either from the Pinata App or from the API. Then come back to the dashboard to see the result! webhooks dashboard

​
Event Catalog

Check out the link below to browse all the available webhook events you can subscribe to!

Webhook Event Catalog

Visit our Svix page for all Pinata Webhook events!

​
Signature Verification

Webhook signatures let you verify that webhook messages are actually sent by Pinata and not a malicious actor. For a more detailed explanation, check out this article on why you should verify webhooks. To grab the secret for your Webhook locate it on the Webhook Dashboard on the right sidebar. Click on the reveal icon to view the secret and copy it. webhook secret Our webhook partner Svix offers a set of useful libraries that make verifying webhooks very simple. Here is a an example using Javascript:
For more instructions and examples of how to verify signatures, check out their webhook verification documentation.