Overview/Background
Webhooks allow retailers, developers, and agency partners to stay instantly informed about what's happening inside their AIQ Ecommerce environment, without building scheduled jobs or repeatedly polling the REST API. With webhooks, AIQ automatically sends real-time notifications the moment key product or order events occur.
AIQ Ecommerce supports webhook events for Products and Orders, helping teams sync inventory, update external systems, trigger automations, or send downstream alerts.
How to Create a Webhook
Navigate to Organization > Webhooks
Click (+) Add New
Fill in your details
Endpoint: Webhooks events will be sent as POST request to this URL.
Events: Select the events the webhook will listen to. At least one must be selected.
Stores: Select which stores should send events to the specified endpoint.
Save
Viewing Webhook Activity
You can review all webhook deliveries associated with a webhook configuration.
Go to Organization → Webhooks
Click the View Events button for the webhook you want to review
The event log displays:
Created: The date when the event was generated
Event type: e.g., order.created, product.updated
Venue (Store): Where the event originated
Status: Successful or failed delivery
This helps you validate that your webhook is firing correctly and troubleshoot any endpoint issues.
Supported Events
Product:
Product Created
Product Updated
Product Deleted
Orders:
Order Created
Order Confirmed
Order Updated
Order Cancelled
Order Closed
Order Out for Delivery
Order Ready for Pickup
Order Delivered
Order Shipped
Troubleshooting
Issue: The webhook isn't firing
Ensure at least one event is selected
Ensure store(s) are selected
Confirm your endpoint returns a 200 OK response
Issue: We're not receiving POST requests
Check if your firewall blocks incoming traffic
Confirm the endpoint supports HTTPS
Verify no redirects (301/302)
Webhook shows failed delivery
Review the View Events log for error details
Ensure your server returns an HTTP 200 response
Validate the endpoint response time is under the timeout limit
Confirm JSON parsing rules on your side (AIQ sends strict JSON)
Issue: Receiving duplicate events
Your system should treat events as idempotent based on their event ID.
FAQ
What is your webhook retry behavior?
We will automatically retry 3 times, if all fails then we mark as "Failed" instead of "Succes". There is no manual retry.
Need Help?
If you need assistance, reach out to AIQ Support anytime via chat widget within your AIQ Dashboard.