# FeedHive

> Plan and publish social media posts with FeedHive: create, schedule, update and delete posts, read their analytics, manage labels, see connected social accounts, and fill the posting plan's slots.

App · 20 actions. Web page: https://docs.lodol.com/docs/integrations/feedhive

## Actions

### Create label

Create a label to group posts and posting slots.

**Inputs**

- Title (`title`, text, required): The label's name.

**Outputs**

- `label` (object): The label

**Example output**

```json
{
  "label": {
    "id": "lbl_01HX",
    "title": "Campaign Q4"
  }
}
```

### Create plan slot

Add a posting slot to the plan: a window on a day of the week that drafts can be scheduled into.

**Inputs**

- Day of the week (`week_day`, text, required): The day the slot falls on. One of: `0` (Sunday), `1` (Monday), `2` (Tuesday), `3` (Wednesday), `4` (Thursday), `5` (Friday), `6` (Saturday).
- Starts at (`start_time`, time, required): When the slot opens, in the time zone below.
- Ends at (`end_time`, time, required): When the slot closes. It must be later than it opens.
- Time zone (`timezone`, text): A time zone name such as Europe/Copenhagen. Defaults to your account's.
- Labels (`label_ids`, list): Only posts with one of these labels go in this slot. Leave empty for posts without labels.
- Repeats (`interval`, text): How often the slot comes round. Defaults to weekly. One of: `weekly` (Weekly (default)), `daily`, `monthly`.
- Every how many (`repeat_every`, number): Repeat every this many days, weeks or months. Defaults to 1. At least 1.
- State (`is_active`, text): Whether posts can be put in the slot. Defaults to active. One of: `true` (Active (default)), `false` (Paused).

**Outputs**

- `slot` (object): The plan slot

**Example output**

```json
{
  "slot": {
    "end_time": "14:30",
    "id": "slot_01HX",
    "is_active": true,
    "labels": [
      {
        "id": "lbl_01HX",
        "title": "Campaign Q4"
      }
    ],
    "next_occurrence_at": "2026-10-26T12:30:00.000Z",
    "recurrence": {
      "interval": "weekly",
      "repeat_every": 1
    },
    "start_time": "13:30",
    "timezone": "Europe/Copenhagen"
  }
}
```

### Create post

Create a text post as a draft, or schedule it for some social accounts at a time in the future.

**Inputs**

- Text (`text`, text, required): The text of the post.
- Post to (`accounts`, list): The social accounts to post to. Needed to schedule a post.
- Labels (`labels`, list): The labels to put on the post.
- What to do with it (`status`, text): Save the post as a draft, or schedule it. Scheduling needs 'Post to' and 'Publish at'. One of: `draft` (Save as a draft (default)), `scheduled` (Schedule it).
- Publish at (`scheduled_at`, date and time): When to publish. It must be in the future. Only when What to do with it is Schedule it.
- Notes (`notes`, text): Private notes for your team, not posted.
- Link (`link`, text): A link for the platforms that show one.
- Title (`title`, text): A title for the platforms that show one.

**Outputs**

- `post` (object): The post

**Example output**

```json
{
  "post": {
    "accounts": [
      {
        "board_id": null,
        "id": "social_01HX",
        "platform": "linkedin"
      }
    ],
    "approval": {
      "approved_at": null,
      "is_approved": true,
      "status": "not_required"
    },
    "created_at": "2026-10-15T09:00:00.000Z",
    "id": "post_01HX",
    "labels": [
      {
        "id": "lbl_01HX",
        "title": "Campaign Q4"
      }
    ],
    "link": null,
    "media": [],
    "notes": null,
    "publish_type": "regular",
    "published_at": null,
    "scheduled_at": null,
    "short_link_enabled": false,
    "slot_id": null,
    "status": "draft",
    "text": "Our new feature is live!",
    "title": null,
    "updated_at": "2026-10-15T09:00:00.000Z"
  }
}
```

### Delete label

Delete a label. Posts keep their text but lose the label.

