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
| Action | What it does |
|---|---|
| Create label | Create a label to group posts and posting slots. |
| Create plan slot | Add a posting slot to the plan: a window on a day of the week that drafts can be scheduled into. |
| Create post | Create a text post as a draft, or schedule it for some social accounts at a time in the future. |
| Delete label | Delete a label. |
| Delete plan slot | Delete a posting slot. |
| Delete post | Delete a post. |
| Get account | Check the API key and get the name of the FeedHive account or workspace it belongs to. |
| Get label | Get one label by its id. |
| Get plan slot | Get one posting slot with its times, labels and repeat. |
| Get post | Get one post with its text, state, accounts, labels and publish time. |
| Get post analytics | Get the numbers (impressions, likes, comments, clicks and so on) FeedHive has for a published post on each platform. |
| Get social account | Get one connected social account. |
| List labels | List the labels used to group posts. |
| List plan slots | List the posting slots in the plan, with when each next comes round. |
| List posts | List posts, newest first, optionally only those in some states or with some labels or accounts. |
| List social accounts | List the social accounts connected to FeedHive, with their platform, handle and whether they are working. |
| Rename label | Give a label a new title. |
| Schedule drafts into plan slots | Put draft posts into the next free plan slots that match their labels. |
| Update plan slot | Change a posting slot's day, times, time zone, labels, repeat or state. |
| Update post | Change 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
- Title
titletextRequired - 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 week
week_daytextRequired - 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_timetimeRequired - When the slot opens, in the time zone below.
- Ends at
end_timetimeRequired - When the slot closes. It must be later than it opens.
- Time zone
timezonetext - A time zone name such as Europe/Copenhagen. Defaults to your account's.
- Labels
label_idslist - Only posts with one of these labels go in this slot. Leave empty for posts without labels.
- Repeats
intervaltext - How often the slot comes round. Defaults to weekly.One of:
weekly(Weekly (default)),daily,monthly. - Every how many
repeat_everynumber - Repeat every this many days, weeks or months. Defaults to 1.At least 1.
- State
is_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
- Text
texttextRequired - The text of the post.
- Post to
accountslist - The social accounts to post to. Needed to schedule a post.
- Labels
labelslist - The labels to put on the post.
- What to do with it
statustext - 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_atdate and time - When to publish. It must be in the future.Only when What to do with it is Schedule it.
- Notes
notestext - Private notes for your team, not posted.
- Link
linktext - A link for the platforms that show one.
- Title
titletext - 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
- Label
label_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 ID
slot_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 ID
post_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
- Label
label_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 ID
slot_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 ID
post_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 ID
post_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 account
social_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 size
limitnumber - How many to return, 1 to 100. FeedHive's default is 20.From 1 to 100.
- Next page cursor
cursortext - 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 size
limitnumber - How many to return, 1 to 100. FeedHive's default is 20.From 1 to 100.
- Next page cursor
cursortext - 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
- Status
statuslist - Only posts in these states. Leave empty for every state.One or more of:
draft,scheduled,publishing,published,failed. - Labels
labelslist - Only posts with at least one of these labels.
- Social accounts
socialslist - Only posts for at least one of these accounts.
- Page size
limitnumber - How many to return, 1 to 100. FeedHive's default is 20.From 1 to 100.
- Next page cursor
cursortext - 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
- Label
label_idtextRequired - The label. Pick one, or give its id from an earlier step.
- New title
titletextRequired - 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 IDs
post_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 ID
slot_idtextRequired - The slot's id, from 'List plan slots' or 'Create plan slot'.
- Day of the week
week_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 at
start_timetime - When the slot opens, in the time zone below. Leave empty to keep it.
- Ends at
end_timetime - When the slot closes. It must be later than it opens. Leave empty to keep it.
- Time zone
timezonetext - A time zone name such as Europe/Copenhagen. Defaults to your account's. Leave empty to keep it.
- Labels
label_idslist - Only posts with one of these labels go in this slot. Leave empty for posts without labels. Leave empty to keep it.
- Repeats
intervaltext - 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_everynumber - Repeat every this many days, weeks or months. Defaults to 1. Leave empty to keep it.At least 1.
- State
is_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 ID
post_idtextRequired - The post's id, from 'List posts', 'Create post' or an earlier step.
- Text
texttext - New text for the post. Leave empty to keep it.
- Post to
accountslist - The new list of accounts, replacing the old. Leave empty to keep it.
- Labels
labelslist - The new list of labels, replacing the old. Leave empty to keep it.
- What to do with it
statustext - 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_atdate and time - A new time to publish, in the future. Leave empty to keep it.
- Notes
notestext - New private notes. Leave empty to keep them.
- Link
linktext - A new link. Leave empty to keep it.
- Title
titletext - 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"
}
}