> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Canny

The Canny connector lets your AI agent act in each user's Canny account. Each user connects their own Canny API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 30 tools.

**Authentication:** API Key
**Categories:** Customer Support, Project Management
**Tools:** 30: 14 read, 13 write, 3 destructive
**Users sign in with:** API key
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=CANNY)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Canny connection

   In **AgentKit > Connections**, create a Canny connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'canny'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Canny:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'canny_boards_list',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "canny"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Canny:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="canny_boards_list",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their Canny credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'canny_board_get',
  toolInput: {
    board_id: '<board_id>',
  },
  connector: 'canny',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="canny_board_get",
    tool_input={
        "board_id": "<board_id>",
    },
    connection_name="canny",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `canny_board_get`

Get Board · Read-only

Get one Canny board by ID.
Returns the board's id, name, postCount, isPrivate, privateComments, url and created time.
Use List Boards to find board IDs.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `board_id` (`string`, required): Canny ID of the board. Get it from List Boards. Example: 5f3a1b2c4d5e6f7890123456.

Example input: `{"board_id":"<board_id>"}`

### `canny_boards_list`

List Boards · Read-only

List every feedback board in the Canny workspace.
Returns boards with id, name, postCount, isPrivate, privateComments, url and created time.
Use this to get a board_id for the post, category and tag tools.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `canny_categories_list`

List Categories · Read-only

List post categories in Canny, optionally for one board.
Returns categories with id, name, board, parentID, postCount and url.
Use this to get a category_id for Create Post or Change Post Category.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `board_id` (`string`, optional): Only return results from this board. Get board IDs from List Boards. Example: 5f3a1b2c4d5e6f7890123456.
- `limit` (`integer`, optional): Number of results to return, 1 to 10000. Canny defaults to 10. Example: 25.
- `skip` (`integer`, optional): Number of results to skip before returning, for paging. Canny defaults to 0. Example: 25.

Example input: `{}`

### `canny_changelog_entries_list`

List Changelog Entries · Read-only

List changelog entries in Canny, filtered by label, type or status.
Returns hasMore and entries with id, title, markdownDetails, plaintextDetails, status, types, labels, linked posts, publishedAt, scheduledFor and url.
Use Create Changelog Entry to add one.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `label_ids` (`array`, optional): Only entries with at least one of these labels. Example: ["5f3a1b2c4d5e6f7890123456"].
- `limit` (`integer`, optional): Number of results to return, 1 to 10000. Canny defaults to 10. Example: 25.
- `skip` (`integer`, optional): Entries to skip, up to 1,000. Canny defaults to 0. Example: 10.
- `sort` (`string`, optional): Sort order: created, lastSaved, publishedAt or nonPublishedFirst. Example: publishedAt. One of: `created`, `lastSaved`, `publishedAt`, `nonPublishedFirst`.
- `status` (`string`, optional): Comma-separated statuses: draft, scheduled, published. All if omitted. Example: published.
- `type` (`string`, optional): Entry type: new, improved or fixed. Example: new. One of: `new`, `improved`, `fixed`.

Example input: `{}`

### `canny_comment_get`

Get Comment · Read-only

Get one Canny comment by ID.
Returns the comment's id, value, author, board, post, parentID, internal flag, imageURLs, likeCount and created time.
Use List Comments to find comment IDs.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `comment_id` (`string`, required): Canny ID of the comment. Get it from List Comments. Example: 5f3a1b2c4d5e6f7890123456.

Example input: `{"comment_id":"<comment_id>"}`

### `canny_comments_list`

List Comments · Read-only

List comments in Canny, filtered by post, board, author or company, with cursor paging.
Returns hasNextPage, cursor and items, each a comment with id, value, author, board, post, parentID, internal flag, imageURLs, likeCount and created time.
Use Get Comment for one comment.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `author_id` (`string`, optional): Canny ID of the comment author. Get it from List Users. Example: 5f3a1b2c4d5e6f7890123456.
- `board_id` (`string`, optional): Only return results from this board. Get board IDs from List Boards. Example: 5f3a1b2c4d5e6f7890123456.
- `company_id` (`string`, optional): Only return results from users linked to the company with this custom identifier (the ID from your own system). Example: acme-inc.
- `cursor` (`string`, optional): Pagination cursor from the previous response, to fetch the next page. Example: 6a2889c586d7b8843bf4cf10.
- `limit` (`integer`, optional): Number of results to return, 1 to 100. Canny defaults to 10. Example: 25.
- `post_id` (`string`, optional): Canny ID of the post. Get it from List Posts. Example: 5f3a1b2c4d5e6f7890123456.

