# Bettermode

> Run your Bettermode community: create and manage spaces, publish, edit and delete posts and replies, react, manage tags and look up members.

App · 20 actions. Web page: https://docs.lodol.com/docs/integrations/bettermode

## Actions

### Add reaction

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

**Inputs**

- Post ID (`post_id`, text, required): The post's id, from 'List posts' or 'Create post'.
- Reaction (`reaction`, text): The reaction's name. Defaults to +1 (a thumbs up).

**Outputs**

- `added` (true/false): Always true once added
- `post_id` (text): The post reacted to
- `reaction` (text): The reaction added

**Example output**

```json
{
  "added": true,
  "post_id": "po_01HXAMPLE",
  "reaction": "+1"
}
```

### Create post

Publish a post in a space, as the signed-in member.

**Inputs**

- Space (`space_id`, text, required): The space. Pick one, or give its id from an earlier step.
- Post type (`post_type_id`, text): The kind of post, such as a discussion or question. Defaults to the community's ordinary post.
- Title (`title`, text, required): The post's title.
- Content (`content`, text): The text, as HTML such as <p>Hello</p> or plain text.
- Tags (`tags`, text): Tag names, comma separated. Bettermode creates any that do not exist.
- Publish now (`publish`, text): No saves a draft. Defaults to yes. One of: `true` (Yes), `false` (No).

**Outputs**

- `post` (object): The new post

**Example output**

```json
{
  "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_id`, text, required): The post's id, from 'List posts' or 'Create post'.
- Reply (`content`, text, required): The text, as HTML such as <p>Hello</p> or plain text.

**Outputs**

- `reply` (object): The new reply

**Example output**

```json
{
  "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 (`name`, text, required): The space's name.
- Description (`description`, text): What the space is for.
- Type (`space_type`, text): Who can post in the space. Defaults to Group. One of: `Group` (Group (members post and reply)), `Broadcast` (Broadcast (only admins post)), `Page`.
- Private (`private`, text): Only members the space admits can see a private space. One of: `true` (Yes), `false` (No).
- Hidden (`hidden`, text): Keep the space out of the community's space lists. One of: `true` (Yes), `false` (No).

**Outputs**

- `space` (object): The new space

**Example output**

```json
{
  "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 (`title`, text, required): The tag's name.
- Description (`description`, text): What the tag is for.

**Outputs**

- `tag` (object): The new tag

**Example output**

```json
{
  "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_id`, text, required): The post's id, from 'List posts' or 'Create post'.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `post_id` (text): The post deleted

**Example output**

```json
{
  "deleted": true,
  "post_id": "po_01HXAMPLE"
}
```

### Delete space

Delete a space and every post in it. This cannot be undone.

**Inputs**

- Space (`space_id`, text, required): The space. Pick one, or give its id from an earlier step.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `space_id` (text): The space deleted

**Example output**

```json
{
  "deleted": true,
  "space_id": "sp_01HXAMPLE"
}
```

### Delete tag

Delete a tag. Posts that carried it lose it.

**Inputs**

- Tag ID (`tag_id`, text, required): The tag's id, from 'List tags' or 'Create tag'.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `tag_id` (text): The tag deleted

**Example output**

```json
{
  "deleted": true,
  "tag_id": "tag_01HXAMPLE"
}
```

### Get community

Get the connected community: its name, domain, description, language and member count.

**Inputs**: None.

**Outputs**

- `community` (object): The community

**Example output**

```json
{
  "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_id`, text, required): The member's id, from 'List members'.

**Outputs**

- `member` (object): The member

**Example output**

```json
{
  "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_id`, text, required): The post's id, from 'List posts' or 'Create post'.

**Outputs**

- `post` (object): The post

**Example output**

```json
{
  "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_id`, text, required): The space. Pick one, or give its id from an earlier step.

**Outputs**

- `space` (object): The space

**Example output**

