Adding a New Post via Spreadsheet

Schedule a new BuddyBoss group post by adding a single row to your Google Sheet.

A post is the top-level activity in BuddyBoss — it appears in the group's activity feed and can receive comments and replies. To schedule a post, add a row with type set to post.

Required Fields for a Post

id — A unique identifier for this row.
type — Must be post.
user_id — The WordPress User ID of the virtual member posting.
scheduled_at — When to publish the post.
content — The text of the post.
group_id — The BuddyBoss Group ID where the post will appear.

Info: Leave parent_id blank for posts — it is only used for comments and replies.

Example Row

csv

id,type,user_id,scheduled_at,content,group_id,parent_id,status
101,post,42,2024-03-20 08:30:00,"Good morning! Has anyone tried journaling first thing in the morning? Game changer for me.",7,,

Finding a Group ID

To find the Group ID in WordPress admin:

Go to BuddyBoss → Groups.
Hover over the group name in the list.
The URL shown at the bottom of the browser will include ?gid=XX — that number is the Group ID.

Tip: You can also find Group IDs by clicking "Edit" on the group — the ID will appear in the browser's URL bar.

What Happens After Sync

Once BuddyActivity processes the row, it will:

Create the activity post in BuddyBoss attributed to the specified virtual member.
Update the status column in your sheet to done.
Log the activity in the Sync Logs for audit purposes.

Warning: If the scheduled_at time has not yet passed, the row will be skipped until the next sync after that time.

Alternative: Using the Create Post Form

You can also create activity posts using the built-in form in your BuddyActivity spreadsheet. This method provides a guided interface with validation.

Open the Create Post Form

1.Click "BuddyActivity" in the spreadsheet menu bar.
2.Select "Create Post" from the dropdown.
3.A form dialog will appear with all the necessary fields.

Fill in the Post Details

Post Creation Form Fields

Auto-Select Author & Time — Let the system choose based on member activity scores, or uncheck to set manually.

Group — Select from your active groups (populated from GROUP_DIRECTORY).

Engagement Type — Choose LOW, MEDIUM, HIGH, SPIKE, DEAD, or DEBATE.

Scheduled Time — Format: YYYY-MM-DD HH:MM:SS.

Author ID — WordPress User ID (if not auto-selected).

Image URL — Optional image URL to include with the post.

Post Content — The main activity post text.

Mark as Publish Ready — Check to immediately mark for publishing.

Submit and Review

1.Click "Submit" to save the activity to the Activity Log.
2.Navigate to the "ACTIVITY_LOG" tab to review your post.
3.Edit any fields directly in the sheet if needed.
4.Set "Publish Ready" to TRUE when ready to publish to WordPress.

Tip: The Create Post form automatically generates a unique POST_ID and validates your input. For detailed information about all spreadsheet features, see the Content Generation Spreadsheet guide.