Example input: `{}`

### `canny_companies_list`

List Companies · Read-only

List companies in Canny, optionally searched by name or filtered by segment, with cursor paging.
Returns hasNextPage, cursor and companies with id, name, domain, memberCount, monthlySpend, customFields and created time.
Use the company id as company_id in the list tools.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `cursor` (`string`, optional): Pagination cursor from the previous response, to fetch the next page. Example: 6a2889c586d7b8843bf4cf10.
- `limit` (`integer`, optional): Number of results to return, 1 to 100. Canny defaults to 10. Example: 25.
- `search` (`string`, optional): Search by company name. Example: Acme.
- `segment` (`string`, optional): URL name of a segment to filter by. Example: enterprise.

Example input: `{}`

### `canny_post_get`

Get Post · Read-only

Get one Canny post by its ID, or by its urlName and board.
Returns the post's id, title, details, status, score, commentCount, board, category, tags, author, owner, eta, custom fields and url.
Pass post_id, or url_name with board_id.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `board_id` (`string`, optional): Board of the post. Only needed with url_name. Example: 5f3a1b2c4d5e6f7890123456.
- `post_id` (`string`, optional): Canny ID of the post. Get it from List Posts. Example: 5f3a1b2c4d5e6f7890123456.
- `url_name` (`string`, optional): The post's urlName (the slug in its URL). Requires board_id. Example: dark-mode.

Example input: `{}`

### `canny_posts_list`

List Posts · Read-only

List feedback posts in Canny, filtered by board, author, company, tags, status or a search query.
Returns hasMore and posts with id, title, details, status, score, commentCount, board, category, tags, author, eta and url.
Use Get Post for one post. Page with limit and skip.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `author_id` (`string`, optional): Canny ID of the author (a Canny user). Get it from List Users or Get User. Example: 5f3a1b2c4d5e6f7890123456.
- `board_id` (`string`, optional): Only return results from this board. Get board IDs from List Boards. Example: 5f3a1b2c4d5e6f7890123456.
- `company_id` (`string`, optional): Only return results from users linked to the company with this custom identifier (the ID from your own system). Example: acme-inc.
- `limit` (`integer`, optional): Number of results to return. Canny defaults to 10. Example: 25.
- `search` (`string`, optional): Only return posts matching this search query. Example: dark mode.
- `skip` (`integer`, optional): Number of results to skip before returning, for paging. Canny defaults to 0. Example: 25.
- `sort` (`string`, optional): Sort order: newest, oldest, relevance (only with search), score, statusChanged or trending. Canny defaults to newest. Example: score. One of: `newest`, `oldest`, `relevance`, `score`, `statusChanged`, `trending`.
- `status` (`string`, optional): Comma-separated statuses to include, such as open, under review, planned, in progress, complete, closed or a custom status. Example: planned,in progress.
- `tag_ids` (`array`, optional): Only return posts with at least one of these tags. Get IDs from List Tags. Example: ["5f3a1b2c4d5e6f7890123456"].

Example input: `{}`

### `canny_status_changes_list`

List Status Changes · Read-only

List post status changes in Canny, newest first, optionally for one board, with cursor paging.
Returns hasNextPage, cursor and items with id, post, status, changer, changeComment and created time.
Use this to track roadmap progress.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `board_id` (`string`, optional): Only return results from this board. Get board IDs from List Boards. Example: 5f3a1b2c4d5e6f7890123456.
- `cursor` (`string`, optional): Pagination cursor from the previous response, to fetch the next page. Example: 6a2889c586d7b8843bf4cf10.
- `limit` (`integer`, optional): Number of results to return, 1 to 100. Canny defaults to 10. Example: 25.

Example input: `{}`

### `canny_tags_list`

List Tags · Read-only