**Inputs**

- Label (`label_id`, text, required): The label. Pick one, or give its id from an earlier step.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `label` (object): The label, as it was
- `label_id` (text): The label deleted

**Example output**

```json
{
  "deleted": true,
  "label": {
    "id": "lbl_01HX",
    "title": "Campaign Q4"
  },
  "label_id": "lbl_01HX"
}
```

### Delete plan slot

Delete a posting slot. Posts already placed in it keep their scheduled times.

**Inputs**

- Slot ID (`slot_id`, text, required): The slot's id, from 'List plan slots' or 'Create plan slot'.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `slot` (object): The slot, as it was
- `slot_id` (text): The slot deleted

**Example output**

```json
{
  "deleted": true,
  "slot": {
    "end_time": "14:30",
    "id": "slot_01HX",
    "is_active": true,
    "labels": [
      {
        "id": "lbl_01HX",
        "title": "Campaign Q4"
      }
    ],
    "next_occurrence_at": "2026-10-26T12:30:00.000Z",
    "recurrence": {
      "interval": "weekly",
      "repeat_every": 1
    },
    "start_time": "13:30",
    "timezone": "Europe/Copenhagen"
  },
  "slot_id": "slot_01HX"
}
```

### Delete post

Delete a post. It no longer appears in FeedHive or in lists.

**Inputs**

- Post ID (`post_id`, text, required): The post's id, from 'List posts', 'Create post' or an earlier step.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `post` (object): The post, as it was
- `post_id` (text): The post deleted

**Example output**

```json
{
  "deleted": true,
  "post": {
    "accounts": [
      {
        "board_id": null,
        "id": "social_01HX",
        "platform": "linkedin"
      }
    ],
    "approval": {
      "approved_at": null,
      "is_approved": true,
      "status": "not_required"
    },
    "created_at": "2026-10-15T09:00:00.000Z",
    "id": "post_01HX",
    "labels": [
      {
        "id": "lbl_01HX",
        "title": "Campaign Q4"
      }
    ],
    "link": null,
    "media": [],
    "notes": null,
    "publish_type": "regular",
    "published_at": null,
    "scheduled_at": null,
    "short_link_enabled": false,
    "slot_id": null,
    "status": "draft",
    "text": "Our new feature is live!",
    "title": null,
    "updated_at": "2026-10-15T09:00:00.000Z"
  },
  "post_id": "post_01HX"
}
```

### Get account

Check the API key and get the name of the FeedHive account or workspace it belongs to.

**Inputs**: None.

**Outputs**

- `account` (object): The account

**Example output**

```json
{
  "account": {
    "status": "ok",
    "token": "fh_EQiI8n**********************",
    "username": "My FeedHive Account"
  }
}
```

### Get label

Get one label by its id.

**Inputs**

- Label (`label_id`, text, required): The label. Pick one, or give its id from an earlier step.

**Outputs**

- `label` (object): The label

**Example output**

```json
{
  "label": {
    "id": "lbl_01HX",
    "title": "Campaign Q4"
  }
}
```

### Get plan slot

Get one posting slot with its times, labels and repeat.

**Inputs**

- Slot ID (`slot_id`, text, required): The slot's id, from 'List plan slots' or 'Create plan slot'.

**Outputs**

- `slot` (object): The plan slot

**Example output**

```json
{
  "slot": {
    "end_time": "14:30",
    "id": "slot_01HX",
    "is_active": true,
    "labels": [
      {
        "id": "lbl_01HX",
        "title": "Campaign Q4"
      }
    ],
    "next_occurrence_at": "2026-10-26T12:30:00.000Z",
    "recurrence": {
      "interval": "weekly",
      "repeat_every": 1
    },
    "start_time": "13:30",
    "timezone": "Europe/Copenhagen"
  }
}
```

### Get post

Get one post with its text, state, accounts, labels and publish time.

**Inputs**

- Post ID (`post_id`, text, required): The post's id, from 'List posts', 'Create post' or an earlier step.

