Connecting Joomla

Requirements

• Joomla 4.0 or higher with REST API enabled
• A user account in the Administrator or Super User group

Step 1: Create an API Token in Joomla

1. In the Joomla admin panel, go to Users → Manage
2. Open the administrator user's profile
3. Go to the Joomla API Token tab
4. Click Generate and copy the token

[SCREENSHOT: Joomla user profile → Joomla API Token tab — Generate button and token field]

Step 2: Connect in AI SEO Writer

1. Go to Sites → Add site → Joomla
2. Enter the Site URL (without trailing slash, e.g. https://yoursite.ru)
3. Enter the API Token from step 1
4. Click Test connection
5. Click Save if the test succeeds

[SCREENSHOT: Joomla connection form in AI SEO Writer — URL and API Token fields, Test connection button]

What Happens When Publishing

Articles are created via Joomla's standard REST API as content items (com_content). The default category is "Uncategorised" (ID 2). Cover images are uploaded to the Joomla media library and set as the intro image.

Common Errors

• HTTP 401 Unauthorized — invalid API token. Generate a new one in the Joomla user profile.
• HTTP 403 Forbidden — insufficient user permissions. Make sure the user is in the Administrator or Super User group.
• Cannot connect to site — verify the URL is correct and the site is accessible over HTTPS.
• REST API disabled — in Joomla 4+, the REST API is enabled by default, but some security plugins may block it. Check that the System - Joomla! API Authentication plugin is enabled.