# Ghost

> Publish and manage a Ghost site: write, schedule, email and update posts, and add and update members. Start a workflow when someone becomes a member or a post is published.

App · 10 actions. Web page: https://docs.lodol.com/docs/integrations/ghost

## Actions

### Add member

Add a free member, or update the member who already has that email.

**Inputs**

- Email (`email`, text, required): Their email address.
- Name (`name`, text): Their name.
- Note (`note`, text): A note only staff see, up to 2000 characters.
- Labels (`labels`, list): Labels to group them by; a new name makes a new label.
- Newsletters (`newsletters`, list): The newsletters they get. Leave empty for the site's default newsletters.
- If they're already a member (`if_exists`, text): Update them with these details, or stop with an error. Defaults to updating them. One of: `update` (Update them), `fail` (Stop with an error). Default: `update`.

**Outputs**

- `created` (true/false): True when a new member was added
- `created_at` (text): When they joined (ISO 8601)
- `email` (text): Their email address
- `id` (text): The member's ID
- `labels` (list): Their labels
- `last_seen_at` (text): When they were last on the site (ISO 8601)
- `name` (text): Their name
- `newsletters` (list): The newsletters they get
- `note` (text): The staff note on them
- `status` (text): free, paid, comped or gift
- `subscribed` (true/false): True when they get at least one newsletter

**Example output**

```json
{
  "created": true,
  "created_at": "2026-10-27T10:05:00.000Z",
  "email": "jamie@example.com",
  "id": "6720f4b2c5b9a2000150e1e7",
  "labels": [
    "VIP"
  ],
  "last_seen_at": "",
  "name": "Jamie",
  "newsletters": [
    "Weekly"
  ],
  "note": "",
  "status": "free",
  "subscribed": true
}
```

### Change member

Change a member's email, name, note, labels or newsletters.

**Inputs**

- Member (`member`, text, required): The member's email address, or their ID.
- New email (`email`, text): A new email address. Leave empty to keep it.
- Name (`name`, text): Their name. Leave empty to keep it.
- Note (`note`, text): A note only staff see, up to 2000 characters. Leave empty to keep it.
- Labels (`labels`, list): Labels to group them by; a new name makes a new label. Replaces their labels. Leave empty to keep it.
- Newsletters (`newsletters`, list): The newsletters they get, replacing their current ones. Leave empty to keep them.

**Outputs**

- `created_at` (text): When they joined (ISO 8601)
- `email` (text): Their email address
- `id` (text): The member's ID
- `labels` (list): Their labels
- `last_seen_at` (text): When they were last on the site (ISO 8601)
- `name` (text): Their name
- `newsletters` (list): The newsletters they get
- `note` (text): The staff note on them
- `status` (text): free, paid, comped or gift
- `subscribed` (true/false): True when they get at least one newsletter

**Example output**

```json
{
  "created_at": "2026-10-27T10:05:00.000Z",
  "email": "jamie@example.com",
  "id": "6720f4b2c5b9a2000150e1e7",
  "labels": [
    "VIP"
  ],
  "last_seen_at": "",
  "name": "Jamie",
  "newsletters": [
    "Weekly"
  ],
  "note": "",
  "status": "free",
  "subscribed": true
}
```

### Change post

Change a post's words, tags or settings, or publish, schedule or unpublish it.

**Inputs**

- Post (`post`, text, required): The post. Pick one, or give its ID.
- Title (`title`, text): The post's title. Leave empty to keep it.
- Content (HTML) (`content`, text): The post's body as HTML, such as <p>Hello</p>. Leave empty to keep it.
- Status (`status`, text): Publish, schedule or unpublish it (draft). Leave empty to keep it. One of: `draft`, `published`, `scheduled` (Scheduled (give a publish time)).
- Publish time (`publish_at`, date and time): When a scheduled post publishes, or the date a published post shows.
- Tags (`tags`, list): Its tags; a new name makes a new tag. Replaces its tags. Leave empty to keep it.
- Authors (`authors`, list): The staff who wrote it. Defaults to the site owner. Leave empty to keep it.
- Excerpt (`excerpt`, text): A short summary shown in lists and previews, up to 300 characters. Leave empty to keep it.
- Feature image (`feature_image`, text): The address of an image to show at the top. Leave empty to keep it.
- Featured (`featured`, true/false): Pin it as a featured post.
- Who can read it (`visibility`, text): Everyone, members, or paid members. Leave empty to keep it. One of: `public` (Everyone), `members` (Members only), `paid` (Paid members only).
- Email it with (`email_newsletter`, text): Also email the post to this newsletter's subscribers when it publishes. Leave empty to not email it.
- Email to (`email_segment`, text): Which subscribers get the email. Defaults to every subscriber. One of: `all` (Every subscriber), `status:free` (Free members), `status:-free` (Paid members). Default: `all`.

**Outputs**

