Reference - FeedHive Docs

This page provides detailed payload references for all notification types available in FeedHive webhooks.

On Post Published

Triggered when a post is successfully published to a social media platform.

Payload Fields

Field	Type	Description
post_id	string	Unique identifier for the post in FeedHive
social_type	string	The social media platform (e.g., "Facebook", "Instagram", "LinkedIn")
social_name	string	The name of the connected social media account
public_id	string	The platform-specific post ID
public_url	string	Direct URL to the published post on the social platform
post_excerpt	string	The first portion of the post caption (truncated)
post	NotificationPost	Full post data object

Example Payload

{
  "post_id": "xxxx-abcd-1234",
  "social_type": "Facebook",
  "social_name": "My Facebook Page",
  "public_id": "123456789101112_1314151617181920",
  "public_url": "https://www.facebook.com/xxxx/posts/yyyy",
  "post_excerpt": "This is the first part of the post caption for a Fa...",
  "post": {
    "content": [
      {
        "text": "This is the first part of the post caption for a Facebook post.",
        "media": [
          "https://example.com/image1.jpg",
          "https://example.com/image2.jpg"
        ]
      }
    ],
    "labels": ["Marketing", "Product Demo"],
    "postNotes": "Internal notes about this post",
    "title": "Post Title",
    "link": "https://example.com/landing-page"
  }
}

On Post Scheduled

Triggered when a post is scheduled for future publishing.

Payload Fields

Field	Type	Description
post_id	string	Unique identifier for the post in FeedHive
schedule_at	string	ISO 8601 timestamp when the post is scheduled to publish
pending_approval	boolean	Indicates if the post requires approval before publishing
social_types	string	Comma-separated list of social platforms where the post will be published
post_excerpt	string	The first portion of the post caption (truncated)
post	NotificationPost	Full post data object

Example Payload

{
  "post_id": "xxxx-abcd-1234",
  "schedule_at": "2024-08-01T12:00:00.000Z",
  "pending_approval": true,
  "social_types": "Facebook, Instagram, LinkedIn",
  "post_excerpt": "This is the first part of the post caption for a Fa...",
  "post": {
    "content": [
      {
        "text": "This is the first part of the post caption for a Facebook post.",
        "media": [
          "https://example.com/image1.jpg"
        ]
      }
    ],
    "labels": ["Scheduled Content", "Tips & Tricks"],
    "postNotes": "Remember to check engagement after posting",
    "cta": {
      "text": "Learn More",
      "url": "https://example.com"
    }
  }
}

On Post Failed

Triggered when a post fails to publish to a social media platform.

Payload Fields

Field	Type	Description
post_id	string	Unique identifier for the post in FeedHive
failed_at	string	ISO 8601 timestamp when the post failed
message	string	Error message describing why the post failed
post_excerpt	string	The first portion of the post caption (truncated)
social_type	string	The social media platform where the post failed
social_name	string	The name of the connected social media account
post	NotificationPost	Full post data object

Example Payload

{
  "post_id": "xxxx-abcd-1234",
  "failed_at": "2024-08-01T12:00:00.000Z",
  "message": "The access token for Facebook has expired.",
  "post_excerpt": "This is the first part of the post caption for a Fa...",
  "social_type": "Facebook",
  "social_name": "My Facebook Page",
  "post": {
    "content": [
      {
        "text": "This is the first part of the post caption for a Facebook post.",
        "media": []
      }
    ],
    "labels": ["Urgent", "Needs Review"],
    "postNotes": "This post needs immediate attention",
    "title": "Important Announcement"
  }
}

Common Failure Messages

"The access token for [Platform] has expired." - Requires re-authentication
"Invalid media format or size." - Media doesn't meet platform requirements
"Rate limit exceeded." - Too many posts in a short time period
"Account permissions insufficient." - Missing required permissions

On Comment Added

Triggered when a comment is added to a post (either internal team comments or social media comments, depending on configuration).

Payload Fields

Field	Type	Description
post_id	string	Unique identifier for the post in FeedHive
comment_id	string	Unique identifier for the comment
commented_at	string	ISO 8601 timestamp when the comment was added
commented_by	string	Unique identifier of the user who commented
commented_by_name	string	Display name of the user who commented
commented_by_email	string	Email address of the user who commented
comment_text	string	The full text content of the comment
post_excerpt	string	The first portion of the post caption (truncated)
post	NotificationPost	Full post data object

Example Payload

{
  "post_id": "xxxx-abcd-1234",
  "comment_id": "yyyy-zxyw-4321",
  "commented_at": "2024-08-01T12:00:00.000Z",
  "commented_by": "zzzz-efgh-5678",
  "commented_by_name": "John Doe",
  "commented_by_email": "johndoe@gmail.com",
  "comment_text": "Great post. Perhaps add another image?",
  "post_excerpt": "This is the first part of the post caption for a Fa...",
  "post": {
    "content": [
      {
        "text": "This is the first part of the post caption for a Facebook post.",
        "media": [
          "https://example.com/image1.jpg"
        ]
      }
    ],
    "labels": ["Team Collaboration", "Feedback Received"],
    "postNotes": "Awaiting team feedback before publishing",
    "title": "Draft Post for Review"
  }
}

Introduction Setting up Instagram on FeedHive