List post tags in Canny, optionally for one board.
Returns hasMore and tags with id, name, board, postCount and url.
Use this to get a tag_id for Add Post Tag or List Posts.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `board_id` (`string`, optional): Only return results from this board. Get board IDs from List Boards. Example: 5f3a1b2c4d5e6f7890123456.
- `limit` (`integer`, optional): Number of results to return. Canny defaults to 10. Example: 25.
- `skip` (`integer`, optional): Number of results to skip before returning, for paging. Canny defaults to 0. Example: 25.

Example input: `{}`

### `canny_user_get`

Get User · Read-only

Get one Canny user by Canny ID, by your app's user ID, or by email.
Returns the user's id, name, email, userID, alias, isAdmin, avatarURL, customFields, lastActivity, url and created time.
Pass exactly one of user_id, app_user_id or email.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `app_user_id` (`string`, optional): The user's ID in your own application (Canny's userID). Example: user-123.
- `email` (`string`, optional): The user's email address. Example: jane@acme.com.
- `user_id` (`string`, optional): Canny ID of the user. Get it from List Users. Example: 5f3a1b2c4d5e6f7890123456.

Example input: `{}`

### `canny_users_list`

List Users · Read-only

List end users and admins in the Canny workspace, with cursor paging.
Returns hasNextPage, cursor and users with id, name, email, userID, alias, isAdmin, avatarURL, customFields, lastActivity, url and created time.
Use Get User to look up one user by email or ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `cursor` (`string`, optional): Pagination cursor from the previous response, to fetch the next page. Example: 6a2889c586d7b8843bf4cf10.
- `limit` (`integer`, optional): Number of results to return, 1 to 100. Canny defaults to 10. Example: 25.

Example input: `{}`

### `canny_votes_list`

List Votes · Read-only

List votes in Canny, filtered by post, board, user or company, with cursor paging.
Returns hasNextPage, cursor and items, each a vote with its id, board, post, by (the admin who cast it, if any) and created time.
Use this to see who wants a feature.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `board_id` (`string`, optional): Only return results from this board. Get board IDs from List Boards. Example: 5f3a1b2c4d5e6f7890123456.
- `company_id` (`string`, optional): Only return results from users linked to the company with this custom identifier (the ID from your own system). Example: acme-inc.
- `cursor` (`string`, optional): Pagination cursor from the previous response, to fetch the next page. Example: 6a2889c586d7b8843bf4cf10.
- `limit` (`integer`, optional): Number of results to return, 1 to 100. Canny defaults to 10. Example: 25.
- `post_id` (`string`, optional): Canny ID of the post. Get it from List Posts. Example: 5f3a1b2c4d5e6f7890123456.
- `user_id` (`string`, optional): Canny ID of the voter (a Canny user). Get it from List Users. Example: 5f3a1b2c4d5e6f7890123456.

Example input: `{}`

### `canny_category_create`

Create Category · Write

Create a post category (or subcategory) on a Canny board.
Returns the new category's id.
Use List Boards to get the board ID.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `board_id` (`string`, required): Canny ID of the board. Get it from List Boards. Example: 5f3a1b2c4d5e6f7890123456.
- `name` (`string`, required): Category name, 1 to 30 characters. Example: Integrations.
- `subscribe_admins` (`boolean`, required): Whether the board's admins are subscribed to the new category. Example: false.
- `parent_id` (`string`, optional): Canny ID of the parent category, to create a subcategory. Get it from List Categories. Example: 5f3a1b2c4d5e6f7890123456.

Example input: `{"board_id":"<board_id>","name":"<name>","subscribe_admins":true}`

### `canny_changelog_entry_create`

Create Changelog Entry · Write

Create a changelog entry in Canny as a draft, scheduled or published, optionally linked to posts.
Returns the new entry's id.
Publishing with notify true emails users.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `details` (`string`, required): Entry details (Markdown). Example: You can now switch to a dark theme in Settings.
- `title` (`string`, required): Entry title. Example: Dark mode is here.
- `label_ids` (`array`, optional): Label IDs to assign. Example: ["5f3a1b2c4d5e6f7890123456"].
- `notify` (`boolean`, optional): Whether to email users after publishing. Canny defaults to false. Example: false.
- `post_ids` (`array`, optional): Post IDs to link; a post already linked to another entry cannot be added. Example: ["5f3a1b2c4d5e6f7890123456"].
- `published` (`boolean`, optional): Whether to publish now. Canny defaults to false (draft). Example: true.
- `published_on` (`string`, optional): Past publish date when published is true, ISO 8601. Example: 2026-01-15T00:00:00Z.
- `scheduled_for` (`string`, optional): Future publish date when published is false, ISO 8601. Example: 2026-12-01T09:00:00Z.
- `type` (`string`, optional): Entry type: new, improved or fixed. Example: new. One of: `new`, `improved`, `fixed`.

