We’re currently experiencing a high volume of support requests, which may result in longer response times — thank you for your patience and understanding.
cancel
Showing results for 
Show  only  | Search instead for 
Did you mean: 

This documentation is for the new preview UI. It’s still being refined and is subject to change. For documentation for the old UI, see Knowledge Base.

Article link copied to clipboard
Updated
Published
4 min read
Note on third‑party tools

We aim to provide accurate and helpful details about third‑party tools, but we can’t guarantee that this information is always complete or up to date. If you notice any discrepancies, feel free to share them in the feedback section below. For the most reliable information, please always refer to the third‑party tool’s official documentation.

Manage records in an Odoo database

Connections

Odoo Connection

Connect to your Odoo instance

Customers can use Odoo's cloud service to access an Odoo database, or they can run Odoo on their own servers.
Either way, Odoo uses basic auth to connect to an Odoo database.

  • For Base URL, you can enter the URL you visit when you log in to Odoo (something like https://example-company.odoo.com).
  • You can likely ignore Server Port, unless your customer uses a non-traditional port for accessing their Odoo installation.
  • The Database Name can be found by clicking the user icon on the top-right within Odoo, and then selecting My Databases.
  • Username is the email address the user uses to log in.
    We recommend they create a system account for integrations (i.e. not a specific user's account).
  • Password or API Key can either be the password your customer uses to log in to Odoo, or they can generate an API key.
    To generate an API key, your customer will need to go into settings, enable developer mode, and then from their user preferences they can generate an API key.
    See https://www.odoo.com/documentation/14.0/developer/api/external_api.html#api-keys.
Input Comments Default
Odoo Base URL Enter the URL you visit when you log in to Odoo
Server Port Leave blank to use default HTTP (80) or HTTPS (443)
Odoo Database Name Click the user icon on the top-right within Odoo and then select 'My Databases'
Username
Password or API Key

Actions

Create Record

Create a new record of a given type

Input Comments Default
Connection
Model The type of record you would like to query for. Use the 'List Models' action for a list of available models.
Parameters A JSON object of field names and values to set on the record.
External ID A unique identifier mapping this record to an ID in an external system.

Delete Record By ID

Delete a record by its numerical ID

Input Comments Default
Connection
Model The type of record you would like to query for. Use the 'List Models' action for a list of available models.
Record ID The ID of the record you want. Odoo uses numbers for record IDs.

Get Record by External ID

Get a record by its external ID

Input Comments Default
Connection
External ID A unique identifier mapping this record to an ID in an external system.

Get Record By ID

Fetch a Record by its numerical ID

Input Comments Default
Connection
Model The type of record you would like to query for. Use the 'List Models' action for a list of available models.
Record ID The ID of the record you want. Odoo uses numbers for record IDs.

List Model Fields

List all fields for a given model

Input Comments Default
Connection
Model The type of record you would like to query for. Use the 'List Models' action for a list of available models.

List Models

Fetch a list of models installed in the customer's Odoo database

Input Comments Default
Fetch All Records Whether to fetch all records. false
Name Search Search for models whose names contain this search term.
Model Search Search for models whose contain this search term.
Pagination Limit Fetch only this many records at a time. See Pagination.
Pagination Offset Fetch records offset by this value. See Pagination.
Connection

List Records

Fetch a list of records of a given type

Input Comments Default
Fetch All Records Whether to fetch all records. false
Model The type of record you would like to query for. Use the 'List Models' action for a list of available models.
Pagination Limit Fetch only this many records at a time. See Pagination.
Pagination Offset Fetch records offset by this value. See Pagination.
Connection

Raw Request

Issue any execute_kw action

Input Comments Default
Connection
Model The type of record you would like to query for. Use the 'List Models' action for a list of available models.
Method The action to execute in Odoo.
Parameters A JSON object of field names and values to set on the record. [["read"]]

Set External ID

Add an external ID to a record that does not have one

Input Comments Default
Connection
Model The type of record you would like to query for. Use the 'List Models' action for a list of available models.
Record ID The ID of the record you want. Odoo uses numbers for record IDs.
External ID A unique identifier mapping this record to an ID in an external system.

Update Record

Update an existing record of a given type

Input Comments Default
Connection
Model The type of record you would like to query for. Use the 'List Models' action for a list of available models.
Record ID The ID of the record you want. Odoo uses numbers for record IDs.
Parameters A JSON object of field names and values to set on the record.