Connect Ghost

Ghost needs your site URL and an Admin API key from a custom integration created under Settings, Advanced, Integrations. It must be the Admin API key, not the Content API key.

Last updated 1 day ago

Ghost is one of the quicker integrations to set up. Two fields, and one thing to get right.

Available on every plan.

What you Need

  • A Ghost site.
  • A custom integration with an Admin API key.

The One Thing to Get Right

Ghost gives you two keys for every custom integration: a Content API key and an Admin API key.

You need the Admin API key. The Content API key is read-only and cannot create posts.

This is the most common reason a Ghost connection fails. The Admin API key has two parts separated by a colon, in the form 6a1b…:9f2c…. If your key has no colon in it, you have the wrong one.

Step 1: Create a Custom Integration

In Ghost, open Settings → Advanced → Integrations. Create a custom integration named NarraSEO, then copy its Admin API key.

Step 2: Enter the Credentials

  1. Open Sidebar → Integrations.
  2. Find Ghost under Publishing & CMS.
  3. Fill in the two fields:

Field

What to enter

Ghost site URL

Your Ghost site address, for example https://blog.example.com. NarraSEO adds the Admin API path for you.

Admin API key

The key from step 1, including the colon

  1. Select Connect Ghost.

Enter only your site address. Do not append /ghost/api/admin yourself, since NarraSEO adds the path.

Step 3: Verify

Select Verify connection. On success you see "Ghost connection verified."

On failure: "Could not verify the Ghost connection. Check the site address and Admin API key."

Publishing Options

Ghost uses Draft, Publish now, and Schedule, with a Publish date and time field, plus the Featured image and Article title toggles.

If it Will Not Connect

You have the Content API key. Check for the colon. This is the answer most of the time.

The site URL is wrong. Use the address you log in at. If Ghost is on a subdomain such as blog.example.com, use that rather than the root domain.

You added the API path. Enter the site address only.

The integration was deleted. Deleting the custom integration in Ghost revokes the key.

Notes

Ghost custom integration keys can be revoked by deleting the integration.

Ghost renders content in its own editor format. Headings, lists, links, images, and tables all come through, though the exact rendering depends on your Ghost theme.

The connection is per project.

Both Ghost Pro and self-hosted Ghost work the same way, since both expose the Admin API.