Example input: `{"details":"<details>","title":"<title>"}`

### `canny_comment_create`

Create Comment · Write

Post a comment or reply on a Canny post on behalf of a user, optionally internal-only.
Returns the new comment's id.
Set parent_id to reply to a comment. Notification emails go out only when should_notify_voters is true.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `author_id` (`string`, required): Canny ID of the comment author (a Canny user). Get it from Create or Update User or Get User. Example: 5f3a1b2c4d5e6f7890123456.
- `post_id` (`string`, required): Canny ID of the post. Get it from List Posts. Example: 5f3a1b2c4d5e6f7890123456.
- `value` (`string`, required): Comment text, under 2,500 characters. Optional when image_urls are given. Example: Thanks, we're looking into this.
- `created_at` (`string`, optional): Original creation time when importing, ISO 8601. Example: 2025-06-01T12:00:00Z.
- `image_urls` (`array`, optional): Image URLs to attach. Example: ["https://example.com/screenshot.png"].
- `internal` (`boolean`, optional): Whether the comment is visible to your team only. Only allowed when the author is a team member. Canny defaults to false. Example: true.
- `parent_id` (`string`, optional): Canny ID of the comment to reply to. Get it from List Comments. Example: 5f3a1b2c4d5e6f7890123456.
- `should_notify_voters` (`boolean`, optional): Whether the comment may trigger email notifications. Canny defaults to false. Example: false.

Example input: `{"author_id":"<author_id>","post_id":"<post_id>","value":"<value>"}`

### `canny_post_board_change`

Change Post Board · Write

Move a Canny post to another board.
Returns the updated post.
Use List Boards to find the destination board ID.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `board_id` (`string`, required): Canny ID of the destination board. Get it from List Boards. Example: 5f3a1b2c4d5e6f7890123456.
- `post_id` (`string`, required): Canny ID of the post. Get it from List Posts. Example: 5f3a1b2c4d5e6f7890123456.

Example input: `{"board_id":"<board_id>","post_id":"<post_id>"}`

### `canny_post_category_change`

Change Post Category · Write

Move a Canny post into a category, or remove its category.
Returns the updated post.
Leave category_id empty to remove the category.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `post_id` (`string`, required): Canny ID of the post. Get it from List Posts. Example: 5f3a1b2c4d5e6f7890123456.
- `category_id` (`string`, optional): Canny ID of the category. Get it from List Categories. Example: 5f3a1b2c4d5e6f7890123456.

Example input: `{"post_id":"<post_id>"}`

### `canny_post_create`

Create Post · Write

Create a feedback post on a Canny board on behalf of a user.
Returns the new post's id and url.
Use Create or Update User first to get the author's Canny user ID.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `author_id` (`string`, required): Canny ID of the post author (a Canny user). Get it from Create or Update User or Get User. Example: 5f3a1b2c4d5e6f7890123456.
- `board_id` (`string`, required): Canny ID of the board. Get it from List Boards. Example: 5f3a1b2c4d5e6f7890123456.
- `details` (`string`, required): Post details, up to 10,000 characters. Example: Please add a dark theme for night use.
- `title` (`string`, required): Post title, up to 400 characters. Example: Add dark mode.
- `by_id` (`string`, optional): Canny ID of the admin creating the post for the author; shown on the post. Get it from List Users. Example: 5f3a1b2c4d5e6f7890123456.
- `category_id` (`string`, optional): Canny ID of the category or subcategory. Get it from List Categories. Example: 5f3a1b2c4d5e6f7890123456.
- `created_at` (`string`, optional): Original creation time when importing from another tool, ISO 8601. Example: 2025-06-01T12:00:00Z.
- `custom_fields` (`object`, optional): Custom field values keyed by field name. Include every field the board requires. Example: {"Plan": "Pro"}.
- `eta` (`string`, optional): Estimated completion month, as MM/YYYY. Example: 06/2026.
- `eta_public` (`boolean`, optional): Whether the ETA is visible to all users. Example: true.
- `image_urls` (`array`, optional): URLs of images to attach. Example: ["https://example.com/mockup.png"].
- `owner_id` (`string`, optional): Canny ID of the admin responsible for the work. Get it from List Users. Example: 5f3a1b2c4d5e6f7890123456.