- `authors` (list): Its authors' email addresses
- `created_at` (text): When it was made (ISO 8601)
- `email_status` (text): How its email is going, such as submitted or failed
- `excerpt` (text): Its excerpt
- `feature_image` (text): Its feature image's address
- `featured` (true/false): True when it is featured
- `html` (text): Its content as HTML ('Get post' only)
- `id` (text): The post's ID
- `newsletter` (text): The newsletter it was emailed with; empty if none
- `published_at` (text): When it was or will be published (ISO 8601)
- `slug` (text): Its slug, the end of its address
- `status` (text): draft, published, scheduled or sent
- `tags` (list): Its tags
- `title` (text): Its title
- `updated_at` (text): When it last changed (ISO 8601)
- `url` (text): Its address on the site
- `visibility` (text): public, members or paid

**Example output**

```json
{
  "authors": [
    "editor@example.com"
  ],
  "created_at": "2026-10-27T09:30:00.000Z",
  "email_status": "",
  "excerpt": "What's new this month.",
  "feature_image": "",
  "featured": false,
  "html": "",
  "id": "6720f3a1c5b9a2000150e1d4",
  "newsletter": "",
  "published_at": "2026-10-27T10:00:00.000Z",
  "slug": "october-update",
  "status": "published",
  "tags": [
    "News"
  ],
  "title": "October update",
  "updated_at": "2026-10-27T10:00:00.000Z",
  "url": "https://example.ghost.io/october-update/",
  "visibility": "public"
}
```

### Create post

Write a post as a draft, or publish, schedule or email it.

**Inputs**

- Title (`title`, text, required): The post's title.
- Content (HTML) (`content`, text): The post's body as HTML, such as <p>Hello</p>.
- Status (`status`, text): Draft, published, or scheduled for the publish time. Defaults to draft. One of: `draft`, `published`, `scheduled` (Scheduled (give a publish time)). Default: `draft`.
- Publish time (`publish_at`, date and time): When a scheduled post publishes, or the date a published post shows.
- Tags (`tags`, list): Its tags; a new name makes a new tag.
- Authors (`authors`, list): The staff who wrote it. Defaults to the site owner.
- Excerpt (`excerpt`, text): A short summary shown in lists and previews, up to 300 characters.
- Feature image (`feature_image`, text): The address of an image to show at the top.
- Featured (`featured`, true/false): Pin it as a featured post.
- Who can read it (`visibility`, text): Everyone, members, or paid members. Defaults to everyone. One of: `public` (Everyone), `members` (Members only), `paid` (Paid members only). Default: `public`.
- Email it with (`email_newsletter`, text): Also email the post to this newsletter's subscribers when it publishes. Leave empty to not email it.
- Email to (`email_segment`, text): Which subscribers get the email. Defaults to every subscriber. One of: `all` (Every subscriber), `status:free` (Free members), `status:-free` (Paid members). Default: `all`.

**Outputs**

- `authors` (list): Its authors' email addresses
- `created_at` (text): When it was made (ISO 8601)
- `email_status` (text): How its email is going, such as submitted or failed
- `excerpt` (text): Its excerpt
- `feature_image` (text): Its feature image's address
- `featured` (true/false): True when it is featured
- `html` (text): Its content as HTML ('Get post' only)
- `id` (text): The post's ID
- `newsletter` (text): The newsletter it was emailed with; empty if none
- `published_at` (text): When it was or will be published (ISO 8601)
- `slug` (text): Its slug, the end of its address
- `status` (text): draft, published, scheduled or sent
- `tags` (list): Its tags
- `title` (text): Its title
- `updated_at` (text): When it last changed (ISO 8601)
- `url` (text): Its address on the site
- `visibility` (text): public, members or paid

**Example output**

```json
{
  "authors": [
    "editor@example.com"
  ],
  "created_at": "2026-10-27T09:30:00.000Z",
  "email_status": "",
  "excerpt": "What's new this month.",
  "feature_image": "",
  "featured": false,
  "html": "",
  "id": "6720f3a1c5b9a2000150e1d4",
  "newsletter": "",
  "published_at": "2026-10-27T10:00:00.000Z",
  "slug": "october-update",
  "status": "published",
  "tags": [
    "News"
  ],
  "title": "October update",
  "updated_at": "2026-10-27T10:00:00.000Z",
  "url": "https://example.ghost.io/october-update/",
  "visibility": "public"
}
```

### Delete post

Delete a post. It cannot be undone.

**Inputs**

- Post (`post`, text, required): The post. Pick one, or give its ID.

**Outputs**

- `deleted` (true/false): True once deleted
- `id` (text): The deleted post's ID

**Example output**

```json
{
  "deleted": true,
  "id": "6720f3a1c5b9a2000150e1d4"
}
```

### Get member

Get a member by email or ID: their status, labels and newsletters.

**Inputs**

- Member (`member`, text, required): The member's email address, or their ID.

**Outputs**

- `created_at` (text): When they joined (ISO 8601)
- `email` (text): Their email address
- `id` (text): The member's ID
- `labels` (list): Their labels
- `last_seen_at` (text): When they were last on the site (ISO 8601)
- `name` (text): Their name
- `newsletters` (list): The newsletters they get
- `note` (text): The staff note on them
- `status` (text): free, paid, comped or gift
- `subscribed` (true/false): True when they get at least one newsletter

