> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chatfeatured.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ghost Integration

> Publish articles directly from ChatFeatured to your Ghost blog

The ChatFeatured Ghost integration allows you to publish articles directly to your Ghost publication. Authenticate with your Ghost Admin API Key, then publish articles with a single click.

**Status:** Available | **Setup time:** 10 minutes | **Complexity:** Beginner

## Why Ghost?

Ghost is a membership and newsletter platform built for content creators. The ChatFeatured integration lets you publish blog articles while maintaining Ghost's email newsletter features and membership tiers.

<Info>
  Ghost's API supports memberships, newsletters, and paywalls natively. Once you publish from ChatFeatured, you can immediately configure member access levels and email distribution directly in Ghost.
</Info>

***

## Setup Instructions

### Step 1: Open Your Ghost Admin

1. Go to your **Ghost admin dashboard** at `yourblog.ghost.io/ghost`
2. Log in with your Ghost account

### Step 2: Create a Custom Integration

1. Navigate to **Settings → Integrations**
2. Scroll down and click **"Add custom integration"**
3. Enter name: **"ChatFeatured"**
4. Click **"Create"**

### Step 3: Copy Your Admin API Key

1. In the custom integration details, find the **"Admin API Key"** field
2. Click **"Reveal"** to show the key
3. Copy the entire key

The format should be: `64a1b2c3d4e5...abc:def123gh456`

<Warning>
  **Critical API Key Format:** The Admin API Key MUST be in the format `{id}:{secret}` with a colon separating ID and secret. If the key doesn't contain a colon, you may have copied the **Content API Key by mistake**. Always use the Admin API Key for publishing.
</Warning>

### Step 4: Connect in ChatFeatured

1. In ChatFeatured, go to **Integrations → Ghost**
2. Enter your **Ghost Site URL** (e.g., `https://yourblog.ghost.io`)
3. Paste your **Admin API Key** from Step 3
4. Click **"Test Connection"** to verify
5. Click **"Connect Ghost"** to save

<Tip>
  Test the connection before publishing to ensure your API Key is correct. This saves time debugging later.
</Tip>

Once connected, your Ghost site will appear as a publish destination.

***

## Publishing Articles

### Publish an Article

1. In ChatFeatured, click **Publish** on your article
2. Select **Ghost** as the destination
3. Configure publishing options:
   * **Site URL:** Your Ghost domain (auto-filled)
   * **Admin API Key:** Your authentication key (auto-filled)
   * **Title:** Article title
   * **Content:** Article body
4. Click **"Publish to Ghost"** to save

Your article will be created as a **draft** in Ghost and appear in your admin dashboard.

<Tip>
  Articles always publish as drafts first. This lets you review them in Ghost before making them live. You maintain full control over when to publish.
</Tip>

### Edit in Ghost

After publishing from ChatFeatured:

1. Log into your **Ghost admin**
2. Go to **Posts** (or **Pages** if you published as a page)
3. Click your article to edit
4. Configure:
   * **Publish status:** Schedule or publish immediately
   * **Featured image:** Add cover image
   * **Tags:** Organize your content
   * **Excerpt:** Set custom summary
   * **Access level:** Public, Members-only, or Paid members
5. Click **"Publish"** when ready

***

## Advanced Features

### Membership Tiers

Ghost natively supports membership and paywalls. After publishing from ChatFeatured:

1. Edit the article in Ghost
2. Set **Access level** to:
   * **Public** — Everyone can read
   * **Members only** — Logged-in members
   * **Paid members only** — Paid subscribers

<Info>
  This is where Ghost shines for creators—set paywall access right in the article editor. Articles published from ChatFeatured can immediately be configured for paid membership tiers.
</Info>

### Email Newsletter

Ghost automatically sends articles to your newsletter subscribers:

1. Configure newsletter settings in Ghost admin
2. Published articles automatically get email distribution
3. Subscribers receive notifications of new posts

<Tip>
  Make sure articles are **published** (not draft) for newsletter distribution to trigger. Draft articles won't be sent to your subscriber list.
</Tip>

### Social Sharing

Ghost auto-generates social media cards. Customize the preview:

1. Edit article in Ghost
2. Click **"SEO"** tab
3. Set custom **meta description** and **social preview image**

***

## Troubleshooting

<Accordion title="'Connection Failed' Error">
  **Cause:** Invalid site URL or incorrect Admin API Key

  **Solution:**

  * Verify Ghost site URL matches exactly (e.g., `https://yourblog.ghost.io`)
  * Ensure Admin API Key includes both ID and secret with colon separator (`id:secret`)
  * Generate a new API Key in Ghost Settings → Integrations
  * Check that you copied the **Admin API Key**, not Content API Key
