# Ayrshare Post To Facebook

Blocks for posting content to Facebook Pages using the Ayrshare social media management API.

## Post To Facebook

### What it is

Post to Facebook using Ayrshare

### How it works

This block uses Ayrshare's social media API to publish content to Facebook Pages. It supports text posts, images, videos, carousels (2-10 items), Reels, and Stories, with features like audience targeting by age and country, location tagging, and scheduling.

The block authenticates through Ayrshare and leverages the Meta Graph API to handle various Facebook-specific formats. Advanced options include draft mode for Meta Business Suite, custom link previews, and video thumbnails. Results include post IDs for tracking engagement.

### Inputs

| Input                    | Description                                                                                                      | Type                | Required |
| ------------------------ | ---------------------------------------------------------------------------------------------------------------- | ------------------- | -------- |
| post                     | The post text to be published                                                                                    | str                 | No       |
| media\_urls              | Optional list of media URLs to include. Set is\_video in advanced settings to true if you want to upload videos. | List\[str]          | No       |
| is\_video                | Whether the media is a video                                                                                     | bool                | No       |
| schedule\_date           | UTC datetime for scheduling (YYYY-MM-DDThh:mm:ssZ)                                                               | str (date-time)     | No       |
| disable\_comments        | Whether to disable comments                                                                                      | bool                | No       |
| shorten\_links           | Whether to shorten links                                                                                         | bool                | No       |
| unsplash                 | Unsplash image configuration                                                                                     | str                 | No       |
| requires\_approval       | Whether to enable approval workflow                                                                              | bool                | No       |
| random\_post             | Whether to generate random post text                                                                             | bool                | No       |
| random\_media\_url       | Whether to generate random media                                                                                 | bool                | No       |
| notes                    | Additional notes for the post                                                                                    | str                 | No       |
| is\_carousel             | Whether to post a carousel                                                                                       | bool                | No       |
| carousel\_link           | The URL for the 'See More At' button in the carousel                                                             | str                 | No       |
| carousel\_items          | List of carousel items with name, link and picture URLs. Min 2, max 10 items.                                    | List\[CarouselItem] | No       |
| is\_reels                | Whether to post to Facebook Reels                                                                                | bool                | No       |
| reels\_title             | Title for the Reels video (max 255 chars)                                                                        | str                 | No       |
| reels\_thumbnail         | Thumbnail URL for Reels video (JPEG/PNG, <10MB)                                                                  | str                 | No       |
| is\_story                | Whether to post as a Facebook Story                                                                              | bool                | No       |
| media\_captions          | Captions for each media item                                                                                     | List\[str]          | No       |
| location\_id             | Facebook Page ID or name for location tagging                                                                    | str                 | No       |
| age\_min                 | Minimum age for audience targeting (13,15,18,21,25)                                                              | int                 | No       |
| target\_countries        | List of country codes to target (max 25)                                                                         | List\[str]          | No       |
| alt\_text                | Alt text for each media item                                                                                     | List\[str]          | No       |
| video\_title             | Title for video post                                                                                             | str                 | No       |
| video\_thumbnail         | Thumbnail URL for video post                                                                                     | str                 | No       |
| is\_draft                | Save as draft in Meta Business Suite                                                                             | bool                | No       |
| scheduled\_publish\_date | Schedule publish time in Meta Business Suite (UTC)                                                               | str                 | No       |
| preview\_link            | URL for custom link preview                                                                                      | str                 | No       |

### Outputs

| Output       | Description                           | Type         |
| ------------ | ------------------------------------- | ------------ |
| error        | Error message if the operation failed | str          |
| post\_result | The result of the post                | PostResponse |
| post         | The result of the post                | PostIds      |

### Possible use case

**Product Launches**: Create carousel posts showcasing multiple product images with links to purchase pages.

**Event Promotion**: Share event details with age-targeted reach and location tagging for local business events.

**Short-Form Video**: Automatically publish Reels with custom thumbnails to maximize video content reach.

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://agpt.co/docs/integrations/block-integrations/post_to_facebook.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.