webhooks

Odoo Studio webhooks let an external system trigger an action in Odoo automatically when something happens elsewhere, rather than Odoo checking for updates on a schedule or someone calling an API manually. This gives real-time, event-driven automation between systems.

How to create a webhook in Studio

1. Before starting, activate Developer mode to see technical model and field names, and test on a duplicate database rather than a live one.
2. Open Studio > Webhooks > New and give it a clear name, such as “Update Inventory from POS”.
3. Select the Model it applies to, if Developer mode is active; otherwise it defaults to the current model.

Odoo generates the webhook’s URL automatically. It can be rotated if needed, but must be kept confidential and updated in the external system if changed. Enable Log Calls to help with troubleshooting later.

Configuring the target record and actions

If the external system is another Odoo database, make sure its payload includes the record’s id and model. For a non-Odoo system, adjust the target record code to parse its JSON payload instead. Click Add an action to define what happens, such as updating a record or executing custom code, then save.

How to test a webhook

1. In a tool such as Postman, create a new POST request using the webhook’s URL.
2. Under the Body tab, choose raw and JSON, paste a test payload, and click Send.

A 200 OK or “status”: “ok” response means the webhook is working; any other response code points to a problem with the payload or configuration.

How to implement it in the external system

Configure the external system to send POST requests to the webhook’s URL, matching the payload format Odoo expects.