</Accordion>

<Accordion title="'Invalid API Key Format' Error">
  **Cause:** Key is missing the ID:secret separator

  **Solution:**

  * Admin API Key must contain a colon (`:`) in the middle
  * Format should be: `64a1b2c3d4e5...abc:def123gh456`
  * If your key doesn't have a colon, regenerate it in Ghost
  * You may have copied the wrong key type (use Admin, not Content)
</Accordion>

<Accordion title="Article Not Appearing in Ghost">
  **Cause:** API Key invalid or permissions insufficient

  **Solution:**

  * Test connection in ChatFeatured settings
  * Verify API Key hasn't expired (regenerate if needed)
  * Check your Ghost user role has admin or editor permissions
  * Try publishing a new test article
  * Check Ghost admin to see if article appears as draft
</Accordion>

<Accordion title="'Permission Denied' Error">
  **Cause:** API Key lacks proper permissions

  **Solution:**

  * Only Admin API Keys work (not Content API Keys)
  * Regenerate the API Key in Ghost Settings
  * Ensure the integration has full access permissions
  * Verify your Ghost user has admin-level permissions
</Accordion>

<Accordion title="Featured Image Not Syncing">
  **Cause:** Image URL not accessible to Ghost

  **Solution:**

  * Image URLs must be publicly accessible
  * Avoid using local file URLs or blocked CDNs
  * Upload featured image directly in Ghost after publishing
  * Check image URL doesn't contain authentication or special characters
</Accordion>

<Accordion title="Newsletter Not Sending After Publishing">
  **Cause:** Article is draft or newsletter not configured

  **Solution:**

  * Check if article is **published** (not draft)—draft articles don't auto-send
  * Verify newsletter settings are enabled in Ghost admin
  * Check that subscribers are configured
  * Manually send newsletter in Ghost if auto-send isn't working
</Accordion>

<Accordion title="Tags Not Appearing on Published Article">
  **Cause:** Ghost doesn't auto-create tags via API

  **Solution:**

  * Create tags manually in Ghost admin first
  * Tag articles after publishing in the Ghost editor
  * ChatFeatured can't create new tags automatically
  * Consider using categories or custom fields as alternatives
</Accordion>

<Accordion title="API Key Keeps Expiring or Becoming Invalid">
  **Cause:** Ghost may have revoked or reset the key

  **Solution:**

  * Ghost Admin API Keys don't expire automatically
  * If token fails, regenerate a new one in Settings → Integrations
  * Update the new key in ChatFeatured
  * Verify the new key includes both ID and secret with colon separator
</Accordion>

***

## Best Practices

* Publish as draft first to review in Ghost
* Customize SEO and social settings after publishing
* Keep your Admin API Key secret
* Regenerate API Keys periodically for security
* Test article publishing before creating many

<Warning>
  **Don't** share your Admin API Key\
  **Don't** commit API Key to version control\
  **Don't** use Content API Key (Admin API Key required)\
  **Don't** delete articles from ChatFeatured after publishing (they won't auto-delete from Ghost)
</Warning>

***

## Common Issues

<Accordion title="Can't find Admin API Key">
  Go to **Settings → Integrations**. Create a custom integration if none exists. The Admin API Key will be displayed in the integration details.
</Accordion>

<Accordion title="Articles published but invisible on live site">
  Check if they're **drafted vs published**. Draft articles don't appear on your live site. Go to Ghost admin and click "Publish" to make them visible.
</Accordion>

<Accordion title="Member-only articles showing publicly">
  Verify the article's access level in Ghost:

  1. Edit the article
  2. Check **Access level** dropdown
  3. Ensure it's set to **Members only** or **Paid members only**
  4. Click **Update** to save changes
</Accordion>

***

## Performance Notes

Article publishing typically completes within 5-10 seconds. Ghost will:

* Create article as **draft** (manual publish in Ghost required)
* Generate default featured image placeholder
* Auto-add creation date and metadata
* Queue newsletter if configured

***

## Security Notes

Your Admin API Key grants full access to your Ghost site. Treat it like a password:

* Never share it publicly
* Use environment variables in applications
* Rotate keys if compromised
* Revoke old keys when changing integrations

<Tip>
  Change your Admin API Key every 90 days as a security best practice. This limits exposure if a key is accidentally leaked.
</Tip>

***

## See Also

* [Webflow Integration](/integrations/webflow) — CMS with rich field mapping
* [WordPress Integration](/integrations/wordpress) — Plugin-based publishing
* [REST API](/integrations/rest-api) — Build custom publishing workflows