Workplace

Post

Path /{POST-id}

Represents a Workplace post. The /{post-id} node returns a single post.

Reading

Returns a single Post object representing a post in a group, an event or on a user's profile.

Permissions

Reading a post node requires the Read group content permission. Reading a post on a user's profile requires the Read user timeline permission.

Fields

Field NameDescriptionType

id

The post ID, using the format {group-id}_{id}.

string

created_time

The time the post was initially published.

datetime

formatting

Indicates whether the post was created using a formatting markup language. The return value indicates which markup language was used. Workplace supports Markdown and plain text.

enum {MARKDOWN|PLAINTEXT}

from

Information about the person or profile that posted the message.

Profile

icon

A link to an icon representing the type of this post.

url

link

The link attached to this post.

url

message

The status message in the post.

string

name

The name of the link, if attached to the post.

string

object_id

The ID of any uploaded photo or video attached to the post.

string

permalink_url

URL to the permalink page of the post.

url

picture

The picture scraped from any link included with the post.

url

place

Any location information attached to the post.

Place

poll

If the post is a poll, this field will return the attached Question object, allowing you to see the options and option votes made by users.

Question

properties

A list of properties for any attached video, for example, the length of the video.

object[]

status_type

Description of the type of a status update.

enum {mobile_status_update, created_note, added_photos, added_video, shared_story, created_group, created_event, wall_post, app_created_story, published_story, tagged_in_photo}

story

Text from stories not intentionally generated by users.

string

to

Profiles mentioned or targeted in this post.

Profile[]

type

A string indicating the object type of this post.

enum{link, status, photo, video}

updated_time

The time when the post was created, last edited or the time of the last comment that was left on the post.

datetime

Publishing

You can't publish using this edge. To make a new post in a group, use the /group/feed edge.

Deleting

A post can be deleted via the Graph API by making a DELETE request on the path /{post_id}.

Permissions

Deleting a post node requires both the Post to groups permission and either of Read all content or Read only open content permission, depending on the group where the post is made.

Deleting a post from a user's timeline, requires the Manage user timeline permission.

Updating

Only posts created by a bot can be updated, those made on behalf of a user with an impersonate_token cannot. A post can be edited by making a POST request on the /{post-id} edge with an updated message in the body.

Edges

Edge NameDescription

/attachments

All media attachments associated with this post.

/comments

Comments on this post. Supports a summary field to get a total count.

/reactions

People who have reacted to this post. Supports a summary field to get a total count. Supports since=unix_timstamp and until=unix_timestamp fields to get the number of reactions within a timeframe.

/seen

People who have seen this post. Supports a summary field to get a total count. Supports since=unix_timstamp and until=unix_timestamp fields to get the number of seenby within a timeframe.


Note that this is subject to the same limitations as described here

Supported Markdown Syntax

The following Markdown syntax is supported when publishing a post on Workplace:

FormattingSyntax

Bold

**Bold**

Emphasize

*Emphasize*

Link

[Link](https://workplace.fb.com)

Inline code

`Inline code`
code block
``` code block ```
  • List
* List
  1. Numbered list
1. Numbered list

Quote

> Quote

Heading 1

# Heading 1

Heading 2

## Heading 2

Examples

Get the ID, source and story of a post

GET graph.facebook.com
  /{post-id}?fields=id,source,story

Get the comments from a post

GET graph.facebook.com
  /{post-id}/comments

Get the seen state for a post, including a total count summary

GET graph.facebook.com
  /{group-id}_{post-id}/seen?
  summary=true

Post into a group

POST graph.facebook.com
  /{group-id}/feed?
  message=Hello+World&
  link=https://developers.facebook.com/docs/workplace/custom-integrations/apps

Tag a user in a group post

POST graph.facebook.com
  /{group-id}/feed?
  message=Hi+@[100013325822531]

Post into a group with Markdown formatting

POST graph.facebook.com
  /{group-id}/feed?
  message=This+is+a+**formatted**+*post*&
  formatting=MARKDOWN

Read the poll question options and votes on a poll post, using field expansion

GET graph.facebook.com
  /{post-id}?
  fields=message,poll{options{name,vote_count,votes}}

Delete a post

DELETE graph.facebook.com
  /{post-id}

Reactions/SeenBy within a time frame

GET graph.facebook.com
  /{post-id}/seen?
        since=1577836800&
        until=1593561600