Facebook Business Manager

Facebook Business Manager Posts API

Create, read, update, and delete posts on a Facebook Page feed.

GitHub OpenAPI
Business capability
Content Marketing Management BC-400.70

Operations 5

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /{page_id}/feed Read the posts on a Page's feed · Facebook Business Manager Get page feed #
Ask an LLM
“What has been posted on my Page recently?”
“Does a Page's feed include visitor posts as well as the Page's own?”
Tell an agent
Show the feed for Page {page_id}.
List the latest {limit} posts on Page {page_id}.
POST /{page_id}/feed Publish or schedule a post on a Page · Facebook Business Manager Create a page post #
Ask an LLM
“Can I schedule a Page post for next week instead of publishing now?”
“How far ahead can a Page post be scheduled?”
Tell an agent
Post {message} on Page {page_id}.
Share link {link} on Page {page_id} with the text {message}.
GET /{post_id} Get one post's content and engagement · Facebook Business Manager Get a post #
Ask an LLM
“How many reactions did a specific post get?”
“Can I see the attachments on one particular post?”
Tell an agent
Show me post {post_id}.
Get the {fields} of post {post_id}.
POST /{post_id} Edit the text of a published post · Facebook Business Manager Update a post #
Ask an LLM
“Can I fix a typo in a post that's already published?”
“What can I change on a post after it goes live?”
Tell an agent
Change the text of post {post_id} to {message}.
Edit the message on my published post {post_id} to read {message}.
DELETE /{post_id} Delete a post from a Page · Facebook Business Manager Delete a post #
Ask an LLM
“Can I take down a post from my Page for good?”
“Is deleting a Page post reversible?”
Tell an agent destructive · confirm first
Delete post {post_id}.
Permanently remove post {post_id} from the Page.

Documentation

📖
Documentation
https://developers.facebook.com/docs/marketing-api
📖
Authentication
https://developers.facebook.com/docs/marketing-api/authentication
📖
RateLimits
https://developers.facebook.com/docs/graph-api/overview/rate-limiting
📖
GettingStarted
https://developers.facebook.com/docs/marketing-api/get-started
📖
Documentation
https://developers.facebook.com/docs/pages-api
📖
GettingStarted
https://developers.facebook.com/docs/pages/getting-started
📖
Authentication
https://developers.facebook.com/docs/pages/access-tokens

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/facebook-business-manager/refs/heads/main/openapi/facebook-business-manager-posts-api-openapi.yml

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/facebook-business-manager/refs/heads/main/overlays/facebook-business-manager-posts-api-overlay.yaml
🔗
ChangeLog
https://developers.facebook.com/docs/graph-api/changelog
🔗
Reference
https://developers.facebook.com/docs/marketing-api/reference
🔗
SDKs
https://developers.facebook.com/docs/business-sdk/getting-started
🔗
Reference
https://developers.facebook.com/docs/pages-api/overview

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/facebook-business-manager:facebook-business-manager-posts-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

facebook-business-manager-posts-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Facebook Business Manager Facebook Pages Posts API
  description: Manage Facebook Pages, publish and manage posts, moderate comments, and track engagement through the Graph API. The Pages API allows businesses to programmatically manage their Facebook presence, publish content, respond to comments and messages, and retrieve page-level analytics.
  version: '25.0'
  contact:
    name: Meta Developer Support
    url: https://developers.facebook.com/support
  termsOfService: https://developers.facebook.com/terms
servers:
- url: https://graph.facebook.com/v25.0
  description: Facebook Graph API Production Server
security:
- bearerAuth: []
tags:
- name: Posts
  description: Create, read, update, and delete posts on a Facebook Page feed.
