Bettermode
App · 20 actions
Run your Bettermode community: create and manage spaces, publish, edit and delete posts and replies, react, manage tags and look up members.
Actions
| Action | What it does |
|---|---|
| Add reaction | React to a post or reply as the signed-in member. |
| Create post | Publish a post in a space, as the signed-in member. |
| Create reply | Reply to a post, as the signed-in member. |
| Create space | Create a space in the community. |
| Create tag | Create a tag that posts can carry. |
| Delete post | Delete a post or a reply. |
| Delete space | Delete a space and every post in it. |
| Delete tag | Delete a tag. |
| Get community | Get the connected community: its name, domain, description, language and member count. |
| Get member | Get one member with their name, email, role and status. |
| Get post | Get one post with its title, content, tags and counts. |
| Get space | Get one space with its description, type, privacy and counts. |
| List members | List the community's members, optionally filtered by name or status. |
| List posts | List posts in the community or in one space. |
| List replies | List the replies to a post. |
| List spaces | List the community's spaces, optionally filtered by name or type. |
| List tags | List the community's tags. |
| Update post | Change a post's title, content or tags, or lock it. |
| Update space | Change a space's name, description, type or privacy. |
| Update tag | Rename a tag or change its description. |
Add reaction
React to a post or reply as the signed-in member.
Inputs
- Post ID
post_idtextRequired - The post's id, from 'List posts' or 'Create post'.
- Reaction
reactiontext - The reaction's name. Defaults to +1 (a thumbs up).
Outputs
addedtrue/false- Always true once added
post_idtext- The post reacted to
reactiontext- The reaction added
Example output
{
"added": true,
"post_id": "po_01HXAMPLE",
"reaction": "+1"
}Create post
Publish a post in a space, as the signed-in member.
Inputs
- Space
space_idtextRequired - The space. Pick one, or give its id from an earlier step.
- Post type
post_type_idtext - The kind of post, such as a discussion or question. Defaults to the community's ordinary post.
- Title
titletextRequired - The post's title.
- Content
contenttext - The text, as HTML such as <p>Hello</p> or plain text.
- Tags
tagstext - Tag names, comma separated. Bettermode creates any that do not exist.
- Publish now
publishtext - No saves a draft. Defaults to yes.One of:
true(Yes),false(No).
Outputs
postobject- The new post
Example output
{
"post": {
"content": "<p>Read the notes.</p>",
"createdAt": "2026-01-15T09:35:00Z",
"id": "po_01HXAMPLE",
"isHidden": false,
"lastActivityAt": "2026-01-15T09:35:00Z",
"locked": false,
"ownerId": "mem_01HXAMPLE",
"positiveReactionsCount": 0,
"postTypeId": "pt_01HXAMPLE",
"publishedAt": "2026-01-15T09:35:00Z",
"reactionsCount": 0,
"relativeUrl": "/product-updates/post/version-2-is-out-po_01HXAMPLE",
"repliedToId": null,
"repliesCount": 0,
"shortContent": "Read the notes.",
"slug": "version-2-is-out",
"spaceId": "sp_01HXAMPLE",
"status": "PUBLISHED",
"tag_names": [
"release"
],
"tags": [
{
"description": "Release notes",
"id": "tag_01HXAMPLE",
"slug": "release",
"title": "release"
}
],
"title": "Version 2 is out"
}
}Create reply
Reply to a post, as the signed-in member.
Inputs
- Post ID
post_idtextRequired - The post's id, from 'List posts' or 'Create post'.
- Reply
contenttextRequired - The text, as HTML such as <p>Hello</p> or plain text.
Outputs
replyobject- The new reply
Example output
{
"reply": {
"content": "<p>Read the notes.</p>",
"createdAt": "2026-01-15T09:35:00Z",
"id": "po_01HXAMPLE",
"isHidden": false,
"lastActivityAt": "2026-01-15T09:35:00Z",
"locked": false,
"ownerId": "mem_01HXAMPLE",
"positiveReactionsCount": 0,
"postTypeId": "pt_01HXAMPLE",
"publishedAt": "2026-01-15T09:35:00Z",
"reactionsCount": 0,
"relativeUrl": "/product-updates/post/version-2-is-out-po_01HXAMPLE",
"repliedToId": "po_01HXAMPLE",
"repliesCount": 0,
"shortContent": "Read the notes.",
"slug": "version-2-is-out",
"spaceId": "sp_01HXAMPLE",
"status": "PUBLISHED",
"tag_names": [
"release"
],
"tags": [
{
"description": "Release notes",
"id": "tag_01HXAMPLE",
"slug": "release",
"title": "release"
}
],
"title": "Version 2 is out"
}
}Create space
Create a space in the community.
Inputs
- Name
nametextRequired - The space's name.
- Description
descriptiontext - What the space is for.
- Type
space_typetext - Who can post in the space. Defaults to Group.One of:
Group(Group (members post and reply)),Broadcast(Broadcast (only admins post)),Page. - Private
privatetext - Only members the space admits can see a private space.One of:
true(Yes),false(No). - Hidden
hiddentext - Keep the space out of the community's space lists.One of:
true(Yes),false(No).
Outputs
spaceobject- The new space
Example output
{
"space": {
"collection": {
"id": "col_01HX",
"name": "Community"
},
"createdAt": "2026-01-15T09:30:00Z",
"description": "News about the product.",
"hidden": false,
"id": "sp_01HXAMPLE",
"inviteOnly": false,
"membersCount": 12,
"name": "Product updates",
"postsCount": 3,
"private": false,
"relativeUrl": "/product-updates",
"slug": "product-updates",
"type": "Group",
"url": "https://community.example.com/product-updates"
}
}Create tag
Create a tag that posts can carry.
Inputs
- Title
titletextRequired - The tag's name.
- Description
descriptiontext - What the tag is for.
Outputs
tagobject- The new tag
Example output
{
"tag": {
"description": "Release notes",
"id": "tag_01HXAMPLE",
"slug": "release",
"title": "release"
}
}Delete post
Delete a post or a reply. This cannot be undone.
Inputs
- Post ID
post_idtextRequired - The post's id, from 'List posts' or 'Create post'.
Outputs
deletedtrue/false- Always true once deleted
post_idtext- The post deleted
Example output
{
"deleted": true,
"post_id": "po_01HXAMPLE"
}Delete space
Delete a space and every post in it. This cannot be undone.
Inputs
- Space
space_idtextRequired - The space. Pick one, or give its id from an earlier step.
Outputs
deletedtrue/false- Always true once deleted
space_idtext- The space deleted
Example output
{
"deleted": true,
"space_id": "sp_01HXAMPLE"
}Delete tag
Delete a tag. Posts that carried it lose it.
Inputs
- Tag ID
tag_idtextRequired - The tag's id, from 'List tags' or 'Create tag'.
Outputs
deletedtrue/false- Always true once deleted
tag_idtext- The tag deleted
Example output
{
"deleted": true,
"tag_id": "tag_01HXAMPLE"
}Get community
Get the connected community: its name, domain, description, language and member count.
Inputs
None.
Outputs
communityobject- The community
Example output
{
"community": {
"createdAt": "2025-06-01T10:00:00Z",
"description": "Where Acme users meet.",
"domain": "community.example.com",
"id": "net_01HXAMPLE",
"locale": "en",
"membersCount": 120,
"name": "Acme Community"
}
}Get member
Get one member with their name, email, role and status.
Inputs
- Member ID
member_idtextRequired - The member's id, from 'List members'.
Outputs
memberobject- The member
Example output
{
"member": {
"createdAt": "2026-01-01T08:00:00Z",
"displayName": "Jo Bloggs",
"email": "jo@example.com",
"id": "mem_01HXAMPLE",
"lastSeenAt": "2026-01-15T09:00:00Z",
"locale": "en",
"name": "Jo Bloggs",
"relativeUrl": "/member/jo",
"role": {
"id": "role_01HX",
"name": "Admin"
},
"status": "VERIFIED",
"tagline": "Community manager",
"url": "https://community.example.com/member/jo",
"username": "jo"
}
}Get post
Get one post with its title, content, tags and counts.
Inputs
- Post ID
post_idtextRequired - The post's id, from 'List posts' or 'Create post'.
Outputs
postobject- The post
Example output
{
"post": {
"content": "<p>Read the notes.</p>",
"createdAt": "2026-01-15T09:35:00Z",
"id": "po_01HXAMPLE",
"isHidden": false,
"lastActivityAt": "2026-01-15T09:35:00Z",
"locked": false,
"ownerId": "mem_01HXAMPLE",
"positiveReactionsCount": 0,
"postTypeId": "pt_01HXAMPLE",
"publishedAt": "2026-01-15T09:35:00Z",
"reactionsCount": 0,
"relativeUrl": "/product-updates/post/version-2-is-out-po_01HXAMPLE",
"repliedToId": null,
"repliesCount": 0,
"shortContent": "Read the notes.",
"slug": "version-2-is-out",
"spaceId": "sp_01HXAMPLE",
"status": "PUBLISHED",
"tag_names": [
"release"
],
"tags": [
{
"description": "Release notes",
"id": "tag_01HXAMPLE",
"slug": "release",
"title": "release"
}
],
"title": "Version 2 is out"
}
}Get space
Get one space with its description, type, privacy and counts.
Inputs
- Space
space_idtextRequired - The space. Pick one, or give its id from an earlier step.
Outputs
spaceobject- The space
Example output
{
"space": {
"collection": {
"id": "col_01HX",
"name": "Community"
},
"createdAt": "2026-01-15T09:30:00Z",
"description": "News about the product.",
"hidden": false,
"id": "sp_01HXAMPLE",
"inviteOnly": false,
"membersCount": 12,
"name": "Product updates",
"postsCount": 3,
"private": false,
"relativeUrl": "/product-updates",
"slug": "product-updates",
"type": "Group",
"url": "https://community.example.com/product-updates"
}
}List members
List the community's members, optionally filtered by name or status. Gets one page; to see more, run it again with the next page it gives.
Inputs
- Search
querytext - Only those whose name matches this text.
- Status
statustext - Only members with this status.One of:
VERIFIED(Verified (default)),UNVERIFIED,BLOCKED,Suspended. - Page size
limitnumber - How many to return, 1 to 100. Defaults to 20.From 1 to 100.
- Next page cursor
aftertext - The 'next_cursor' from an earlier page, to get the page after it.
Outputs
countnumber- How many are on this page
memberslist- The members
next_cursortext- Pass as 'After' to get the next page; empty on the last page
total_countnumber- How many there are in all
Example output
{
"count": 1,
"members": [
{
"createdAt": "2026-01-01T08:00:00Z",
"displayName": "Jo Bloggs",
"email": "jo@example.com",
"id": "mem_01HXAMPLE",
"lastSeenAt": "2026-01-15T09:00:00Z",
"locale": "en",
"name": "Jo Bloggs",
"relativeUrl": "/member/jo",
"role": {
"id": "role_01HX",
"name": "Admin"
},
"status": "VERIFIED",
"tagline": "Community manager",
"url": "https://community.example.com/member/jo",
"username": "jo"
}
],
"next_cursor": "",
"total_count": 1
}List posts
List posts in the community or in one space. Gets one page; to see more, run it again with the next page it gives.
Inputs
- Space
space_idtext - Only posts in this space. Leave empty for all.
- Sort by
order_bytext - How to order the posts. Defaults to publish date.One of:
publishedAt(Publish date (default)),createdAt(Created),updatedAt(Last edited),lastActivityAt(Last activity),repliesCount(Number of replies),reactionsCount(Number of reactions). - Order
directiontext - Which end of the sort to start from. Defaults to newest first.One of:
desc(Newest first (default)),asc(Oldest first). - Page size
limitnumber - How many to return, 1 to 100. Defaults to 20.From 1 to 100.
- Next page cursor
aftertext - The 'next_cursor' from an earlier page, to get the page after it.
Outputs
countnumber- How many are on this page
next_cursortext- Pass as 'After' to get the next page; empty on the last page
postslist- The posts
total_countnumber- How many there are in all
Example output
{
"count": 1,
"next_cursor": "",
"posts": [
{
"content": "<p>Read the notes.</p>",
"createdAt": "2026-01-15T09:35:00Z",
"id": "po_01HXAMPLE",
"isHidden": false,
"lastActivityAt": "2026-01-15T09:35:00Z",
"locked": false,
"ownerId": "mem_01HXAMPLE",
"positiveReactionsCount": 0,
"postTypeId": "pt_01HXAMPLE",
"publishedAt": "2026-01-15T09:35:00Z",
"reactionsCount": 0,
"relativeUrl": "/product-updates/post/version-2-is-out-po_01HXAMPLE",
"repliedToId": null,
"repliesCount": 0,
"shortContent": "Read the notes.",
"slug": "version-2-is-out",
"spaceId": "sp_01HXAMPLE",
"status": "PUBLISHED",
"tag_names": [
"release"
],
"tags": [
{
"description": "Release notes",
"id": "tag_01HXAMPLE",
"slug": "release",
"title": "release"
}
],
"title": "Version 2 is out"
}
],
"total_count": 1
}List replies
List the replies to a post. Gets one page; to see more, run it again with the next page it gives.
Inputs
- Post ID
post_idtextRequired - The post's id, from 'List posts' or 'Create post'.
- Sort by
order_bytext - How to order the replies. Defaults to created.One of:
createdAt(Created (default)),reactionsCount(Number of reactions),repliesCount(Number of replies). - Order
directiontext - Which end of the sort to start from. Defaults to newest first.One of:
desc(Newest first (default)),asc(Oldest first). - Page size
limitnumber - How many to return, 1 to 100. Defaults to 20.From 1 to 100.
- Next page cursor
aftertext - The 'next_cursor' from an earlier page, to get the page after it.
Outputs
countnumber- How many are on this page
next_cursortext- Pass as 'After' to get the next page; empty on the last page
replieslist- The replies
total_countnumber- How many there are in all
Example output
{
"count": 1,
"next_cursor": "",
"replies": [
{
"content": "<p>Read the notes.</p>",
"createdAt": "2026-01-15T09:35:00Z",
"id": "po_01HXAMPLE",
"isHidden": false,
"lastActivityAt": "2026-01-15T09:35:00Z",
"locked": false,
"ownerId": "mem_01HXAMPLE",
"positiveReactionsCount": 0,
"postTypeId": "pt_01HXAMPLE",
"publishedAt": "2026-01-15T09:35:00Z",
"reactionsCount": 0,
"relativeUrl": "/product-updates/post/version-2-is-out-po_01HXAMPLE",
"repliedToId": "po_01HXAMPLE",
"repliesCount": 0,
"shortContent": "Read the notes.",
"slug": "version-2-is-out",
"spaceId": "sp_01HXAMPLE",
"status": "PUBLISHED",
"tag_names": [
"release"
],
"tags": [
{
"description": "Release notes",
"id": "tag_01HXAMPLE",
"slug": "release",
"title": "release"
}
],
"title": "Version 2 is out"
}
],
"total_count": 1
}List spaces
List the community's spaces, optionally filtered by name or type. Gets one page; to see more, run it again with the next page it gives.
Inputs
- Search
querytext - Only those whose name matches this text.
- Type
space_typetext - Only spaces of this type.One of:
Group(Group (members post and reply)),Broadcast(Broadcast (only admins post)),Page. - Sort by
order_bytext - How to order the spaces. Defaults to community order.One of:
CUSTOM_ORDERING_INDEX(Community order (default)),CREATED_AT(Newest created),UPDATED_AT(Recently updated). - Page size
limitnumber - How many to return, 1 to 100. Defaults to 20.From 1 to 100.
- Next page cursor
aftertext - The 'next_cursor' from an earlier page, to get the page after it.
Outputs
countnumber- How many are on this page
next_cursortext- Pass as 'After' to get the next page; empty on the last page
spaceslist- The spaces
total_countnumber- How many there are in all
Example output
{
"count": 1,
"next_cursor": "",
"spaces": [
{
"collection": {
"id": "col_01HX",
"name": "Community"
},
"createdAt": "2026-01-15T09:30:00Z",
"description": "News about the product.",
"hidden": false,
"id": "sp_01HXAMPLE",
"inviteOnly": false,
"membersCount": 12,
"name": "Product updates",
"postsCount": 3,
"private": false,
"relativeUrl": "/product-updates",
"slug": "product-updates",
"type": "Group",
"url": "https://community.example.com/product-updates"
}
],
"total_count": 1
}List tags
List the community's tags. Gets one page; to see more, run it again with the next page it gives.
Inputs
- Search
querytext - Only those whose name matches this text.
- Page size
limitnumber - How many to return, 1 to 100. Defaults to 20.From 1 to 100.
- Next page cursor
aftertext - The 'next_cursor' from an earlier page, to get the page after it.
Outputs
countnumber- How many are on this page
next_cursortext- Pass as 'After' to get the next page; empty on the last page
tagslist- The tags
total_countnumber- How many there are in all
Example output
{
"count": 1,
"next_cursor": "",
"tags": [
{
"description": "Release notes",
"id": "tag_01HXAMPLE",
"slug": "release",
"title": "release"
}
],
"total_count": 1
}Update post
Change a post's title, content or tags, or lock it. Fields left empty keep their current value.
Inputs
- Post ID
post_idtextRequired - The post's id, from 'List posts' or 'Create post'.
- Title
titletext - A new title.
- Content
contenttext - The text, as HTML such as <p>Hello</p> or plain text.
- Tags
tagstext - Tag names, comma separated. Bettermode creates any that do not exist.
- Locked
lockedtext - A locked post takes no new replies.One of:
true(Yes),false(No).
Outputs
postobject- The updated post
Example output
{
"post": {
"content": "<p>Read the notes.</p>",
"createdAt": "2026-01-15T09:35:00Z",
"id": "po_01HXAMPLE",
"isHidden": false,
"lastActivityAt": "2026-01-15T09:35:00Z",
"locked": false,
"ownerId": "mem_01HXAMPLE",
"positiveReactionsCount": 0,
"postTypeId": "pt_01HXAMPLE",
"publishedAt": "2026-01-15T09:35:00Z",
"reactionsCount": 0,
"relativeUrl": "/product-updates/post/version-2-is-out-po_01HXAMPLE",
"repliedToId": null,
"repliesCount": 0,
"shortContent": "Read the notes.",
"slug": "version-2-is-out",
"spaceId": "sp_01HXAMPLE",
"status": "PUBLISHED",
"tag_names": [
"release"
],
"tags": [
{
"description": "Release notes",
"id": "tag_01HXAMPLE",
"slug": "release",
"title": "release"
}
],
"title": "Version 2 is out"
}
}Update space
Change a space's name, description, type or privacy. Fields left empty keep their current value.
Inputs
- Space
space_idtextRequired - The space. Pick one, or give its id from an earlier step.
- Name
nametext - A new name for the space.
- Description
descriptiontext - What the space is for.
- Type
space_typetext - Who can post in the space. Defaults to Group.One of:
Group(Group (members post and reply)),Broadcast(Broadcast (only admins post)),Page. - Private
privatetext - Only members the space admits can see a private space.One of:
true(Yes),false(No). - Hidden
hiddentext - Keep the space out of the community's space lists.One of:
true(Yes),false(No).
Outputs
spaceobject- The updated space
Example output
{
"space": {
"collection": {
"id": "col_01HX",
"name": "Community"
},
"createdAt": "2026-01-15T09:30:00Z",
"description": "News about the product.",
"hidden": false,
"id": "sp_01HXAMPLE",
"inviteOnly": false,
"membersCount": 12,
"name": "Product updates",
"postsCount": 3,
"private": false,
"relativeUrl": "/product-updates",
"slug": "product-updates",
"type": "Group",
"url": "https://community.example.com/product-updates"
}
}Update tag
Rename a tag or change its description. Fields left empty keep their current value.
Inputs
- Tag ID
tag_idtextRequired - The tag's id, from 'List tags' or 'Create tag'.
- Title
titletext - A new name for the tag.
- Description
descriptiontext - A new description.
Outputs
tagobject- The updated tag
Example output
{
"tag": {
"description": "Release notes",
"id": "tag_01HXAMPLE",
"slug": "release",
"title": "release"
}
}