**Outputs**

- `post` (object): The post

**Example output**

```json
{
  "post": {
    "accounts": [
      {
        "board_id": null,
        "id": "social_01HX",
        "platform": "linkedin"
      }
    ],
    "approval": {
      "approved_at": null,
      "is_approved": true,
      "status": "not_required"
    },
    "created_at": "2026-10-15T09:00:00.000Z",
    "id": "post_01HX",
    "labels": [
      {
        "id": "lbl_01HX",
        "title": "Campaign Q4"
      }
    ],
    "link": null,
    "media": [],
    "notes": null,
    "publish_type": "regular",
    "published_at": null,
    "scheduled_at": null,
    "short_link_enabled": false,
    "slot_id": null,
    "status": "draft",
    "text": "Our new feature is live!",
    "title": null,
    "updated_at": "2026-10-15T09:00:00.000Z"
  }
}
```

### Get post analytics

Get the numbers (impressions, likes, comments, clicks and so on) FeedHive has for a published post on each platform.

**Inputs**

- Post ID (`post_id`, text, required): The post's id, from 'List posts', 'Create post' or an earlier step.

**Outputs**

- `count` (number): How many platforms
- `post_id` (text): The post
- `publications` (list): The numbers for each platform the post went to

**Example output**

```json
{
  "count": 1,
  "post_id": "post_01HX",
  "publications": [
    {
      "collected_at": "2026-10-15T09:15:00.000Z",
      "error": null,
      "metrics": {
        "impressions": 1240,
        "likes": 42
      },
      "platform_post_id": "urn:li:share:123",
      "post_id": "post_01HX",
      "provider_type": "LINKEDIN",
      "publication_id": "publication_01HX",
      "social_provider_id": "social_01HX",
      "stale": false,
      "status": "success"
    }
  ]
}
```

### Get social account

Get one connected social account.

**Inputs**

- Social account (`social_id`, text, required): The connected social account. Pick one, or give its id.

**Outputs**

- `social` (object): The social account

**Example output**

```json
{
  "social": {
    "avatar_url": null,
    "display_name": "Jo Bloggs",
    "error_message": null,
    "handle": "jobloggs",
    "id": "social_01HX",
    "platform": "linkedin",
    "status": "active"
  }
}
```

### List labels

List the labels used to group posts. Gets one page; to see more, run it again with the next page it gives.

**Inputs**

- Page size (`limit`, number): How many to return, 1 to 100. FeedHive's default is 20. From 1 to 100.
- Next page cursor (`cursor`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many on this page
- `has_more` (true/false): Whether another page follows
- `labels` (list): The labels
- `next_cursor` (text): Pass as 'cursor' for the next page; empty on the last one
- `total` (number): How many there are in all

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "labels": [
    {
      "id": "lbl_01HX",
      "title": "Campaign Q4"
    }
  ],
  "next_cursor": "",
  "total": 1
}
```

### List plan slots

List the posting slots in the plan, with when each next comes round. Gets one page; to see more, run it again with the next page it gives.

**Inputs**

- Page size (`limit`, number): How many to return, 1 to 100. FeedHive's default is 20. From 1 to 100.
- Next page cursor (`cursor`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many on this page
- `has_more` (true/false): Whether another page follows
- `next_cursor` (text): Pass as 'cursor' for the next page; empty on the last one
- `slots` (list): The plan slots
- `total` (number): How many there are in all

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "next_cursor": "",
  "slots": [
    {
      "end_time": "14:30",
      "id": "slot_01HX",
      "is_active": true,
      "labels": [
        {
          "id": "lbl_01HX",
          "title": "Campaign Q4"
        }
      ],
      "next_occurrence_at": "2026-10-26T12:30:00.000Z",
      "recurrence": {
        "interval": "weekly",
        "repeat_every": 1
      },
      "start_time": "13:30",
      "timezone": "Europe/Copenhagen"
    }
  ],
  "total": 1
}
```

### List posts