paths:
  /{page_id}/feed:
    get:
      operationId: getPageFeed
      summary: Facebook Business Manager Get page feed
      description: Retrieves the feed of posts on a Facebook Page. Includes posts published by the page and posts by visitors if allowed.
      tags:
      - Posts
      parameters:
      - $ref: '#/components/parameters/pageId'
      - $ref: '#/components/parameters/fields'
      - $ref: '#/components/parameters/limit'
      - $ref: '#/components/parameters/after'
      responses:
        '200':
          description: Successfully retrieved page feed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostList'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
    post:
      operationId: createPagePost
      summary: Facebook Business Manager Create a page post
      description: Publishes a new post to the Facebook Page feed. Supports text posts, link shares, and scheduled posts. Requires a page access token with pages_manage_posts permission.
      tags:
      - Posts
      parameters:
      - $ref: '#/components/parameters/pageId'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostCreate'
      responses:
        '200':
          description: Post created successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
  /{post_id}:
    get:
      operationId: getPost
      summary: Facebook Business Manager Get a post
      description: Retrieves the details of a specific post including message, attachments, reactions, and engagement counts.
      tags:
      - Posts
      parameters:
      - $ref: '#/components/parameters/postId'
      - $ref: '#/components/parameters/fields'
      responses:
        '200':
          description: Successfully retrieved post details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Post'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
    post:
      operationId: updatePost
      summary: Facebook Business Manager Update a post
      description: Updates an existing post on the Page. Only the message field can be updated after publishing.
      tags:
      - Posts
      parameters:
      - $ref: '#/components/parameters/postId'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                message:
                  type: string
                  description: Updated post message text
      responses:
        '200':
          description: Post updated successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
    delete:
      operationId: deletePost
      summary: Facebook Business Manager Delete a post
      description: Deletes a post from the Facebook Page. This action cannot be undone.
      tags:
      - Posts
      parameters:
      - $ref: '#/components/parameters/postId'
      responses:
        '200':
          description: Post deleted successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
components:
  schemas:
    PostList:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/Post'
        paging:
          $ref: '#/components/schemas/Paging'
    Paging:
      type: object
      properties:
        cursors:
          type: object
          properties:
            before:
              type: string
            after:
              type: string
        next:
          type: string
        previous:
          type: string
    SuccessResponse:
      type: object
      properties:
        success:
          type: boolean
    Post:
      type: object
      properties:
        id:
          type: string
          description: The ID of the post
        message:
          type: string
          description: The text content of the post
        story:
          type: string
          description: Auto-generated story text for the post
        created_time:
          type: string
          format: date-time
          description: When the post was created
        updated_time:
          type: string
          format: date-time
          description: When the post was last updated
        full_picture:
          type: string
          format: uri
          description: URL of the full-size post image
        permalink_url:
          type: string
          format: uri
          description: Permanent URL to the post
        type:
          type: string
          description: Type of post content
          enum:
          - link
          - status
          - photo
          - video
          - offer
        shares:
          type: object
          properties:
            count:
              type: integer
          description: Share count information
        likes:
          type: object
          properties:
            summary:
              type: object
              properties:
                total_count:
                  type: integer
        comments:
          type: object
          properties:
            summary:
              type: object
              properties:
                total_count:
                  type: integer
        attachments:
          type: object
          description: Media and link attachments on the post
        is_published:
          type: boolean
          description: Whether the post is published
        scheduled_publish_time:
          type: string
          description: Unix timestamp for scheduled posts
    CreateResponse:
      type: object
      properties:
        id:
          type: string
          description: The ID of the newly created object
    PostCreate:
      type: object
      properties:
        message:
          type: string
          description: The text content for the post
        link:
          type: string
          format: uri
          description: URL to share in the post
        published:
          type: boolean
          description: Whether to publish the post immediately
          default: true
        scheduled_publish_time:
          type: integer
          description: Unix timestamp for when to publish the post. Must be between 10 minutes and 6 months from now.
        targeting:
          type: object
          description: Targeting specification for the post audience
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            message:
              type: string
              description: Human-readable error message
            type:
              type: string
              description: Error type classification
            code:
              type: integer
              description: Numeric error code
            error_subcode:
              type: integer
              description: Numeric error subcode
            fbtrace_id:
              type: string
              description: Unique trace ID for debugging
  parameters:
    limit:
      name: limit
      in: query
      required: false
      description: Maximum number of objects to return per page
      schema:
        type: integer
        default: 25
        maximum: 100
    postId:
      name: post_id
      in: path
      required: true
      description: The ID of the post (format PAGE_ID_POST_ID)
      schema:
        type: string
    fields:
      name: fields
      in: query
      required: false
      description: Comma-separated list of fields to include in the response
      schema:
        type: string
    after:
      name: after
      in: query
      required: false
      description: Cursor for forward pagination
      schema:
        type: string
    pageId:
      name: page_id
      in: path
      required: true
      description: The ID of the Facebook Page
      schema:
        type: string
  responses:
    BadRequest:
      description: Invalid request parameters or malformed request body
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unauthorized:
      description: Invalid or expired access token or insufficient permissions
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    NotFound:
      description: The requested resource was not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Page access token with appropriate permissions such as pages_manage_posts, pages_read_engagement, pages_manage_metadata.
externalDocs:
  description: Facebook Pages API Documentation
  url: https://developers.facebook.com/docs/pages-api