Event notifications

Legacy: This page documents Filebase's IPFS tier. For new deployments, use the S3-compatible object storage tier with the s3.filebase.io endpoint.

Filebase publishes pinning lifecycle events for IPFS buckets. Subscribe to them when you need to react programmatically to pin / unpin completion.

Available events

Event	Fires when
pin.created	A new pin is created (upload or re-pin).
pin.completed	A pin transitions from queued/pinning to pinned.
pin.failed	A pin transitions to failed.
pin.deleted	A pin is unpinned via the API or console.

Webhook configuration

Configure a webhook in the Filebase console under Settings → Notifications. Filebase POSTs the event payload to your URL:

{
  "type": "pin.completed",
  "bucket": "my-ipfs-bucket",
  "cid": "QmExample...",
  "name": "photo.jpg",
  "timestamp": "2026-05-01T12:00:00.000Z"
}

Verify webhook authenticity by comparing the X-Filebase-Signature header against an HMAC-SHA-256 of the request body using your account's webhook secret.

What's next

• Pinning files
• Pinning Service API