Webhooks

Webhooks allow Holo to send real-time notifications to your application when events occur, eliminating the need to poll the API.

What Are Webhooks?

Webhooks are HTTP callbacks that notify your application when specific events happen in Holo:

• Harvest records created or updated
• Crop plans modified
• Inventory changes
• Sales orders created or fulfilled
• Task assignments and completions

Setting Up Webhooks

1. Navigate to Settings → API & Integrations → Webhooks
2. Click "Create Webhook"
3. Enter your webhook URL (must be HTTPS)
4. Select the events you want to receive
5. Configure authentication (optional but recommended)
6. Test the webhook connection
7. Save and activate the webhook

Webhook Payload

Webhook payloads include:

• Event type and timestamp
• Resource data (the object that changed)
• Event metadata
• Webhook signature for verification

Security

Secure your webhooks:

• Use HTTPS endpoints only
• Verify webhook signatures
• Implement authentication on your endpoint
• Validate payload data before processing
• Handle errors gracefully

Retry Logic

Holo automatically retries failed webhook deliveries:

• Initial retry after 1 minute
• Exponential backoff for subsequent retries
• Maximum retry attempts: 5
• Webhook disabled after max retries

Ensure your endpoint responds quickly (within 5 seconds) and returns appropriate HTTP status codes.

Testing Webhooks

Test your webhook implementation:

• Use the "Test Webhook" feature in settings
• Use webhook testing tools like webhook.site
• Monitor webhook delivery logs
• Handle test events separately from production events