| CARVIEW |
Posts
This guide explains how to create, publish, and update a post, and reply to a post on your Facebook Page as the Page, and delete a post using the Pages API from Meta.
Before you start
This guide assumes you have read the Overview
For a person who can perform tasks on the page, you will need to implement Facebook Login to ask for the following permissions and receive a Page access token:
pages_manage_engagementpages_manage_postspages_read_engagementpages_read_user_engagementpublish_videopermission, if you are publishing a video to the Page
Your app user must be able to perform the CREATE_CONTENT, MANAGE, and MODERATE tasks on the Page in the API requests.
If your app users do not own or manage the Page in the API requests, your app will need a User access token and the following features:
- Page Public Content Access
Best practices
When testing an API call, you can include the access_token parameter set to your access token. However, when making secure calls from your app, use the access token class.
Publish posts
To publish a post to a Page, send a POST request to the /page_id/feed endpoint, where page_id is the ID for your Page, with the following parameters:
messageset to the text for your postlinkset to your URL if you want to post a linkpublishedset totrueto publish the post immediately (default) orfalseto publish later- Include
scheduled_publish_timeif set tofalsewith the date in one of the following formats:- An integer UNIX timestamp [in seconds] (e.g.
1530432000) - An ISO 8061 timestamp string (e.g.
2018-09-01T10:15:30+01:00) - Any string otherwise parsable by PHP's
strtotime()(e.g.+2 weeks,tomorrow)
- An integer UNIX timestamp [in seconds] (e.g.
- Include
Notes about scheduled posts
- The publish date must be between 10 minutes and 30 days from the time of the API request.
- If you are relying on
strtotime()'s relative date strings you can read-after-write thescheduled_publish_timeof the created post to make sure it is what is expected.
Example Request
Formatted for readability. Replace bold, italics values, such as page_id, with your values.
curl -X POST "https://graph.facebook.com/v23.0/page_id/feed" \
-H "Content-Type: application/json" \
-d '{
"message":"your_message_text",
"link":"your_url",
"published":"false",
"scheduled_publish_time":"unix_time_stamp_of_a_future_date",
}'On success, your app receives the following JSON response with the ID for the post:
{
"id": "page_post_id"
}
Add audience targeting
To limit who can see a Page post, you can add the targeting.geo_locations object or feed_targeting.geo_locations parameter in your POST request.
-d '{
...
"targeting": {
"geo_locations": {
"countries": [
"CA"
],
"cities": [
{
"key": "296875",
"name": "Toronto"
}
]
}
},
...
}'Troubleshooting
In some cases using both a country and a region within that country will result in an error: "Some of your locations overlap. Try removing a location." In these cases target the region or the country depending on the coverage you want.
Publish Media Posts
You can publish photos and videos to a Page.
Publish a photo
To publish a photo to a Page, send a POST request to the /page_id/photos endpoint, where page_id is the ID for your Page, with the url parameter set to the photo for your post.
Example Request
Formatted for readability. Replace bold, italics values, such as page_id, with your values.
curl -X POST "https://graph.facebook.com/v23.0/page_id/photos" \
-H "Content-Type: application/json" \
-d '{
"url":"path_to_photo",
On success, your app receives the following JSON response with the ID for the photo and the ID for the post:
{
"id":"photo_id",
"post_id":"page_post_id"
}
Publish a video
Please visit the Video API documentation to publish a video post to your Page.
Get Posts
To get a list of Page posts, send a GET request to the /page_id/feed endpoint.
Example Request
Formatted for readability. Replace bold, italics values, such as page_id, with your values.
curl -i -X GET "https://graph.facebook.com/v23.0/page_id/feed"
On success, your app receives the following JSON response with an array of objects that include the post ID, the time the post was created, and the content for the post, for each post on your Page:
{
"data": [
{
"created_time": "2019-01-02T18:31:28+0000",
"message": "This is my test post on my Page.",
"id": "page_post_id"
}
],
...
}
Limitations
- Live Videos - If a Page post contains a video that has expired, such as a live broadcast, you can get some post fields but not fields related to the video. The video has its own privacy rules. If the video has expired, you must be the page admin to view its information.
- Message CTA - Any access token can be used to request publicly shared Page posts as long as your app has been approved for the Page Public Content Access Feature. However, posts with message CTAs cannot be accessed using another Page's access token since pages cannot message other pages.
Page Post URLs
The URL, or permalink, for a Page post is https://www.facebook.com/page_post_id.
Update a Post
To update a Page post, send a POST request to the /page_post_id endpoint with the parameters you want to update set to the new content.
Example Request
Formatted for readability. Replace bold, italics values, such as page_post_id, with your values.
curl -X POST "https://graph.facebook.com/v23.0/page_post_id" \
-H "Content-Type: application/json" \
-d '{
"message":"I am updating my Page post",
}'
On success, your app receives the following JSON response with success set to true:
{
"success": true
}
Limitations
An app can only update a Page post if the post was made using that app.
Delete a Post
To delete a Page post, send a DELETE request to the /page_post_id endpoint where page_post_id is the ID for post you want to delete.
Example Request
Formatted for readability. Replace bold, italics values, such as page_post_id, with your values.
curl -i -X DELETE "https://graph.facebook.com/v23.0/page_post_id"
On success, your app receives the following JSON response with success set to true:
{
"success": true
}
Next Steps
Learn how to comment on Page posts and @mention a specific person or Page who posted or commented on your Page.
See Also
Video API guides
References