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

# Ghost

> Send Content Agent articles into your Ghost site as draft posts, per brand. 3RD never publishes or sends newsletters.

Connect Ghost and the [Content Agent](https://docs.get3rd.com/actions/content-agent.md) can send a finished article straight into your Ghost site as a **draft post**. Headings, lists, quotes, links, tables and images come across with it. Your team reviews the draft in Ghost and publishes it there.

> [!NOTE]
>
> The Ghost integration is in **Beta**. Connect it per brand; nothing is shared across brands.

## Before you start

* Your organization needs an **active 3RD subscription** with the Content Agent.
* You need **edit access** to the brand in 3RD. View-only members don't see the **Connect** button.
* You connect **per brand**. Each brand links its own Ghost site.
* In Ghost, only the site's **Owner** or an **Administrator** can add the integration 3RD uses.

## Connect Ghost

**1. Open Integrations**

In 3RD, open **Settings → Integrations** for the brand.

**2. Click Connect**

In the **Ghost** row, click **Connect**. The **Connect Ghost** window opens. Type your **Ghost site address**, such as `https://example.ghost.io`, and click **Open this page in Ghost** to jump to the integrations settings in Ghost Admin.

**3. Add a custom integration**

In Ghost Admin, click **Settings** (the gear icon at the bottom left), scroll down to **Advanced** and open **Integrations**. Click **Add custom integration**, type `3RD` as the name and click **Add**. Copy the **API URL** and the **Admin API key** that Ghost shows.

**4. Paste your details**

Back in 3RD, click **Next**. Paste the **API URL** (your site address works too) and the **Admin API key**, then click **Connect**. 3RD checks them with your site, and the row shows **Connected**.

If you already have your details, click **I already have my details** to go straight to the fields.

> [!TIP]
>
> Ghost shows two keys. The **Admin API key** is long, with a colon (`:`) in the middle. The shorter **Content API key**, with no colon, is the wrong one.

## What goes into Ghost

There is nothing to set up: every article goes in as a new **post**. 3RD fills these fields:

| In Ghost | From 3RD |
| - | - |
| **Post title** | The article's opening heading, or the piece title when the article has none |
| **Post URL** | The address you set when pushing (the last part, if it has several) |
| **Post body** | The article |
| **Excerpt** | The article's first paragraph |

Images are uploaded to your Ghost site. An image that can't be copied stays a link to its original address, and 3RD tells you how many.

## Push an article to Ghost

**1. Open the article**

In the Content Agent, open a new article (not an optimization of an existing page).

**2. Send it as a draft**

Click **Push to Ghost**. If the brand has more than one CMS connected, the button says **Push to CMS** and you pick **Ghost** in the window. Check the **Address** and click **Send as draft**. 3RD shows **Draft created in Ghost** when it's done.

**3. Review it in Ghost**

Open **Posts** in Ghost Admin. The new post is marked **Draft**.

Pushing the same article again updates the **same draft post** instead of creating a new one, so you can keep editing in 3RD and push again. If the draft was deleted in Ghost, 3RD makes a new one.

## Drafts only

3RD only ever creates or updates **draft** posts. It never publishes, never emails your members or sends a newsletter, and never deletes anything.

Once a post is published, scheduled or sent in Ghost, 3RD leaves it alone. Pushing that article again shows a message asking you to edit it in Ghost.

If someone edits the draft in Ghost while 3RD is sending it, 3RD overwrites nothing and asks you to push again.

## Disconnect

Open the **⋯** menu in the Ghost row and click **Disconnect**. 3RD stops sending anything to Ghost and deletes the key it stored. Posts already in Ghost stay where they are.

Deleting the `3RD` integration in Ghost also removes 3RD's access. The next time 3RD tries to reach your site, the row shows **Reconnect needed**.

## Troubleshooting

| You see | What to do |
| - | - |
| **This is the Content API key** | Paste the **Admin API key** from the integration, not the Content API key. |
| **This is not an Admin API key** | Copy the **Admin API key** from the `3RD` integration in Ghost again. |
| **Ghost refused this key** | Check the key. If the integration was deleted in Ghost, add a new one and connect again. |
| **This doesn't look like a Ghost admin address** | Use the **API URL** Ghost shows next to the key. |
| **Your Ghost site did not answer at this address** | Check the address and try again. |
| **The post changed in Ghost while 3RD was sending it** | Push again. Nothing was overwritten. |
| **Ghost is busy right now** | Wait a minute and push again. |
| A message that the piece was already published, scheduled or sent | Edit the post in Ghost. 3RD doesn't change it. |

## Related

* [Content Agent](https://docs.get3rd.com/actions/content-agent.md): where the articles are written
* [HubSpot](https://docs.get3rd.com/integrations/hubspot.md): the same flow for HubSpot blogs and pages


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.