CMS · Publication

How to Connect Ghost to Writelio

Publish posts to your Ghost publication via the Admin API.

Connect Writelio to Ghost and publish finished posts straight to your publication, including the feature image and meta description. Connection uses a Ghost Admin API key from a custom integration.

Before you start

A Ghost site (Ghost(Pro) or self-hosted).
Owner or Administrator access to create a custom integration.
Your Ghost site served over HTTPS.

What you’ll need from Ghost

Ghost URLYour Ghost site URL, e.g. https://yourblog.ghost.io or your custom domain.

Admin API KeyGhost Admin → Settings → Integrations → Add custom integration. Copy the Admin API Key (format id:secret) — not the Content API key.

Connect Ghost in 4 steps

Create a custom integration in Ghost

In Ghost Admin → Settings → Integrations, click Add custom integration, name it Writelio, and copy the Admin API Key (it looks like 63f...:9a8...).

Add the connection in Writelio

In Integrations, open the Ghost card → Configure, paste your Ghost URL and Admin API Key, and click Save.

Test the connection

In the editor, open Share & Publish → Ghost and click Test to verify access to your publication.

Publish

Click Publish to send the post to Ghost. It is created with your content, and the feature image is set when your banner is a public URL.

What gets published

Publishing to Ghost sends:

Title & HTML content — imported via Ghost’s HTML source so formatting is preserved.
Feature image — set when your article banner is a public URL.
Excerpt / meta description for SEO.

Writelio signs the request with a short-lived JWT generated from your Admin API key, so your secret is never exposed.

Troubleshooting

“401” or signature errors

Make sure you copied the Admin API key (id:secret), not the Content API key. The key must come from a custom integration, and your Ghost URL must include https.

“Unknown Content API Key” error

You pasted the Content API key. Go back to the integration and copy the Admin API Key instead.

Feature image missing

Ghost only accepts a public image URL for the feature image. If your banner is missing or private, no feature image is set.

Frequently asked questions

Which API key do I use?

The Admin API Key (formatted id:secret) from a custom integration — it allows creating posts. The Content API key is read-only and will not work.

Does it work with self-hosted Ghost?

Yes, as long as your site is reachable over HTTPS and the Admin API is enabled (it is by default).

Can I publish as a draft?

Yes — choose the draft option in the publish panel to stage the post in Ghost before it goes live.

More integration guides

WordPressPublish finished, SEO-ready articles straight to your WordPress site.MediumCross-post articles to your Medium profile with a canonical link.HashnodePublish to your Hashnode developer blog via the GraphQL API.