Ecommerce
API
Webhooks
8 min
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 faqs 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