FeedHive

App · 20 actions

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.

Actions

ActionWhat it does
Create labelCreate a label to group posts and posting slots.
Create plan slotAdd a posting slot to the plan: a window on a day of the week that drafts can be scheduled into.
Create postCreate a text post as a draft, or schedule it for some social accounts at a time in the future.
Delete labelDelete a label.
Delete plan slotDelete a posting slot.
Delete postDelete a post.
Get accountCheck the API key and get the name of the FeedHive account or workspace it belongs to.
Get labelGet one label by its id.
Get plan slotGet one posting slot with its times, labels and repeat.
Get postGet one post with its text, state, accounts, labels and publish time.
Get post analyticsGet the numbers (impressions, likes, comments, clicks and so on) FeedHive has for a published post on each platform.
Get social accountGet one connected social account.
List labelsList the labels used to group posts.
List plan slotsList the posting slots in the plan, with when each next comes round.
List postsList posts, newest first, optionally only those in some states or with some labels or accounts.
List social accountsList the social accounts connected to FeedHive, with their platform, handle and whether they are working.
Rename labelGive a label a new title.
Schedule drafts into plan slotsPut draft posts into the next free plan slots that match their labels.
Update plan slotChange a posting slot's day, times, time zone, labels, repeat or state.
Update postChange a post's text, accounts, labels, state, publish time, notes, link or title.

Create label

Create a label to group posts and posting slots.

Inputs

TitletitletextRequired
The label's name.

Outputs

