Tameson Odoo icon

Tameson Odoo

Consume Odoo API
Join our community

Actions21

Overview

The Tameson Odoo node for n8n allows you to interact with the Odoo API, specifically to manage contacts within your Odoo instance.
For the Contact → Create operation, this node enables you to create new contact records in Odoo, including detailed information such as name, address, email, phone numbers, job position, and more.

Common scenarios:

  • Automating the creation of new contacts from form submissions or CRM integrations.
  • Syncing contacts from other systems (e.g., marketing platforms) into Odoo.
  • Batch importing contacts with additional metadata.

Practical example:
When a new lead is captured via a web form, use this node to automatically create a corresponding contact in Odoo, populating all relevant fields like address, email, and phone number.

Properties

Name Type Meaning
Name String The full name of the contact. This field is required.
Additional Fields Collection Optional extra details about the contact. See below for subfields.

Additional Fields sub-properties:

Name Type Meaning
Address Fixed Collection The contact's address details. Includes city, country, state, street, street2, and zip code.
  City String City name.
  Country Name or ID Options Country selection (from list or by ID/expression).
  State Name or ID Options State selection (from list or by ID/expression).
  Street String Street address.
  Street 2 String Additional street information.
  Zip Code String Postal/zip code.
Email String Contact's email address.
Internal Notes String Any internal notes or comments about the contact.
Job Position String The contact's job title or function.
Mobile String Mobile phone number.
Phone String Landline phone number.
Tax ID String VAT or tax identification number.
Website String Contact's website URL.

Output

The node returns a JSON object representing the newly created contact in Odoo.
The structure typically includes all fields sent in the request, plus any additional data returned by Odoo (such as the unique contact ID).

Example output:

{
  "id": 123,
  "name": "Jane Doe",
  "email": "jane.doe@example.com",
  "phone": "+1234567890",
  "mobile": "+0987654321",
  "function": "Manager",
  "vat": "DE123456789",
  "website": "https://janedoe.com",
  "comment": "VIP client",
  "street": "Main St 1",
  "city": "Berlin",
  "zip": "10115",
  "country_id": 49,
  "state_id": 16,
  // ...other Odoo-specific fields
}

Note: The actual output fields depend on your Odoo configuration and which fields are returned by the API.

Dependencies

  • Odoo API: Requires access to an Odoo instance with API enabled.
  • Credentials: You must configure odooApi credentials in n8n, including:
    • Odoo URL
    • Database name
    • Username
    • Password

Troubleshooting

Common issues:

  • Invalid credentials: If authentication fails, ensure your Odoo URL, database, username, and password are correct.
  • Missing required fields: The "Name" property is mandatory. Omitting it will result in an error.
  • Field mapping errors: Ensure that option fields like "Country" and "State" are set correctly, either by selecting from the list or providing valid IDs.

Error messages:

  • "Credentials are not valid": Check your Odoo credentials and try again.
  • "Settings are not valid: ...": There may be a misconfiguration in your Odoo connection settings.
  • "error": "<message>" in output: If Continue On Fail is enabled, failed items will include an error field with the message.

Links and References

Discussion