Example input: `{"author_id":"<author_id>","board_id":"<board_id>","details":"<details>","title":"<title>"}`

### `canny_post_status_change`

Change Post Status · Write

Change a Canny post's status (open, under review, planned, in progress, complete, closed or a custom status), optionally with a comment and voter notification.
Returns the updated post.
Set should_notify_voters to email voters about the change.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `changer_id` (`string`, required): Canny ID of the admin recorded as making the change. Get it from List Users. Example: 5f3a1b2c4d5e6f7890123456.
- `post_id` (`string`, required): Canny ID of the post. Get it from List Posts. Example: 5f3a1b2c4d5e6f7890123456.
- `should_notify_voters` (`boolean`, required): Whether to notify non-admin voters of the change. Example: false.
- `status` (`string`, required): New status: open, under review, planned, in progress, complete, closed or a custom status of your workspace. Example: planned.
- `comment_image_urls` (`array`, optional): Image URLs for the status-change comment. Example: ["https://example.com/plan.png"].
- `comment_value` (`string`, optional): Comment to attach to the status change. Example: Scheduled for Q3.

Example input: `{"changer_id":"<changer_id>","post_id":"<post_id>","should_notify_voters":true,"status":"<status>"}`

### `canny_post_tag_add`

Add Post Tag · Write

Add a tag to a Canny post.
Returns the updated post.
Use List Tags or Create Tag to get the tag ID.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `post_id` (`string`, required): Canny ID of the post. Get it from List Posts. Example: 5f3a1b2c4d5e6f7890123456.
- `tag_id` (`string`, required): Canny ID of the tag. Get it from List Tags. Example: 5f3a1b2c4d5e6f7890123456.

Example input: `{"post_id":"<post_id>","tag_id":"<tag_id>"}`

### `canny_post_tag_remove`

Remove Post Tag · Write

Remove a tag from a Canny post.
Returns the updated post.
The tag itself is kept.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `post_id` (`string`, required): Canny ID of the post. Get it from List Posts. Example: 5f3a1b2c4d5e6f7890123456.
- `tag_id` (`string`, required): Canny ID of the tag. Get it from List Tags. Example: 5f3a1b2c4d5e6f7890123456.

Example input: `{"post_id":"<post_id>","tag_id":"<tag_id>"}`

### `canny_post_update`

Update Post · Write

Update a Canny post's title, details, ETA, images, owner or custom fields.
Returns success.
Only the fields you pass change. Use Change Post Status to change status and Change Post Category for the category.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `post_id` (`string`, required): Canny ID of the post. Get it from List Posts. Example: 5f3a1b2c4d5e6f7890123456.
- `changer_id` (`string`, optional): Canny ID of the admin making the change; required with owner_id. Get it from List Users. Example: 5f3a1b2c4d5e6f7890123456.
- `custom_fields` (`object`, optional): Custom field values keyed by field name. Example: {"Plan": "Enterprise"}.
- `details` (`string`, optional): New details, up to 10,000 characters. Example: Dark theme for the dashboard and emails.
- `eta` (`string`, optional): Estimated completion month, as MM/YYYY. Example: 09/2026.
- `eta_public` (`boolean`, optional): Whether the ETA is visible to all users. Example: true.
- `image_urls` (`array`, optional): Image URLs that replace the post's images. Pass an empty list to remove all. Example: ["https://example.com/v2.png"].
- `owner_id` (`string`, optional): Canny ID of the admin to make the post's owner; requires changer_id. Get it from List Users. Example: 5f3a1b2c4d5e6f7890123456.
- `title` (`string`, optional): New title, up to 400 characters. Example: Add dark mode to the dashboard.

Example input: `{"post_id":"<post_id>"}`

### `canny_tag_create`

Create Tag · Write

