Quickstart¶

Use the JSON-2 API for new Odoo 19 integrations. It sends one public model method per HTTP request and authenticates with an API key.

Prerequisites¶

An Odoo user dedicated to the integration
An API key generated for that user
Access to the target model and records
The database name when the hostname serves more than one database

Setting	Runtime value
Base URL	`https://accountify.solutions`
JSON-2 base	`https://accountify.solutions/json/2`
Database	`accountify_v19_clone_21.06.2026`

First request¶

Read up to five company contacts:

curl --request POST \
  "https://accountify.solutions/json/2/res.partner/search_read" \
  --header "Authorization: bearer $ODOO_API_KEY" \
  --header "X-Odoo-Database: accountify_v19_clone_21.06.2026" \
  --header "Content-Type: application/json" \
  --data '{
    "domain": [["is_company", "=", true]],
    "fields": ["name", "email", "country_id"],
    "limit": 5,
    "order": "name asc"
  }'

A successful response is a JSON array of records:

[
  {
    "id": 42,
    "name": "Example Company",
    "email": "finance@example.com",
    "country_id": [81, "Germany"]
  }
]

Relation values

A many2one field such as country_id is commonly serialized as [id, display_name] when read. Use the numeric ID when writing the relation.

Next steps¶

Import the Postman collection and verify the server version.
Review models, records, and fields.
Find the target in the runtime model catalog.
Start with read-only calls before enabling create, update, or delete operations.