Postman and Insomnia¶
The collection provides working request shapes for connection checks, model introspection, reads, aggregation, controlled mutations, and legacy JSON-RPC compatibility.
Download Postman collection Download environment
Postman setup¶
- Import both JSON files.
- Select Accountify Odoo 19 - Local credentials as the active environment.
- Set
api_keylocally. Setusernameonly if testing deprecated JSON-RPC. - Send 01 - Connection > Server version.
- Send Current user context and then the read-only requests.
- Review the target environment and record values before running any mutation.
The environment file contains no credentials. Do not export or commit a populated environment.
Insomnia setup¶
Insomnia can import Postman Collection v2.1 files:
- Choose Import and select the downloaded collection.
- Import the environment file or recreate its variables in a private Insomnia environment.
- Mark
api_keyas secret and keep it out of shared exports. - Confirm that
base_urlanddatabasepoint to the intended environment.
Collection structure¶
| Folder | Purpose |
|---|---|
| Connection | Version and authenticated context checks |
| Read operations | Search, count, field inspection, and aggregation |
| Mutations | Create, update, and delete examples requiring deliberate review |
| Legacy JSON-RPC | Deprecated compatibility requests for existing integrations |
Mutations change Odoo data
The mutation folder creates a contact and can update or delete it. Use an approved test database first and verify created_partner_id before every update or delete.