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

# Ghost

> Set up and use the Ghost CMS integration with Hyper AI for blog post automation

The Ghost integration lets your agents and workflows publish, update, and manage content on your Ghost blog — drafts, posts, tags, and images.

Auth type: API key (Admin API key)

<Info>
  For how integrations work overall (permissions, authentication, troubleshooting), see the main guide: [App Integrations](/integrations/overview).
</Info>

## Connect Ghost

1. Go to **Settings → Apps** in Hyper
2. Select **Ghost → Connect New**
3. Provide your Ghost site URL and Admin API key

### Where to find your Ghost Admin API key

1. In your Ghost admin, go to **Settings → Integrations**
2. Click **Add custom integration**
3. Name it "Hyper" and copy the **Admin API Key**
4. Paste it into Hyper along with your site URL (e.g. `https://blog.example.com`)

## Common capabilities

* **Posts** — create, update, delete, list, get by ID, get by slug, publish
* **Tags** — list, create
* **Images** — upload images for use in posts

## Use in Chat

1. In a chat, open the tool selector and enable Ghost
2. Ask your agent to draft and publish

Example prompt:

```text theme={null}
Write a 1,200-word Ghost blog post on "10 prompt patterns for marketing agents." Use my brand voice from the style guide. Tag it with "AI" and "Marketing." Generate a hero image, upload it, and schedule the post to publish tomorrow at 8am.
```

## Use in Agents

In `Agents → Settings`, add Ghost to a content / SEO agent. Toggle approval on `publish` and `delete` if you want a human gate before content goes live.

## Use in Flows

Add Ghost nodes to a content pipeline: research topic → outline → draft → review → upload images → publish.

## Troubleshooting

* **401 unauthorized**: confirm your Admin API key (not the Content API key) and that your site URL is correct (no trailing slash)
* **Image upload failed**: image URLs must be publicly accessible if you're referencing them by URL — uploaded files have stricter size limits
* **Tag not found**: tags are case-sensitive — list existing tags first if you're not sure of the exact slug

***

## Available Actions

Hyper agents can run the following actions for this integration. Each action can be individually set to **Enabled**, **Requires Approval**, or **Disabled** in your agent's toolkit settings.

Actions can be set to one of three control states:

| State                 | Behavior                                                       |
| --------------------- | -------------------------------------------------------------- |
| **Enabled**           | Agent runs the action automatically                            |
| **Requires Approval** | Agent pauses and waits for your confirmation before proceeding |
| **Disabled**          | Action is blocked and cannot be used                           |

Configure these in the agent's toolkit settings or in workspace defaults.

| Action           | Description                                                  |
| ---------------- | ------------------------------------------------------------ |
| Create Post      |                                                              |
| Create Tag       |                                                              |
| Delete Post      | Delete a post from a Ghost CMS site                          |
| Get Post         | Retrieve a single post from a Ghost CMS site by its ID       |
| Get Post By Slug | Retrieve a single post from a Ghost CMS site by its URL slug |
| List Posts       |                                                              |
| List Tags        | List all tags on a Ghost CMS site                            |
| Publish Post     |                                                              |
| Update Post      |                                                              |
| Upload Image     |                                                              |