Getting Started
Webhooks
Receive real-time notifications about moderation events
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
- Sign in to your Iffy Dashboard
- Click on Developer in the sidebar
Step 2: Create a Webhook
- Click Edit webhook
- Enter your webhook URL (e.g.,
https://yourapp.com/webhooks/iffy
) - Click Save webhook
- 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