> ## Documentation Index
> Fetch the complete documentation index at: https://docs.salesask.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Odoo

> Connect Odoo CRM to log call notes on Opportunities and pull meetings.

Sales Ask logs call notes and AI summaries as an internal note on the matched Opportunity, pulls Opportunities with their stages and upcoming Meetings, and lets reps create new Opportunities.

## What Sales Ask uses in Odoo

| Object | How Sales Ask uses it |
| - | - |
| Opportunities (`crm.lead`) | Reads Opportunities to match calls and sync value and stage; creates new ones when a rep adds a client |
| Log notes (`mail.message`) | Logs the summary as an internal note in the Opportunity's chatter |
| Meetings (`calendar.event`) | Reads the rep's upcoming Meetings to show their appointments |
| Users (`res.users`) | Matches reps to Odoo users by email or login |
| Stages (`crm.stage`) | Reads pipeline stages so you can map them to open, won, or lost |
| Contacts (`res.partner`) | Finds or creates the company and contact for a new Opportunity |
| Tags (`crm.tag`) | Finds or creates tags for a new Opportunity |
| Sales Teams (`crm.team`) | Looks up the sales team for a new Opportunity |
| Sources (`utm.source`) | Looks up the source for a new Opportunity |
| Activities (`mail.activity`) | Schedules a follow-up To-Do on a new Opportunity, if a reminder is set |

## What you need

* **API Key**
* **Odoo URL**, for example `https://yourcompany.odoo.com`

<Info>
  Sales Ask uses Odoo's JSON-2 external API (`/json/2/`). Odoo includes external API access only on its **Custom** pricing plan. The One App Free and Standard plans don't include it.
</Info>

## Get your API key

Create the key as an Odoo user who can see every salesperson's Opportunities and Meetings, not only their own. Sales Ask reads records for all your reps with this key.

1. In Odoo, click your avatar in the top right and open **My Preferences**.
2. Open the **Account Security** tab and click **New API Key**. Confirm your password if Odoo asks.
3. Enter `Sales Ask` as the description and choose the longest duration available.
4. Click **Generate Key** and copy the key. Odoo shows it only once.

<Warning>
  Odoo API keys expire, and Odoo doesn't allow keys that last longer than three months. Before the key expires, generate a new one and paste it into Sales Ask. Otherwise Odoo starts rejecting requests, and Sales Ask turns the integration off and notifies your admins.
</Warning>

## Connect in Sales Ask

1. Go to **Settings → Integrations** and search for **Odoo**.
2. Paste the API key.
3. Enter your Odoo URL. Enter the base address only, for example `https://yourcompany.odoo.com`, without `/json/2` or any other path. It must start with `https://`.
4. Choose a [matching method](/integrations/overview#matching-method) and click **Save**.

## How it works

* **Reps**: each rep's Sales Ask email must match the email or login of their Odoo user.
* **Opportunities**: Sales Ask reads Opportunities only, not Leads. The deal amount is the Opportunity's expected revenue, and the status is its stage, or **Lost** when the Opportunity is archived.
* **Meetings**: Sales Ask reads calendar meetings where the rep is the organizer or an attendee.
* **Creating Opportunities**: an admin configures the fields reps fill in. New Opportunities start in the first stage of your pipeline.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.