Social

Facebook

Create and schedule Facebook Page posts, inspect insights and track engagement.

What you can build

Schedule page posts with link attachments
Report on post insights and reach
List and manage pages you admin
Track engagement across recent posts

Access and credentials

Post, delete, and read insights for Facebook Pages via OAuth. Posting and deleting are public, mutating actions; deletes are irreversible.

This plugin declares OAuth access. Provider permissions and connection setup must be reviewed when a compatible release is installed.

Example action

Find the Pages you can manage

Use this call in a saved OrgSDK action after enabling the plugin and connecting a credential.

return await facebook.getPages();

Use with OrgSDK

OrgSDK gives external AI clients persistent projects and controlled execution. Plugins add optional tools to those projects. Each run uses pinned plugin versions, and project configuration determines which credentials they can use.

Set up OrgSDK locally ↗

The plugin’s toolkit

Capabilities

6 functions from this published version. Read calls retrieve or process information; write actions can change data in the connected service.

Find a function

6 of 6 functions

`facebook.getPage`

Read call

Get the Facebook business page info including name, link, and follower count.

Parameters and return value

This call takes no parameters.

Returns Promise<{ id: string; name: string; link: string; fanCount?: number }>

`facebook.getPages`

Read call

List all Facebook business pages where the authenticated user has admin access.

Parameters and return value

This call takes no parameters.

Returns Promise<Array<{ id: string; name: string; link: string; fanCount?: number }>>

`facebook.createPagePost`

Write action

Create a post on the Facebook business page. Supports link attachments and scheduled publishing.

Parameters and return value

Parameter	Type	Details
`message`	`string`	—
`linkUrl`Optional	`string`	—
`scheduledPublishTime`Optional	`number`	—

Returns Promise<{ id: string; url: string }>

`facebook.getPagePosts`

Read call

List recent posts on the Facebook business page with engagement metrics.

Parameters and return value

Parameter	Type	Details
`limit`Optional	`number`	—

Returns Promise<Array<{ id: string; message?: string; createdTime: string; permalinkUrl: string; likes: number; comments: number; shares: number }>>

`facebook.getPostInsights`

Read call

Get detailed insights for a Facebook page post including impressions, reach, engagement, and click metrics.

Parameters and return value

Parameter	Type	Details
`postId`	`string`	—

Returns Promise<{ impressions: number; reach: number; likes: number; comments: number; shares: number; linkClicks: number; engagementRate: number }>

`facebook.deletePagePost`

Write action

Delete a Facebook page post. This action is irreversible.

Parameters and return value

Parameter	Type	Details
`postId`	`string`	—

Returns Promise<{ success: boolean }>