List posts, newest first, optionally only those in some states or with some labels or accounts. Gets one page; to see more, run it again with the next page it gives.

**Inputs**

- Status (`status`, list): Only posts in these states. Leave empty for every state. One or more of: `draft`, `scheduled`, `publishing`, `published`, `failed`.
- Labels (`labels`, list): Only posts with at least one of these labels.
- Social accounts (`socials`, list): Only posts for at least one of these accounts.
- Page size (`limit`, number): How many to return, 1 to 100. FeedHive's default is 20. From 1 to 100.
- Next page cursor (`cursor`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many on this page
- `has_more` (true/false): Whether another page follows
- `next_cursor` (text): Pass as 'cursor' for the next page; empty on the last one
- `posts` (list): The posts
- `total` (number): How many there are in all

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "next_cursor": "",
  "posts": [
    {
      "accounts": [
        {
          "board_id": null,
          "id": "social_01HX",
          "platform": "linkedin"
        }
      ],
      "approval": {
        "approved_at": null,
        "is_approved": true,
        "status": "not_required"
      },
      "created_at": "2026-10-15T09:00:00.000Z",
      "id": "post_01HX",
      "labels": [
        {
          "id": "lbl_01HX",
          "title": "Campaign Q4"
        }
      ],
      "link": null,
      "media": [],
      "notes": null,
      "publish_type": "regular",
      "published_at": null,
      "scheduled_at": null,
      "short_link_enabled": false,
      "slot_id": null,
      "status": "draft",
      "text": "Our new feature is live!",
      "title": null,
      "updated_at": "2026-10-15T09:00:00.000Z"
    }
  ],
  "total": 1
}
```

### List social accounts

List the social accounts connected to FeedHive, with their platform, handle and whether they are working.

**Inputs**: None.

**Outputs**

- `count` (number): How many on this page
- `has_more` (true/false): Whether another page follows
- `next_cursor` (text): Pass as 'cursor' for the next page; empty on the last one
- `socials` (list): The social accounts
- `total` (number): How many there are in all

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "next_cursor": "",
  "socials": [
    {
      "avatar_url": null,
      "display_name": "Jo Bloggs",
      "error_message": null,
      "handle": "jobloggs",
      "id": "social_01HX",
      "platform": "linkedin",
      "status": "active"
    }
  ],
  "total": 1
}
```

### Rename label

Give a label a new title.

**Inputs**

- Label (`label_id`, text, required): The label. Pick one, or give its id from an earlier step.
- New title (`title`, text, required): The label's new name.

**Outputs**

- `label` (object): The label

**Example output**

```json
{
  "label": {
    "id": "lbl_01HX",
    "title": "Campaign Q1"
  }
}
```

### Schedule drafts into plan slots

Put draft posts into the next free plan slots that match their labels. Each draft needs at least one social account. The result says, for each post, whether it was scheduled and why not.

**Inputs**

- Draft post IDs (`post_ids`, list, required): The ids of the draft posts, up to 50.

**Outputs**

- `assigned` (number): How many were scheduled into a slot
- `count` (number): How many posts were tried
- `results` (list): One result per post

**Example output**

```json
{
  "assigned": 1,
  "count": 1,
  "results": [
    {
      "data": {
        "accounts": [
          {
            "board_id": null,
            "id": "social_01HX",
            "platform": "linkedin"
          }
        ],
        "approval": {
          "approved_at": null,
          "is_approved": true,
          "status": "not_required"
        },
        "created_at": "2026-10-15T09:00:00.000Z",
        "id": "post_01HX",
        "labels": [
          {
            "id": "lbl_01HX",
            "title": "Campaign Q4"
          }
        ],
        "link": null,
        "media": [],
        "notes": null,
        "publish_type": "regular",
        "published_at": null,
        "scheduled_at": null,
        "short_link_enabled": false,
        "slot_id": null,
        "status": "scheduled",
        "text": "Our new feature is live!",
        "title": null,
        "updated_at": "2026-10-15T09:00:00.000Z"
      },
      "message": null,
      "post_id": "post_01HX",
      "success": true
    }
  ]
}
```

