Publish to Ghost

Create a custom integration

• In Ghost admin, go to Settings → Integrations.
• Hit Add custom integration and give it a name such as blogcms.
• Copy the Admin API key — not the Content API key. It looks like a long id, a colon, then a longer secret.

Connect it

• Site URL — your Ghost address, for example https://blog.example.com
• Admin API key — paste the whole id:secret value.

What gets published

• Title, slug and the full post body. Ghost converts the HTML into its own editor format on arrival.
• Excerpt becomes the post's custom excerpt.
• Tags are created on Ghost if they don't already exist.
• Featured image is set from your post's featured image.
• Meta title, meta description and canonical URL all carry across — Ghost has real fields for these.
• Posts arrive published.

Publishing again

Ghost guards against two people editing the same post at once, so before updating we read the current version and send it back with your changes. If someone edited the post inside Ghost since your last publish, your version wins.

Troubleshooting

• Admin API key must look like id:secret — you've most likely pasted the Content API key.
• Ghost rejected the key — the integration may have been deleted, or the key belongs to a different site.
• Couldn't establish a secure connection — your Ghost site's TLS certificate can't be verified. Self-hosted Ghost behind a misconfigured proxy is the usual cause.
• This works with Ghost 5 and later, self-hosted or Ghost(Pro).