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.
- Tools
- 30
- What they doRead · write · destructive
- 14 · 13 · 314 read13 write3 destructive
- Users sign in with
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Canny connection
In AgentKit > Connections, create a Canny connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts 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.actionsconst connector = 'canny'const identifier = 'user_123'// Generate an authorization link for the userconst { 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 callconst result = await actions.executeTool({connector,identifier,toolName: 'canny_boards_list',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_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.actionsconnection_name = "canny"identifier = "user_123"# Generate an authorization link for the userlink_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 callresult = actions.execute_tool(tool_input={},tool_name="canny_boards_list",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their Canny credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolcanny_board_getGet one Canny board by ID.Read-onlyGet Board
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.
Inputs
board_idstringrequired- Canny ID of the board. Get it from List Boards. Example: 5f3a1b2c4d5e6f7890123456.
canny_boards_listList every feedback board in the Canny workspace.Read-onlyList Boards
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.
Inputs
This tool takes no inputs.
canny_categories_listList post categories in Canny, optionally for one board.Read-onlyList Categories
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.
Inputs
board_idstring- Only return results from this board. Get board IDs from List Boards. Example: 5f3a1b2c4d5e6f7890123456.
limitinteger- Number of results to return, 1 to 10000. Canny defaults to 10. Example: 25.
skipinteger- Number of results to skip before returning, for paging. Canny defaults to 0. Example: 25.
canny_changelog_entries_listList changelog entries in Canny, filtered by label, type or status.Read-onlyList Changelog Entries
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.
Inputs
label_idsarray- Only entries with at least one of these labels. Example: ["5f3a1b2c4d5e6f7890123456"].
limitinteger- Number of results to return, 1 to 10000. Canny defaults to 10. Example: 25.
skipinteger- Entries to skip, up to 1,000. Canny defaults to 0. Example: 10.
sortstring- Sort order: created, lastSaved, publishedAt or nonPublishedFirst. Example: publishedAt.one of
createdlastSavedpublishedAtnonPublishedFirst statusstring- Comma-separated statuses: draft, scheduled, published. All if omitted. Example: published.
typestring- Entry type: new, improved or fixed. Example: new.one of
newimprovedfixed
canny_comment_getGet one Canny comment by ID.Read-onlyGet Comment
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.
Inputs
comment_idstringrequired- Canny ID of the comment. Get it from List Comments. Example: 5f3a1b2c4d5e6f7890123456.
canny_comments_listList comments in Canny, filtered by post, board, author or company, with cursor paging.Read-onlyList Comments
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.
Inputs
author_idstring- Canny ID of the comment author. Get it from List Users. Example: 5f3a1b2c4d5e6f7890123456.
board_idstring- Only return results from this board. Get board IDs from List Boards. Example: 5f3a1b2c4d5e6f7890123456.
company_idstring- Only return results from users linked to the company with this custom identifier (the ID from your own system). Example: acme-inc.
cursorstring- Pagination cursor from the previous response, to fetch the next page. Example: 6a2889c586d7b8843bf4cf10.
limitinteger- Number of results to return, 1 to 100. Canny defaults to 10. Example: 25.
post_idstring- Canny ID of the post. Get it from List Posts. Example: 5f3a1b2c4d5e6f7890123456.
canny_companies_listList companies in Canny, optionally searched by name or filtered by segment, with cursor paging.Read-onlyList Companies
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.
Inputs
cursorstring- Pagination cursor from the previous response, to fetch the next page. Example: 6a2889c586d7b8843bf4cf10.
limitinteger- Number of results to return, 1 to 100. Canny defaults to 10. Example: 25.
searchstring- Search by company name. Example: Acme.
segmentstring- URL name of a segment to filter by. Example: enterprise.
canny_post_getGet one Canny post by its ID, or by its urlName and board.Read-onlyGet Post
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.
Inputs
board_idstring- Board of the post. Only needed with url_name. Example: 5f3a1b2c4d5e6f7890123456.
post_idstring- Canny ID of the post. Get it from List Posts. Example: 5f3a1b2c4d5e6f7890123456.
url_namestring- The post's urlName (the slug in its URL). Requires board_id. Example: dark-mode.
canny_posts_listList feedback posts in Canny, filtered by board, author, company, tags, status or a search query.Read-onlyList Posts
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.
Inputs
author_idstring- Canny ID of the author (a Canny user). Get it from List Users or Get User. Example: 5f3a1b2c4d5e6f7890123456.
board_idstring- Only return results from this board. Get board IDs from List Boards. Example: 5f3a1b2c4d5e6f7890123456.
company_idstring- Only return results from users linked to the company with this custom identifier (the ID from your own system). Example: acme-inc.
limitinteger- Number of results to return. Canny defaults to 10. Example: 25.
searchstring- Only return posts matching this search query. Example: dark mode.
skipinteger- Number of results to skip before returning, for paging. Canny defaults to 0. Example: 25.
sortstring- Sort order: newest, oldest, relevance (only with search), score, statusChanged or trending. Canny defaults to newest. Example: score.one of
newestoldestrelevancescorestatusChangedtrending statusstring- Comma-separated statuses to include, such as open, under review, planned, in progress, complete, closed or a custom status. Example: planned,in progress.
tag_idsarray- Only return posts with at least one of these tags. Get IDs from List Tags. Example: ["5f3a1b2c4d5e6f7890123456"].
canny_status_changes_listList post status changes in Canny, newest first, optionally for one board, with cursor paging.Read-onlyList Status Changes
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.
Inputs
board_idstring- Only return results from this board. Get board IDs from List Boards. Example: 5f3a1b2c4d5e6f7890123456.
cursorstring- Pagination cursor from the previous response, to fetch the next page. Example: 6a2889c586d7b8843bf4cf10.
limitinteger- Number of results to return, 1 to 100. Canny defaults to 10. Example: 25.
canny_user_getGet one Canny user by Canny ID, by your app's user ID, or by email.Read-onlyGet User
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.
Inputs
app_user_idstring- The user's ID in your own application (Canny's userID). Example: user-123.
emailstring- The user's email address. Example: jane@acme.com.
user_idstring- Canny ID of the user. Get it from List Users. Example: 5f3a1b2c4d5e6f7890123456.
canny_users_listList end users and admins in the Canny workspace, with cursor paging.Read-onlyList Users
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.
Inputs
cursorstring- Pagination cursor from the previous response, to fetch the next page. Example: 6a2889c586d7b8843bf4cf10.
limitinteger- Number of results to return, 1 to 100. Canny defaults to 10. Example: 25.
canny_votes_listList votes in Canny, filtered by post, board, user or company, with cursor paging.Read-onlyList Votes
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.
Inputs
board_idstring- Only return results from this board. Get board IDs from List Boards. Example: 5f3a1b2c4d5e6f7890123456.
company_idstring- Only return results from users linked to the company with this custom identifier (the ID from your own system). Example: acme-inc.
cursorstring- Pagination cursor from the previous response, to fetch the next page. Example: 6a2889c586d7b8843bf4cf10.
limitinteger- Number of results to return, 1 to 100. Canny defaults to 10. Example: 25.
post_idstring- Canny ID of the post. Get it from List Posts. Example: 5f3a1b2c4d5e6f7890123456.
user_idstring- Canny ID of the voter (a Canny user). Get it from List Users. Example: 5f3a1b2c4d5e6f7890123456.
canny_category_createCreate a post category (or subcategory) on a Canny board.WriteCreate Category
Create a post category (or subcategory) on a Canny board. Returns the new category's id. Use List Boards to get the board ID.
Inputs
board_idstringrequired- Canny ID of the board. Get it from List Boards. Example: 5f3a1b2c4d5e6f7890123456.
namestringrequired- Category name, 1 to 30 characters. Example: Integrations.
subscribe_adminsbooleanrequired- Whether the board's admins are subscribed to the new category. Example: false.
parent_idstring- Canny ID of the parent category, to create a subcategory. Get it from List Categories. Example: 5f3a1b2c4d5e6f7890123456.
canny_changelog_entry_createCreate a changelog entry in Canny as a draft, scheduled or published, optionally linked to posts.WriteCreate Changelog Entry
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.
Inputs
detailsstringrequired- Entry details (Markdown). Example: You can now switch to a dark theme in Settings.
titlestringrequired- Entry title. Example: Dark mode is here.
label_idsarray- Label IDs to assign. Example: ["5f3a1b2c4d5e6f7890123456"].
notifyboolean- Whether to email users after publishing. Canny defaults to false. Example: false.
post_idsarray- Post IDs to link; a post already linked to another entry cannot be added. Example: ["5f3a1b2c4d5e6f7890123456"].
publishedboolean- Whether to publish now. Canny defaults to false (draft). Example: true.
published_onstring- Past publish date when published is true, ISO 8601. Example: 2026-01-15T00:00:00Z.
scheduled_forstring- Future publish date when published is false, ISO 8601. Example: 2026-12-01T09:00:00Z.
typestring- Entry type: new, improved or fixed. Example: new.one of
newimprovedfixed
canny_comment_createPost a comment or reply on a Canny post on behalf of a user, optionally internal-only.WriteCreate Comment
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.
Inputs
author_idstringrequired- Canny ID of the comment author (a Canny user). Get it from Create or Update User or Get User. Example: 5f3a1b2c4d5e6f7890123456.
post_idstringrequired- Canny ID of the post. Get it from List Posts. Example: 5f3a1b2c4d5e6f7890123456.
valuestringrequired- Comment text, under 2,500 characters. Optional when image_urls are given. Example: Thanks, we're looking into this.
created_atstring- Original creation time when importing, ISO 8601. Example: 2025-06-01T12:00:00Z.
image_urlsarray- Image URLs to attach. Example: ["https://example.com/screenshot.png"].
internalboolean- 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_idstring- Canny ID of the comment to reply to. Get it from List Comments. Example: 5f3a1b2c4d5e6f7890123456.
should_notify_votersboolean- Whether the comment may trigger email notifications. Canny defaults to false. Example: false.
canny_post_board_changeMove a Canny post to another board.WriteChange Post Board
Move a Canny post to another board. Returns the updated post. Use List Boards to find the destination board ID.
- Idempotent
Inputs
board_idstringrequired- Canny ID of the destination board. Get it from List Boards. Example: 5f3a1b2c4d5e6f7890123456.
post_idstringrequired- Canny ID of the post. Get it from List Posts. Example: 5f3a1b2c4d5e6f7890123456.
canny_post_category_changeMove a Canny post into a category, or remove its category.WriteChange Post Category
Move a Canny post into a category, or remove its category. Returns the updated post. Leave category_id empty to remove the category.
- Idempotent
Inputs
post_idstringrequired- Canny ID of the post. Get it from List Posts. Example: 5f3a1b2c4d5e6f7890123456.
category_idstring- Canny ID of the category. Get it from List Categories. Example: 5f3a1b2c4d5e6f7890123456.
canny_post_createCreate a feedback post on a Canny board on behalf of a user.WriteCreate Post
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.
Inputs
author_idstringrequired- Canny ID of the post author (a Canny user). Get it from Create or Update User or Get User. Example: 5f3a1b2c4d5e6f7890123456.
board_idstringrequired- Canny ID of the board. Get it from List Boards. Example: 5f3a1b2c4d5e6f7890123456.
detailsstringrequired- Post details, up to 10,000 characters. Example: Please add a dark theme for night use.
titlestringrequired- Post title, up to 400 characters. Example: Add dark mode.
by_idstring- Canny ID of the admin creating the post for the author; shown on the post. Get it from List Users. Example: 5f3a1b2c4d5e6f7890123456.
category_idstring- Canny ID of the category or subcategory. Get it from List Categories. Example: 5f3a1b2c4d5e6f7890123456.
created_atstring- Original creation time when importing from another tool, ISO 8601. Example: 2025-06-01T12:00:00Z.
custom_fieldsobject- Custom field values keyed by field name. Include every field the board requires. Example: {"Plan": "Pro"}.
etastring- Estimated completion month, as MM/YYYY. Example: 06/2026.
eta_publicboolean- Whether the ETA is visible to all users. Example: true.
image_urlsarray- URLs of images to attach. Example: ["https://example.com/mockup.png"].
owner_idstring- Canny ID of the admin responsible for the work. Get it from List Users. Example: 5f3a1b2c4d5e6f7890123456.
canny_post_status_changeChange a Canny post's status (open, under review, planned, in progress, complete, closed or a custom status), optionally with a comment and voter notification.WriteChange Post Status
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.
- Idempotent
Inputs
changer_idstringrequired- Canny ID of the admin recorded as making the change. Get it from List Users. Example: 5f3a1b2c4d5e6f7890123456.
post_idstringrequired- Canny ID of the post. Get it from List Posts. Example: 5f3a1b2c4d5e6f7890123456.
should_notify_votersbooleanrequired- Whether to notify non-admin voters of the change. Example: false.
statusstringrequired- New status: open, under review, planned, in progress, complete, closed or a custom status of your workspace. Example: planned.
comment_image_urlsarray- Image URLs for the status-change comment. Example: ["https://example.com/plan.png"].
comment_valuestring- Comment to attach to the status change. Example: Scheduled for Q3.
canny_post_tag_addAdd a tag to a Canny post.WriteAdd Post Tag
Add a tag to a Canny post. Returns the updated post. Use List Tags or Create Tag to get the tag ID.
- Idempotent
Inputs
post_idstringrequired- Canny ID of the post. Get it from List Posts. Example: 5f3a1b2c4d5e6f7890123456.
tag_idstringrequired- Canny ID of the tag. Get it from List Tags. Example: 5f3a1b2c4d5e6f7890123456.
canny_post_tag_removeRemove a tag from a Canny post.WriteRemove Post Tag
Remove a tag from a Canny post. Returns the updated post. The tag itself is kept.
- Idempotent
Inputs
post_idstringrequired- Canny ID of the post. Get it from List Posts. Example: 5f3a1b2c4d5e6f7890123456.
tag_idstringrequired- Canny ID of the tag. Get it from List Tags. Example: 5f3a1b2c4d5e6f7890123456.
canny_post_updateUpdate a Canny post's title, details, ETA, images, owner or custom fields.WriteUpdate Post
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.
- Idempotent
Inputs
post_idstringrequired- Canny ID of the post. Get it from List Posts. Example: 5f3a1b2c4d5e6f7890123456.
changer_idstring- Canny ID of the admin making the change; required with owner_id. Get it from List Users. Example: 5f3a1b2c4d5e6f7890123456.
custom_fieldsobject- Custom field values keyed by field name. Example: {"Plan": "Enterprise"}.
detailsstring- New details, up to 10,000 characters. Example: Dark theme for the dashboard and emails.
etastring- Estimated completion month, as MM/YYYY. Example: 09/2026.
eta_publicboolean- Whether the ETA is visible to all users. Example: true.
image_urlsarray- Image URLs that replace the post's images. Pass an empty list to remove all. Example: ["https://example.com/v2.png"].
owner_idstring- Canny ID of the admin to make the post's owner; requires changer_id. Get it from List Users. Example: 5f3a1b2c4d5e6f7890123456.
titlestring- New title, up to 400 characters. Example: Add dark mode to the dashboard.
canny_tag_createCreate a post tag on a Canny board.WriteCreate Tag
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.
Inputs
board_idstringrequired- Canny ID of the board. Get it from List Boards. Example: 5f3a1b2c4d5e6f7890123456.
namestringrequired- Tag name. Example: iOS.
canny_user_create_or_updateCreate a Canny user, or update the one matching the given ID, app user ID or email, including company links and custom fields.WriteCreate or Update User
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.
- Idempotent
Inputs
namestringrequired- User's name, up to 50 characters, without : or /. Example: Jane Doe.
aliasstring- User's alias. Example: jdoe.
app_user_idstring- The user's ID in your own application (Canny's userID). Needed to link companies. Example: user-123.
avatar_urlstring- URL of the user's avatar image. Example: https://example.com/jane.png.
companiesarray- 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_fieldsobject- Custom fields; names under 30 characters, text values under 200. Example: {"plan": "Pro"}.
emailstring- User's email address, up to 200 characters. Example: jane@acme.com.
user_idstring- Canny ID of the existing user to update. Get it from List Users. Example: 5f3a1b2c4d5e6f7890123456.
canny_vote_createAdd a user's vote to a Canny post, or update its priority.WriteCreate Vote
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.
- Idempotent
Inputs
post_idstringrequired- Canny ID of the post. Get it from List Posts. Example: 5f3a1b2c4d5e6f7890123456.
voter_idstringrequired- Canny ID of the voter (a Canny user). Get it from Create or Update User or Get User. Example: 5f3a1b2c4d5e6f7890123456.
by_idstring- Canny ID of the admin casting the vote for the voter. Get it from List Users. Example: 5f3a1b2c4d5e6f7890123456.
created_atstring- Original vote time when importing, ISO 8601. Example: 2025-06-01T12:00:00Z.
vote_prioritystring- Vote priority: Nice to have, Important, Must have, or No priority to clear it. Example: Important.one of
Nice to haveImportantMust haveNo priority
canny_comment_deletePermanently delete a Canny comment.DestructiveDelete Comment
Permanently delete a Canny comment. Returns success. This cannot be undone.
- Idempotent
Inputs
comment_idstringrequired- Canny ID of the comment. Get it from List Comments. Example: 5f3a1b2c4d5e6f7890123456.
canny_post_deletePermanently delete a Canny post with its comments and votes.DestructiveDelete Post
Permanently delete a Canny post with its comments and votes. Returns success. This cannot be undone.
- Idempotent
Inputs
post_idstringrequired- Canny ID of the post. Get it from List Posts. Example: 5f3a1b2c4d5e6f7890123456.
canny_vote_deleteRemove a user's vote from a Canny post.DestructiveDelete Vote
Remove a user's vote from a Canny post. Returns success. Use List Votes to find the voter.
- Idempotent
Inputs
post_idstringrequired- Canny ID of the post. Get it from List Posts. Example: 5f3a1b2c4d5e6f7890123456.
voter_idstringrequired- Canny ID of the voter (a Canny user). Get it from List Votes. Example: 5f3a1b2c4d5e6f7890123456.
No tools match.