Ghost Integration Guide

Connect Ghost so Nuwtonic can sync posts and pages, publish generated content, and apply approved optimization updates through the Ghost Admin API.

Related docs: User Guide · Ghost docs: Admin API

1. What this integration does

With Ghost connected, Nuwtonic can:

• sync posts and pages from your Ghost publication;
• publish generated articles into Ghost;
• apply approved content or SEO-related updates through the Admin API;
• keep one active CMS connection for the workspace.

You connect with:

1. Admin API Key (id:secret)
2. API URL (your Ghost site base URL)

2. Before you start

1. You have Ghost Admin access for the publication.
2. The Ghost site is reachable over HTTPS.
3. You can open Settings → Integrations in Ghost Admin.
4. No other CMS integration is active on the same Nuwtonic workspace.

Works with Ghost(Pro) and self-hosted Ghost. Creating a custom integration is what grants API access.

3. Create a Ghost custom integration

1. Open Ghost Admin (https://your-site.com/ghost).
2. Open Settings.
3. Open Integrations.
4. Under Custom integrations, select Add custom integration.
5. Name it Nuwtonic (or another clear name).
6. Create the integration.
7. Copy these two values:

Important:

• Use the Admin API Key, not the Content API Key.
• The Admin API Key always contains a colon.
• Use the site base URL, not /ghost and not a trailing path such as /ghost/api/admin/.

Official reference: Ghost Admin API authentication.

4. Connect Ghost in Nuwtonic

1. Open the workspace.
2. Go to Integrations.
3. Find Ghost and select Connect.
4. Paste the Admin API Key.
5. Paste the API URL.
6. Select Connect.
7. Confirm Ghost shows as Connected.

Recommended API URL format:

https://your-publication.com

Avoid:

https://your-publication.com/ghost
https://your-publication.com/ghost/api/admin/
https://your-publication.com/

If your Ghost admin domain differs from the public domain, use the Admin API URL Ghost shows on the integration screen.

5. Publishing and SEO fixes

Publish content

1. Finalize an article in Nuwtonic Content Generation.
2. Publish through the Ghost integration.
3. Open Ghost Admin and confirm the post was created or updated.
4. Verify status (draft vs published) matches what you intended.
5. Open the public URL and review the content.

Apply fixes

1. Run an audit or agent in Nuwtonic.
2. Approve the changes you want.
3. Push the fix through Ghost.
4. Confirm the post fields and live page updated correctly.

Start with a draft or low-traffic post the first time.

6. Troubleshooting

Invalid Admin API Key

• Confirm you copied the Admin key, not the Content key.
• Confirm the value includes the colon between id and secret.
• Regenerate the key in Ghost if it was rotated, then update Nuwtonic.

API URL rejected or connection fails

• Use the base site URL shown by Ghost on the integration page.
• Confirm the site is publicly reachable over HTTPS.
• Remove trailing slashes and /ghost path segments.
• For self-hosted Ghost, confirm reverse-proxy rules allow Admin API requests.

Posts not appearing

• Confirm Ghost is still Connected in Nuwtonic.
• Confirm you are looking at the same Ghost site you connected.
• Check whether the post was created as draft.
• Retry with one short test post.

Permission or JWT errors

Ghost Admin API keys are turned into short-lived JWTs by the integration layer. If requests suddenly fail after a key rotation, paste the new Admin API Key into Nuwtonic and reconnect.

7. Production checklist

• Custom integration created in Ghost
• Admin API Key copied in full
• API URL set to the site base URL
• Ghost connected in Nuwtonic
• Test post published or updated successfully
• Live URL verified

8. Next steps

• Continue with the User Guide for content and SEO workflows.
• Keep Google Search Console connected for search performance.
• Use Webhooks if you need a custom non-Ghost receiver.