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

ActionWhat it does
Add reactionReact to a post or reply as the signed-in member.
Create postPublish a post in a space, as the signed-in member.
Create replyReply to a post, as the signed-in member.
Create spaceCreate a space in the community.
Create tagCreate a tag that posts can carry.
Delete postDelete a post or a reply.
Delete spaceDelete a space and every post in it.
Delete tagDelete a tag.
Get communityGet the connected community: its name, domain, description, language and member count.
Get memberGet one member with their name, email, role and status.
Get postGet one post with its title, content, tags and counts.
Get spaceGet one space with its description, type, privacy and counts.
List membersList the community's members, optionally filtered by name or status.
List postsList posts in the community or in one space.
List repliesList the replies to a post.
List spacesList the community's spaces, optionally filtered by name or type.
List tagsList the community's tags.
Update postChange a post's title, content or tags, or lock it.
Update spaceChange a space's name, description, type or privacy.
Update tagRename a tag or change its description.

Add reaction

React to a post or reply as the signed-in member.

Inputs

Post IDpost_idtextRequired
The post's id, from 'List posts' or 'Create post'.
Reactionreactiontext
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

Spacespace_idtextRequired
The space. Pick one, or give its id from an earlier step.
Post typepost_type_idtext
The kind of post, such as a discussion or question. Defaults to the community's ordinary post.
TitletitletextRequired
The post's title.
Contentcontenttext
The text, as HTML such as <p>Hello</p> or plain text.
Tagstagstext
Tag names, comma separated. Bettermode creates any that do not exist.
Publish nowpublishtext
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 IDpost_idtextRequired
The post's id, from 'List posts' or 'Create post'.
ReplycontenttextRequired
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

NamenametextRequired
The space's name.
Descriptiondescriptiontext
What the space is for.
Typespace_typetext
Who can post in the space. Defaults to Group.One of: Group (Group (members post and reply)), Broadcast (Broadcast (only admins post)), Page.
Privateprivatetext
Only members the space admits can see a private space.One of: true (Yes), false (No).
Hiddenhiddentext
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

TitletitletextRequired
The tag's name.
Descriptiondescriptiontext
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 IDpost_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

Spacespace_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 IDtag_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 IDmember_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 IDpost_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

Spacespace_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

Searchquerytext
Only those whose name matches this text.
Statusstatustext
Only members with this status.One of: VERIFIED (Verified (default)), UNVERIFIED, BLOCKED, Suspended.
Page sizelimitnumber
How many to return, 1 to 100. Defaults to 20.From 1 to 100.
Next page cursoraftertext
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

Spacespace_idtext
Only posts in this space. Leave empty for all.
Sort byorder_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).
Orderdirectiontext
Which end of the sort to start from. Defaults to newest first.One of: desc (Newest first (default)), asc (Oldest first).
Page sizelimitnumber
How many to return, 1 to 100. Defaults to 20.From 1 to 100.
Next page cursoraftertext
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 IDpost_idtextRequired
The post's id, from 'List posts' or 'Create post'.
Sort byorder_bytext
How to order the replies. Defaults to created.One of: createdAt (Created (default)), reactionsCount (Number of reactions), repliesCount (Number of replies).
Orderdirectiontext
Which end of the sort to start from. Defaults to newest first.One of: desc (Newest first (default)), asc (Oldest first).
Page sizelimitnumber
How many to return, 1 to 100. Defaults to 20.From 1 to 100.
Next page cursoraftertext
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

Searchquerytext
Only those whose name matches this text.
Typespace_typetext
Only spaces of this type.One of: Group (Group (members post and reply)), Broadcast (Broadcast (only admins post)), Page.
Sort byorder_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 sizelimitnumber
How many to return, 1 to 100. Defaults to 20.From 1 to 100.
Next page cursoraftertext
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

Searchquerytext
Only those whose name matches this text.
Page sizelimitnumber
How many to return, 1 to 100. Defaults to 20.From 1 to 100.
Next page cursoraftertext
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 IDpost_idtextRequired
The post's id, from 'List posts' or 'Create post'.
Titletitletext
A new title.
Contentcontenttext
The text, as HTML such as <p>Hello</p> or plain text.
Tagstagstext
Tag names, comma separated. Bettermode creates any that do not exist.
Lockedlockedtext
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

Spacespace_idtextRequired
The space. Pick one, or give its id from an earlier step.
Namenametext
A new name for the space.
Descriptiondescriptiontext
What the space is for.
Typespace_typetext
Who can post in the space. Defaults to Group.One of: Group (Group (members post and reply)), Broadcast (Broadcast (only admins post)), Page.
Privateprivatetext
Only members the space admits can see a private space.One of: true (Yes), false (No).
Hiddenhiddentext
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 IDtag_idtextRequired
The tag's id, from 'List tags' or 'Create tag'.
Titletitletext
A new name for the tag.
Descriptiondescriptiontext
A new description.

Outputs

tagobject
The updated tag
Example output
{
  "tag": {
    "description": "Release notes",
    "id": "tag_01HXAMPLE",
    "slug": "release",
    "title": "release"
  }
}

On this page