Connecting an Odoo site

Odoo websites connect through Odoo's external API with a username and an API key. Posts are created in one Odoo blog that you choose while connecting. This guide covers the Odoo preparation, the form and what to expect when posts are published.

Before you start

• You are an Owner or Admin of the company in Accounts, or of its agency.

• The Odoo instance runs the Website app with at least one blog.

• You have administrator access in Odoo to create a user and an API key.

• Odoo's external API is reachable at https://your-instance/xmlrpc/2.

Step 1: Create a user for publishing

Create a dedicated Odoo user for the platform and give it access to Website blog posts. Keep its other rights to a minimum.

Step 2: Generate an API key

1. Sign in to Odoo as that user.

2. Open the user's preferences and go to the account security settings.

3. Create a new API key, give it a name such as "UP-TO-DATE" and copy it. Odoo shows it only once.

Step 3: Find the database name

You need the name of the Odoo database. On Odoo Online it is often the first part of the address, such as yourcompany in yourcompany.odoo.com. For other hosting, ask whoever runs the Odoo server.

Step 4: Open Connect a Site

1. In Accounts, go to Companies > open the company > Websites tab.

2. Click Connect a Site. If the company already has sites, click Connect New Site.

3. Under Select your CMS, choose Odoo.

Step 5: Fill in the fields

Step 6: Choose the blog

1. When the URL, database, username and API key are filled in, a Fetch Blogs button appears under Blog Selection.

2. Click Fetch Blogs. You see "Successfully fetched" with the number of blogs found.

3. Choose the blog posts should go into from the list.

Step 7: Test the connection

1. Click Test Connection.

2. The test signs in with the API key and checks that the user can read blog posts.

3. When it passes, you see "Test connection successful! Credentials are valid and have blog access."

Step 8: Connect

1. Make sure a blog is selected. Without one, nothing is saved.

2. Click Connect. The window closes and the site appears in the company's Websites list, named after the blog.

How posts arrive in Odoo

• Each post is created as a new post in the selected blog, with the title, the content and a subtitle (the post's snippet or meta description, or the start of the text).

• Changes to a post that already exists in Odoo are not sent again. Make later edits in Odoo.

• The website is listed with the Odoo instance address and the blog. For the AI Memory crawl, make sure the company's website URL in Accounts is the public website address.

Common errors

Related articles

• Connecting a website: the connection handler step by step

• Required technical access (before you start)

• Testing whether the connection works correctly

• Troubleshooting: website connections and crawls