### Update plan slot

Change a posting slot's day, times, time zone, labels, repeat or state. Only the fields you fill in change.

**Inputs**

- Slot ID (`slot_id`, text, required): The slot's id, from 'List plan slots' or 'Create plan slot'.
- Day of the week (`week_day`, text): The day the slot falls on. Leave empty to keep it. One of: `0` (Sunday), `1` (Monday), `2` (Tuesday), `3` (Wednesday), `4` (Thursday), `5` (Friday), `6` (Saturday).
- Starts at (`start_time`, time): When the slot opens, in the time zone below. Leave empty to keep it.
- Ends at (`end_time`, time): When the slot closes. It must be later than it opens. Leave empty to keep it.
- Time zone (`timezone`, text): A time zone name such as Europe/Copenhagen. Defaults to your account's. Leave empty to keep it.
- Labels (`label_ids`, list): Only posts with one of these labels go in this slot. Leave empty for posts without labels. Leave empty to keep it.
- Repeats (`interval`, text): How often the slot comes round. Defaults to weekly. Leave empty to keep it. One of: `weekly` (Weekly (default)), `daily`, `monthly`.
- Every how many (`repeat_every`, number): Repeat every this many days, weeks or months. Defaults to 1. Leave empty to keep it. At least 1.
- State (`is_active`, text): Whether posts can be put in the slot. Defaults to active. Leave empty to keep it. One of: `true` (Active (default)), `false` (Paused).

**Outputs**

- `slot` (object): The plan slot

**Example output**

```json
{
  "slot": {
    "end_time": "14:30",
    "id": "slot_01HX",
    "is_active": false,
    "labels": [
      {
        "id": "lbl_01HX",
        "title": "Campaign Q4"
      }
    ],
    "next_occurrence_at": "2026-10-26T12:30:00.000Z",
    "recurrence": {
      "interval": "weekly",
      "repeat_every": 1
    },
    "start_time": "13:30",
    "timezone": "Europe/Copenhagen"
  }
}
```

### Update post

Change a post's text, accounts, labels, state, publish time, notes, link or title. Only the fields you fill in change; a list such as labels replaces the old one.

**Inputs**

- Post ID (`post_id`, text, required): The post's id, from 'List posts', 'Create post' or an earlier step.
- Text (`text`, text): New text for the post. Leave empty to keep it.
- Post to (`accounts`, list): The new list of accounts, replacing the old. Leave empty to keep it.
- Labels (`labels`, list): The new list of labels, replacing the old. Leave empty to keep it.
- What to do with it (`status`, text): Change it to a draft, or schedule it. Leave empty to keep it. One of: `draft` (Save as a draft (default)), `scheduled` (Schedule it).
- Publish at (`scheduled_at`, date and time): A new time to publish, in the future. Leave empty to keep it.
- Notes (`notes`, text): New private notes. Leave empty to keep them.
- Link (`link`, text): A new link. Leave empty to keep it.
- Title (`title`, text): A new title. Leave empty to keep it.

**Outputs**

- `post` (object): The post

**Example output**

```json
{
  "post": {
    "accounts": [
      {
        "board_id": null,
        "id": "social_01HX",
        "platform": "linkedin"
      }
    ],
    "approval": {
      "approved_at": null,
      "is_approved": true,
      "status": "not_required"
    },
    "created_at": "2026-10-15T09:00:00.000Z",
    "id": "post_01HX",
    "labels": [
      {
        "id": "lbl_01HX",
        "title": "Campaign Q4"
      }
    ],
    "link": null,
    "media": [],
    "notes": null,
    "publish_type": "regular",
    "published_at": null,
    "scheduled_at": null,
    "short_link_enabled": false,
    "slot_id": null,
    "status": "draft",
    "text": "Our new feature is live!",
    "title": null,
    "updated_at": "2026-10-15T09:00:00.000Z"
  }
}
```
