Magento - How to connect Magento to Convert AI?

What you need

• Magento base URL (https://your-site.com)

• A Magento admin user (username + password) with permission to manage CMS Pages.
  (Create a new user for Convert AI(ex: convert-ai) to keep separate concerns, and assign the ‘Administrator’ role to the user.

Connect in Convert AI

• Settings → Integrations → Magento

• Enter base URL, admin username, password

• Verify Connection → Save Connection Details

What happens

• We auth via /rest/V1/integration/admin/token

• We publish CMS Pages via /rest/V1/cmsPage (create) or /rest/V1/cmsPage/{id} (update)

• Published URL = {base_url}/{identifier} (slug from title)

Make it work reliably

• Ensure your server can reach https://your-site.com/rest/V1/

• If staging uses self‑signed certs, we auto‑retry once without SSL verification (prod should use valid TLS)

• If the page doesn’t show, flush Magento cache: System → Cache Management → Flush Magento Cache

Common gotchas

• 401/Unauthorized: wrong creds or role lacks CMS Page permissions

• Route errors: confirm /rest/V1 is accessible (WAF/CDN allowlist may be needed)

• No URL returned: publish succeeded but cache not flushed or custom rewrites in place