Create a post tag on a Canny board.
Returns the new tag's id, name, board, postCount, url and created time.
Use Add Post Tag to apply it.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `board_id` (`string`, required): Canny ID of the board. Get it from List Boards. Example: 5f3a1b2c4d5e6f7890123456.
- `name` (`string`, required): Tag name. Example: iOS.

Example input: `{"board_id":"<board_id>","name":"<name>"}`

### `canny_user_create_or_update`

Create or Update User · Write

Create a Canny user, or update the one matching the given ID, app user ID or email, including company links and custom fields.
Returns the user's Canny id.
Use this to get an author_id or voter_id before Create Post, Create Comment or Create Vote.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `name` (`string`, required): User's name, up to 50 characters, without : or /. Example: Jane Doe.
- `alias` (`string`, optional): User's alias. Example: jdoe.
- `app_user_id` (`string`, optional): The user's ID in your own application (Canny's userID). Needed to link companies. Example: user-123.
- `avatar_url` (`string`, optional): URL of the user's avatar image. Example: https://example.com/jane.png.
- `companies` (`array`, optional): Companies the user belongs to. Each needs an id (your company identifier) and name, and can have monthlySpend and customFields. Requires app_user_id. Example: [{"id": "acme-inc", "name": "Acme Inc", "monthlySpend": 500}].
- `custom_fields` (`object`, optional): Custom fields; names under 30 characters, text values under 200. Example: {"plan": "Pro"}.
- `email` (`string`, optional): User's email address, up to 200 characters. Example: jane@acme.com.
- `user_id` (`string`, optional): Canny ID of the existing user to update. Get it from List Users. Example: 5f3a1b2c4d5e6f7890123456.

Example input: `{"name":"<name>"}`

### `canny_vote_create`

Create Vote · Write

Add a user's vote to a Canny post, or update its priority.
Returns success.
Use Create or Update User first to get the voter's Canny user ID.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `post_id` (`string`, required): Canny ID of the post. Get it from List Posts. Example: 5f3a1b2c4d5e6f7890123456.
- `voter_id` (`string`, required): Canny ID of the voter (a Canny user). Get it from Create or Update User or Get User. Example: 5f3a1b2c4d5e6f7890123456.
- `by_id` (`string`, optional): Canny ID of the admin casting the vote for the voter. Get it from List Users. Example: 5f3a1b2c4d5e6f7890123456.
- `created_at` (`string`, optional): Original vote time when importing, ISO 8601. Example: 2025-06-01T12:00:00Z.
- `vote_priority` (`string`, optional): Vote priority: Nice to have, Important, Must have, or No priority to clear it. Example: Important. One of: `Nice to have`, `Important`, `Must have`, `No priority`.

Example input: `{"post_id":"<post_id>","voter_id":"<voter_id>"}`

### `canny_comment_delete`

Delete Comment · Destructive

Permanently delete a Canny comment.
Returns success.
This cannot be undone.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `comment_id` (`string`, required): Canny ID of the comment. Get it from List Comments. Example: 5f3a1b2c4d5e6f7890123456.

Example input: `{"comment_id":"<comment_id>"}`

### `canny_post_delete`

Delete Post · Destructive

Permanently delete a Canny post with its comments and votes.
Returns success.
This cannot be undone.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `post_id` (`string`, required): Canny ID of the post. Get it from List Posts. Example: 5f3a1b2c4d5e6f7890123456.

Example input: `{"post_id":"<post_id>"}`

### `canny_vote_delete`

Delete Vote · Destructive

Remove a user's vote from a Canny post.
Returns success.
Use List Votes to find the voter.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `post_id` (`string`, required): Canny ID of the post. Get it from List Posts. Example: 5f3a1b2c4d5e6f7890123456.
- `voter_id` (`string`, required): Canny ID of the voter (a Canny user). Get it from List Votes. Example: 5f3a1b2c4d5e6f7890123456.

Example input: `{"post_id":"<post_id>","voter_id":"<voter_id>"}`

## Related

Other Customer Support connectors ([all 38](/agentkit/connectors/?category=customer-support)):

- [ServiceNow](/agentkit/connectors/servicenow/): Scalekit connector, OAuth, 112 tools
- [Zendesk](/agentkit/connectors/zendeskoauth/): Scalekit connector, OAuth, 137 tools
- [Jira Service Management](/agentkit/connectors/jiraservicemanagement/): Scalekit connector, OAuth, 72 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
