> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Facebook

> Facebook Pages workflow actions for managing pages, posts, comments, messages, and insights via your connected account.

Use this app when your workflow needs to publish or review Facebook Page content, manage comments, or handle Page messages. It is for Facebook Pages, not personal profiles.

## Configuration

| Option | Required | Description |
| - | - | - |
| Name | No | Label for the step in the workflow canvas. |
| Authentication | Yes | The connected Facebook account to use for this step. |
| Action | Yes | The Facebook action to perform (for example Get Current User, List Managed Pages, Get Page Details, Create Post). |
| Arguments | Yes | Per-action form fields generated from the action's schema. Each text field has an **Insert Variable** button for injecting `{{placeholder}}` values. A **Raw JSON** tab is available for advanced usage. |
| When the step fails | No | Controls whether the workflow should **Terminate Workflow** or **Continue** if this step fails. |

Before you configure this step, connect Facebook in **Integrations** for your workspace using the sign-in flow. If no active connection is available, the step shows a warning with a link to **Integrations** instead of the account selector.

## Arguments form

When you select an action, the **Arguments** section renders a form driven by the action's input schema. Fields that refer to existing records include dropdown pickers.

Switch to the **Raw JSON** tab when you prefer to write the full arguments object by hand. Changes in either tab stay in sync.

## Common actions

| Action | Description |
| - | - |
| **Get Current User** | Validate the connection and fetch the authenticated Facebook profile. |
| **List Managed Pages** | List the Facebook Pages the connected user manages. |
| **Get Page Details** | Fetch details for a specific Facebook Page. |
| **Create Post** | Publish a new text or link post on a Facebook Page. |
| **Get Page Posts** | Retrieve posts from a Facebook Page. |
| **Get Post** | Fetch details for a specific Facebook post. |
| **Update Post** | Update an existing Facebook Page post. |
| **Publish Scheduled Post** | Publish a previously scheduled or unpublished post immediately. |
| **Get Scheduled Posts** | List scheduled and unpublished posts for a Facebook Page. |
| **Create Comment** | Create a comment on a post or reply to a comment. |
| **Get Comments** | Retrieve comments from a Facebook post or comment. |
| **Update Comment** | Update an existing Facebook comment. |
| **Send Message** | Send a text message from a Facebook Page to a user. |
| **Get Page Conversations** | List conversations between users and a Facebook Page. |

Destructive actions, such as deleting records, are not available in the workflow action picker.

## Output

This step stores the Facebook response as the step output. The shape of the response depends on the action.

Use the full output reference in later steps:

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

## Example

1. Open **Integrations** and connect Facebook if you have not already done that.
2. Add a **Facebook** step to your workflow.
3. Select a connected account in **Authentication**.
4. Choose **Get Current User** in **Action**.
5. Fill in the required fields. Use **Insert Variable** to reference an earlier step's output for any field value.
6. Click **Run** in the step header to test the action, then review the returned payload in **Output**.

## Use cases

### Publish a page update

1. List Managed Pages
2. Create Post
3. Get Post

### Handle comment feedback

1. Get Page Posts
2. Get Comments
3. Update Comment

### Reply to a message

1. Get Page Conversations
2. Get Conversation Messages
3. Send Message

## Notes

* This step depends on a connected Facebook integration in your workspace.
* The workflow action picker shows a curated set of actions. Agents with the Facebook tool can use more of them.
* The sign-in screen may show third-party authorization branding.

## Using Facebook as an Agent Tool

You can also add Facebook as a tool in the **Agent Editor**. Open the agent, click **Add tool**, and select **Facebook**. In the tool settings panel, choose the connected account the agent should use. The agent calls Facebook actions when they are relevant to the conversation.

See also: [Integrations](https://docs.fetchhive.com/workspace/integrations.md), [Creating and Editing](https://docs.fetchhive.com/workflows/creating-and-editing.md), and [Testing and Iteration](https://docs.fetchhive.com/workflows/testing-and-iteration.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.