Tameson Odoo icon

Tameson Odoo

Consume Odoo API
Join our community

Actions20

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, 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.
  • Enriching Odoo contacts with additional data collected elsewhere.

Example use case:
When a new lead is captured on your website, use this node to automatically create a corresponding contact in Odoo, including their address and contact details.

Properties

Name Type Meaning
Name String The full name of the contact. This is a required field.
Additional Fields Collection Optional fields to further describe the contact. Includes:
— Address Collection Structured address information.
—— City String The city part of the contact's address.
—— Country Name or ID Options The country, selectable from a list or by specifying an ID/expression.
—— State Name or ID Options The state/region, selectable from a list or by specifying an ID/expression.
—— Street String The street address.
—— Street 2 String Additional street address information.
—— Zip Code String Postal code.
— Email String Contact's email address.
— Internal Notes String Any internal notes about the contact.
— Job Position String The job title or position of the contact.
— 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 the created contact record as a JSON object.
The structure typically includes all the fields sent in the request, along with any additional fields returned by Odoo (such as the unique contact ID and system-generated metadata).

Example output:

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

Note: The actual output fields may vary depending on your Odoo configuration.

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 cause errors.
  • Field Mapping Errors: Ensure that option fields like "Country Name or ID" and "State Name or ID" 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.
  • "Cannot read property '...' of undefined": Likely due to missing or incorrectly structured input properties.

Links and References

Discussion