labelobject
The label
Example output
{
  "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 weekweek_daytextRequired
The day the slot falls on.One of: 0 (Sunday), 1 (Monday), 2 (Tuesday), 3 (Wednesday), 4 (Thursday), 5 (Friday), 6 (Saturday).
Starts atstart_timetimeRequired
When the slot opens, in the time zone below.
Ends atend_timetimeRequired
When the slot closes. It must be later than it opens.
Time zonetimezonetext
A time zone name such as Europe/Copenhagen. Defaults to your account's.
Labelslabel_idslist
Only posts with one of these labels go in this slot. Leave empty for posts without labels.
Repeatsintervaltext
How often the slot comes round. Defaults to weekly.One of: weekly (Weekly (default)), daily, monthly.
Every how manyrepeat_everynumber
Repeat every this many days, weeks or months. Defaults to 1.At least 1.
Stateis_activetext
Whether posts can be put in the slot. Defaults to active.One of: true (Active (default)), false (Paused).

Outputs

slotobject
The plan slot
Example output
{
  "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

TexttexttextRequired
The text of the post.
Post toaccountslist
The social accounts to post to. Needed to schedule a post.
Labelslabelslist
The labels to put on the post.
What to do with itstatustext
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 atscheduled_atdate and time
When to publish. It must be in the future.Only when What to do with it is Schedule it.
Notesnotestext
Private notes for your team, not posted.
Linklinktext
A link for the platforms that show one.
Titletitletext
A title for the platforms that show one.

Outputs

postobject
The post
Example output
{
  "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

Labellabel_idtextRequired
The label. Pick one, or give its id from an earlier step.

Outputs

deletedtrue/false
Always true once deleted
labelobject
The label, as it was
label_idtext
The label deleted
Example output
{
  "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 IDslot_idtextRequired
The slot's id, from 'List plan slots' or 'Create plan slot'.

Outputs

deletedtrue/false
Always true once deleted
slotobject
The slot, as it was
slot_idtext
The slot deleted
Example output
{
  "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 IDpost_idtextRequired
The post's id, from 'List posts', 'Create post' or an earlier step.

Outputs

deletedtrue/false
Always true once deleted
postobject
The post, as it was
post_idtext
The post deleted
Example output
{
  "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

accountobject
The account
Example output
{
  "account": {
    "status": "ok",
    "token": "fh_EQiI8n**********************",
    "username": "My FeedHive Account"
  }
}

Get label

Get one label by its id.

Inputs

Labellabel_idtextRequired
The label. Pick one, or give its id from an earlier step.

Outputs

labelobject
The label
Example output
{
  "label": {
    "id": "lbl_01HX",
    "title": "Campaign Q4"
  }
}

Get plan slot

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

Inputs

Slot IDslot_idtextRequired
The slot's id, from 'List plan slots' or 'Create plan slot'.

Outputs

slotobject
The plan slot
Example output
{
  "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 IDpost_idtextRequired
The post's id, from 'List posts', 'Create post' or an earlier step.

Outputs

postobject
The post
Example output
{
  "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 IDpost_idtextRequired
The post's id, from 'List posts', 'Create post' or an earlier step.

Outputs

countnumber
How many platforms
post_idtext
The post
publicationslist
The numbers for each platform the post went to
Example output
{
  "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 accountsocial_idtextRequired
The connected social account. Pick one, or give its id.

Outputs

socialobject
The social account
Example output
{
  "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 sizelimitnumber
How many to return, 1 to 100. FeedHive's default is 20.From 1 to 100.
Next page cursorcursortext
The 'next_cursor' from an earlier page, to get the page after it.

Outputs

countnumber
How many on this page
has_moretrue/false
Whether another page follows
labelslist
The labels
next_cursortext
Pass as 'cursor' for the next page; empty on the last one
totalnumber
How many there are in all
Example output
{
  "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 sizelimitnumber
How many to return, 1 to 100. FeedHive's default is 20.From 1 to 100.
Next page cursorcursortext
The 'next_cursor' from an earlier page, to get the page after it.

Outputs

countnumber
How many on this page
has_moretrue/false
Whether another page follows
next_cursortext
Pass as 'cursor' for the next page; empty on the last one
slotslist
The plan slots
totalnumber
How many there are in all
Example output
{
  "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

Statusstatuslist
Only posts in these states. Leave empty for every state.One or more of: draft, scheduled, publishing, published, failed.
Labelslabelslist
Only posts with at least one of these labels.
Social accountssocialslist
Only posts for at least one of these accounts.
Page sizelimitnumber
How many to return, 1 to 100. FeedHive's default is 20.From 1 to 100.
Next page cursorcursortext
The 'next_cursor' from an earlier page, to get the page after it.

Outputs

countnumber
How many on this page
has_moretrue/false
Whether another page follows
next_cursortext
Pass as 'cursor' for the next page; empty on the last one
postslist
The posts
totalnumber
How many there are in all
Example output
{
  "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

countnumber
How many on this page
has_moretrue/false
Whether another page follows
next_cursortext
Pass as 'cursor' for the next page; empty on the last one
socialslist
The social accounts
totalnumber
How many there are in all
Example output
{
  "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

Labellabel_idtextRequired
The label. Pick one, or give its id from an earlier step.
New titletitletextRequired
The label's new name.

Outputs

labelobject
The label
Example output
{
  "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 IDspost_idslistRequired
The ids of the draft posts, up to 50.

Outputs

assignednumber
How many were scheduled into a slot
countnumber
How many posts were tried
resultslist
One result per post
Example output
{
  "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 IDslot_idtextRequired
The slot's id, from 'List plan slots' or 'Create plan slot'.
Day of the weekweek_daytext
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 atstart_timetime
When the slot opens, in the time zone below. Leave empty to keep it.
Ends atend_timetime
When the slot closes. It must be later than it opens. Leave empty to keep it.
Time zonetimezonetext
A time zone name such as Europe/Copenhagen. Defaults to your account's. Leave empty to keep it.
Labelslabel_idslist
Only posts with one of these labels go in this slot. Leave empty for posts without labels. Leave empty to keep it.
Repeatsintervaltext
How often the slot comes round. Defaults to weekly. Leave empty to keep it.One of: weekly (Weekly (default)), daily, monthly.
Every how manyrepeat_everynumber
Repeat every this many days, weeks or months. Defaults to 1. Leave empty to keep it.At least 1.
Stateis_activetext
Whether posts can be put in the slot. Defaults to active. Leave empty to keep it.One of: true (Active (default)), false (Paused).

Outputs

slotobject
The plan slot
Example output
{
  "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 IDpost_idtextRequired
The post's id, from 'List posts', 'Create post' or an earlier step.
Texttexttext
New text for the post. Leave empty to keep it.
Post toaccountslist
The new list of accounts, replacing the old. Leave empty to keep it.
Labelslabelslist
The new list of labels, replacing the old. Leave empty to keep it.
What to do with itstatustext
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 atscheduled_atdate and time
A new time to publish, in the future. Leave empty to keep it.
Notesnotestext
New private notes. Leave empty to keep them.
Linklinktext
A new link. Leave empty to keep it.
Titletitletext
A new title. Leave empty to keep it.

Outputs

postobject
The post
Example output
{
  "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"
  }
}

On this page