**Example output**

```json
{
  "created_at": "2026-10-27T10:05:00.000Z",
  "email": "jamie@example.com",
  "id": "6720f4b2c5b9a2000150e1e7",
  "labels": [
    "VIP"
  ],
  "last_seen_at": "",
  "name": "Jamie",
  "newsletters": [
    "Weekly"
  ],
  "note": "",
  "status": "free",
  "subscribed": true
}
```

### Get post

Get a post with its content, by its ID or slug.

**Inputs**

- Post (`post`, text, required): The post. Pick one, or give its ID or slug.

**Outputs**

- `authors` (list): Its authors' email addresses
- `created_at` (text): When it was made (ISO 8601)
- `email_status` (text): How its email is going, such as submitted or failed
- `excerpt` (text): Its excerpt
- `feature_image` (text): Its feature image's address
- `featured` (true/false): True when it is featured
- `html` (text): Its content as HTML ('Get post' only)
- `id` (text): The post's ID
- `newsletter` (text): The newsletter it was emailed with; empty if none
- `published_at` (text): When it was or will be published (ISO 8601)
- `slug` (text): Its slug, the end of its address
- `status` (text): draft, published, scheduled or sent
- `tags` (list): Its tags
- `title` (text): Its title
- `updated_at` (text): When it last changed (ISO 8601)
- `url` (text): Its address on the site
- `visibility` (text): public, members or paid

**Example output**

```json
{
  "authors": [
    "editor@example.com"
  ],
  "created_at": "2026-10-27T09:30:00.000Z",
  "email_status": "",
  "excerpt": "What's new this month.",
  "feature_image": "",
  "featured": false,
  "html": "<p>What's new this month.</p>",
  "id": "6720f3a1c5b9a2000150e1d4",
  "newsletter": "",
  "published_at": "2026-10-27T10:00:00.000Z",
  "slug": "october-update",
  "status": "published",
  "tags": [
    "News"
  ],
  "title": "October update",
  "updated_at": "2026-10-27T10:00:00.000Z",
  "url": "https://example.ghost.io/october-update/",
  "visibility": "public"
}
```

### List members

List members, newest first, by name or email, label, status or when they joined.

**Inputs**

- Search (`search`, text): Only members whose name or email has these words.
- Label (`label`, text): Only members with this label.
- Status (`status`, text): Only free, paid or complimentary members. Defaults to any. One of: `any`, `free`, `paid`, `comped` (Complimentary). Default: `any`.
- Joined after (`joined_after`, date and time): Only members who joined after this moment.
- How many (`limit`, number): How many members, newest first. Defaults to 15. From 1 to 100.

**Outputs**

- `count` (number): How many were returned
- `members` (list): The members, newest first
- `total` (number): How many match in all

**Example output**

```json
{
  "count": 1,
  "members": [
    {
      "created_at": "2026-10-27T10:05:00.000Z",
      "email": "jamie@example.com",
      "id": "6720f4b2c5b9a2000150e1e7",
      "labels": [
        "VIP"
      ],
      "last_seen_at": "",
      "name": "Jamie",
      "newsletters": [
        "Weekly"
      ],
      "note": "",
      "status": "free",
      "subscribed": true
    }
  ],
  "total": 1
}
```

### List posts

List posts, newest first, by status, tag or words in the title.

**Inputs**

- Status (`status`, text): Only posts with this status. Defaults to any. One of: `all` (Any status), `published`, `draft`, `scheduled`. Default: `all`.
- Tag (`tag`, text): Only posts with this tag.
- Title contains (`title_contains`, text): Only posts whose title has these words.
- How many (`limit`, number): How many posts, newest first. Defaults to 15. From 1 to 100.

**Outputs**

- `count` (number): How many were returned
- `posts` (list): The posts, newest first
- `total` (number): How many match in all

**Example output**

```json
{
  "count": 1,
  "posts": [
    {
      "authors": [
        "editor@example.com"
      ],
      "created_at": "2026-10-27T09:30:00.000Z",
      "email_status": "",
      "excerpt": "What's new this month.",
      "feature_image": "",
      "featured": false,
      "html": "",
      "id": "6720f3a1c5b9a2000150e1d4",
      "newsletter": "",
      "published_at": "2026-10-27T10:00:00.000Z",
      "slug": "october-update",
      "status": "published",
      "tags": [
        "News"
      ],
      "title": "October update",
      "updated_at": "2026-10-27T10:00:00.000Z",
      "url": "https://example.ghost.io/october-update/",
      "visibility": "public"
    }
  ],
  "total": 1
}
```

### List tags

List the site's tags with how many posts use each.

**Inputs**: None.

**Outputs**

- `count` (number): How many tags
- `tags` (list): The tags, by name

**Example output**

```json
{
  "count": 1,
  "tags": [
    {
      "id": "6720f2c0c5b9a2000150e1c1",
      "name": "News",
      "posts": 12,
      "slug": "news"
    }
  ]
}
```
