Connect Odoo
This article shows you how to create an Odoo API key, connect Odoo Email Marketing to PlayerMagick, add the emails a gate collects to a mailing list with tags, and keep the key working when it expires.
Available on: Pro, Business and Agency plans.
Before you start
- You need Odoo with the Email Marketing app: Odoo Online, Odoo.sh or your own server, version 16 or later.
- On Odoo Online, other apps can use Odoo only on Odoo's Custom plan.
- Your own server must be reachable at an https:// address (port 443). Private addresses (like
192.168.…orlocalhost) are refused. - Use an Odoo user with Email Marketing rights. We recommend a user just for PlayerMagick.
- Only the PlayerMagick account owner or an admin can connect Odoo. See Understand team roles.
Odoo's menus differ a little between versions. If a label below does not match exactly, look for the closest one.
Step 1: Create an API key in Odoo
- In Odoo, click your avatar and open My Preferences (or Preferences).
- Open the Account Security tab and click New API Key.
- Name it
PlayerMagickand choose how long it lasts. Odoo keys last at most 3 months: note the date. - Copy the key. Odoo shows it only once.
Step 2: Connect Odoo in PlayerMagick
- Go to Settings → Integrations.
- Click Connect an email tool and choose Odoo.
- Type the Address of your installation, for example
https://yourcompany.odoo.com. - Type the Database. On Odoo Online it is the name before
.odoo.com. - Type the User login of the key's user (needed for Odoo 16 to 18; Odoo 19 and later do without it).
- Paste the API key and choose Key expires on: the date you chose in Odoo.
- Click Test and connect.
When the key expires
PlayerMagick emails the owner and admins once 14 days and once 3 days before the date you entered, and once on that date, and the card shows a warning. Create a new key in Odoo, then click Replace key on the card and paste it with its new date. If Odoo refuses a key early (it was revoked, or the date was wrong), the card says: "Your Odoo key expired or was revoked."
Step 3: Choose a list and tags for a gate
- Open your video, click the Interactions tab and click the email gate.
- Under Send leads to, choose Odoo and a List (a mailing list).
- Add up to 5 Tags if you like. A tag that does not exist yet is created.
- Click Save destination.
- Confirmation emails: Odoo Email Marketing has no double opt-in for other apps: people are added at once.
Start Odoo Marketing Automation from what people watch
Odoo's Marketing Automation (an Odoo Enterprise app) starts campaigns on a filter. Make your campaign filter on a tag, and add that tag with Add tag in PlayerMagick. Remove the tag to make people stop matching.
Other actions for Odoo: Remove tag, Add to a list, Remove from a list and Update a field (your own fields on mailing contacts, whose technical names start with x_; date fields take dates like 2026-10-28). Remove from a list never erases that someone unsubscribed from the list.
Recognise viewers from your Odoo emails
Odoo numbers its contacts in order, so the number is easy to guess. PlayerMagick uses its own random ID in a field called x_pm_id on mailing contacts:
- With an administrator's key, PlayerMagick creates the field itself. Otherwise, an administrator adds it once: turn on developer mode, go to Settings → Technical → Fields, and create a field named
x_pm_id(type Char) on the model Mailing Contact. - In Automations → Recognise viewers from your emails, choose Odoo and click Fill it for my existing contacts.
- In your mailing, add a link whose address ends with the dynamic placeholder for the field, so it reads:
?pm_od={{ object.x_pm_id }}.
Send yourself a real mailing and use Check a link.
Good to know
- Someone on Odoo's blacklist, or who unsubscribed from the list, is never added again. Leads shows Not added.
- Safety: PlayerMagick checks the address before every request, never follows a redirect, and never shows what your server answered in an error.
Error messages
| Message | What to do |
|---|---|
| "Your Odoo key expired or was revoked. Create a new one and paste it here." | Create a new API key in Odoo and paste it, with its new date. Also check the Database and User login. |
| "Your Odoo is version 16, 17 or 18: it also needs the user login of the key’s user." | Type the User login of the user who created the key, then try again. |
| "This key can’t read your lists. Use a key of a user who can manage contacts." | Give the key's user Email Marketing rights. On Odoo Online, check that your plan is Custom. |
| "Use the https:// address of your installation (a public address, port 443)." | Type the https address your browser uses for Odoo. |
| "Odoo didn’t answer. Try again in a minute." | Check that Odoo is online at that address, then try again. |
All statuses and fixes: Fix an email tool error.