```json
{
  "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 (`query`, text): Only those whose name matches this text.
- Status (`status`, text): Only members with this status. One of: `VERIFIED` (Verified (default)), `UNVERIFIED`, `BLOCKED`, `Suspended`.
- Page size (`limit`, number): How many to return, 1 to 100. Defaults to 20. From 1 to 100.
- Next page cursor (`after`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many are on this page
- `members` (list): The members
- `next_cursor` (text): Pass as 'After' to get the next page; empty on the last page
- `total_count` (number): How many there are in all

**Example output**

```json
{
  "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_id`, text): Only posts in this space. Leave empty for all.
- Sort by (`order_by`, text): 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 (`direction`, text): Which end of the sort to start from. Defaults to newest first. One of: `desc` (Newest first (default)), `asc` (Oldest first).
- Page size (`limit`, number): How many to return, 1 to 100. Defaults to 20. From 1 to 100.
- Next page cursor (`after`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many are on this page
- `next_cursor` (text): Pass as 'After' to get the next page; empty on the last page
- `posts` (list): The posts
- `total_count` (number): How many there are in all

**Example output**

```json
{
  "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_id`, text, required): The post's id, from 'List posts' or 'Create post'.
- Sort by (`order_by`, text): How to order the replies. Defaults to created. One of: `createdAt` (Created (default)), `reactionsCount` (Number of reactions), `repliesCount` (Number of replies).
- Order (`direction`, text): Which end of the sort to start from. Defaults to newest first. One of: `desc` (Newest first (default)), `asc` (Oldest first).
- Page size (`limit`, number): How many to return, 1 to 100. Defaults to 20. From 1 to 100.
- Next page cursor (`after`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many are on this page
- `next_cursor` (text): Pass as 'After' to get the next page; empty on the last page
- `replies` (list): The replies
- `total_count` (number): How many there are in all

**Example output**

```json
{
  "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 (`query`, text): Only those whose name matches this text.
- Type (`space_type`, text): Only spaces of this type. One of: `Group` (Group (members post and reply)), `Broadcast` (Broadcast (only admins post)), `Page`.
- Sort by (`order_by`, text): 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 (`limit`, number): How many to return, 1 to 100. Defaults to 20. From 1 to 100.
- Next page cursor (`after`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many are on this page
- `next_cursor` (text): Pass as 'After' to get the next page; empty on the last page
- `spaces` (list): The spaces
- `total_count` (number): How many there are in all

**Example output**

```json
{
  "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 (`query`, text): Only those whose name matches this text.
- Page size (`limit`, number): How many to return, 1 to 100. Defaults to 20. From 1 to 100.
- Next page cursor (`after`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many are on this page
- `next_cursor` (text): Pass as 'After' to get the next page; empty on the last page
- `tags` (list): The tags
- `total_count` (number): How many there are in all

**Example output**

```json
{
  "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_id`, text, required): The post's id, from 'List posts' or 'Create post'.
- Title (`title`, text): A new title.
- Content (`content`, text): The text, as HTML such as <p>Hello</p> or plain text.
- Tags (`tags`, text): Tag names, comma separated. Bettermode creates any that do not exist.
- Locked (`locked`, text): A locked post takes no new replies. One of: `true` (Yes), `false` (No).

**Outputs**

- `post` (object): The updated post

**Example output**

```json
{
  "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_id`, text, required): The space. Pick one, or give its id from an earlier step.
- Name (`name`, text): A new name for the space.
- Description (`description`, text): What the space is for.
- Type (`space_type`, text): Who can post in the space. Defaults to Group. One of: `Group` (Group (members post and reply)), `Broadcast` (Broadcast (only admins post)), `Page`.
- Private (`private`, text): Only members the space admits can see a private space. One of: `true` (Yes), `false` (No).
- Hidden (`hidden`, text): Keep the space out of the community's space lists. One of: `true` (Yes), `false` (No).

**Outputs**

- `space` (object): The updated space

**Example output**

```json
{
  "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_id`, text, required): The tag's id, from 'List tags' or 'Create tag'.
- Title (`title`, text): A new name for the tag.
- Description (`description`, text): A new description.

**Outputs**

- `tag` (object): The updated tag

**Example output**

```json
{
  "tag": {
    "description": "Release notes",
    "id": "tag_01HXAMPLE",
    "slug": "release",
    "title": "release"
  }
}
```
