Track Social Post - Birdeye MCP

track_social_post

Description

Returns the per-location status and metrics for a social post that was scheduled or published via Birdeye. Supports posts across Instagram, Facebook, Google Business Profile, LinkedIn, and Twitter/X.

Parameters

Parameter	Type	Required	Description
`trackingId`	string	Yes	The tracking ID of the post (from Birdeye’s social publishing flow)

Example Usage

What is the status of social post with tracking ID abc123?

Did my scheduled post go live on all locations?

Post Statuses

Status	Description
`POST_SCHEDULED`	Post is queued for future publishing
`POST_PROCESSING`	Post is currently being published
`POST_SUCCEEDED`	Post published successfully
`POST_FAILED`	Post failed to publish — see `failureReason`
`REJECTED_BY_APPROVER`	Post was rejected during the approval workflow

Supported Platforms

INSTAGRAM
FACEBOOK
GOOGLEMYBUSINESS
LINKEDIN
TWITTER

Example Response

{
  "trackingId": "abc123",
  "posts": [
    {
      "locationName": "Acme Dental – Downtown",
      "locationNumber": 78901,
      "platform": "FACEBOOK",
      "status": "POST_SUCCEEDED",
      "publishedTimestamp": "2026-06-25T14:30:00Z",
      "socialSitePostId": "fb_post_987654",
      "socialSitePostUrl": "https://www.facebook.com/acmedental/posts/987654",
      "failureReason": null
    },
    {
      "locationName": "Acme Dental – Westlake",
      "locationNumber": 78902,
      "platform": "FACEBOOK",
      "status": "POST_FAILED",
      "publishedTimestamp": null,
      "socialSitePostId": null,
      "socialSitePostUrl": null,
      "failureReason": "Account token expired"
    }
  ]
}