Today, we’re excited to announce Webhooks, powered by our partner Svix. Webhooks allow developers to receive messages to their API server based on events that happen in their Pinata account. For example, a developer can set up a webhook that receives an event every time a file is uploaded to their account.

Webhooks make the powerful API Pinata has built even more powerful. They enable use cases that were previously not possible. Starting today, developers on paid plans can start receiving event messages for the following events:

• Public IPFS file added
• Private IPFS file added
• Public IPFS file removed
• Private IPFS file removed

In the coming days and weeks, we will be adding more events. Keep an eye on our docs for the full list.

Why do webhooks matter?

Webhooks are the bridge that connects IPFS with the rest of your tech stack, enabling real-time communication and automation like never before. Here’s why they’re a game-changer for developers:

1. Instant Updates, Zero Polling

Webhooks eliminate the need for repetitive polling to check the status of your pinned files. Instead, they deliver real-time notifications whenever:

• A file is pinned
• A file is unpinned
• A private file is added
• A private file is deleted

This means you can immediately react to changes without wasting resources or time on constant API requests.

2. Seamless Automation

With webhooks, you can automate workflows across your systems. For example:

• Trigger alerts in Slack or Discord when a file is pinned
• Update your database with pinned file data
• Kick off follow-up processes, such as generating reports or initiating smart contract actions, once a file is pinned

3. Developer-Friendly Integration

Webhooks make integrating IPFS into complex ecosystems effortless. Whether you're working with dApps, CMS platforms, or backend systems, webhooks allow you to:

• Build custom logic triggered by pinning events
• Keep applications in sync with your IPFS storage in real time
• Focus on building rather than constantly querying APIs

4. Enhanced Monitoring and Visibility

For users managing a high volume of pinned files, webhooks provide better insights and transparency. They enable you to:

• Track and debug pinning issues faster
• Gain peace of mind knowing you're informed about every critical event

5. Scalable for crypto and Beyond

As IPFS becomes central to crypto, scalability is critical. Webhooks help you manage IPFS storage in a scalable way by making it easier to:

• Integrate with decentralized protocols
• Respond to events dynamically, improving system efficiency and reliability

Get started today

If you’re on a paid plan, simply click the Webhooks link in the left-sidebar navigation. On the Webhooks page, you can configure your endpoint URL and specify the events you want to listen to.

To get a sense of all the capabilities, check out our docs. And if you don’t have a paid plan, now might be a great time to sign up or upgrade!