Webhooks allow your application to receive real-time notifications about moderation events instead of polling our API for updates.

Setting Up Webhooks

Step 1: Access Developer Settings

  1. Sign in to your Iffy Dashboard
  2. Click on Developer in the sidebar

Step 2: Create a Webhook

  1. Click Edit webhook
  2. Enter your webhook URL (e.g., https://yourapp.com/webhooks/iffy)
  3. Click Save webhook
  4. Store the generated secret securely - you’ll need it to verify webhook signatures

Step 3: Implement Webhook Handling

Now that you’ve configured your webhook URL, you’ll need to set up your application to properly consume webhook events. These events will notify you when content is flagged, users are suspended, and other important moderation actions occur.

Webhook Events

View the complete technical specification for implementing webhooks, including payload formats, security requirements, and best practices.

Best Practices

  • Use HTTPS for webhook URLs
  • Always verify webhook signatures
  • Handle events idempotently
  • Respond quickly (process events asynchronously if needed)
  • Keep logs of received webhooks