Canny

Learn how to use Canny with Composio

Overview

SLUG

CANNY

Description

Canny is a customer feedback management platform that helps teams collect, analyze, and prioritize user feedback to build better products.

Authentication Details

generic_api_key
stringRequired

Tools

SLUG: CANNY_ADD_POST_TAG

Tool to add a tag to a specific post. use when you need to categorize or group content by applying an existing tag.

Action Parameters

postID
stringRequired
tagID
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CANNY_CHANGE_POST_STATUS

Tool to change a post's status. use when you need to update a post's workflow stage and optionally notify voters.

Action Parameters

changerID
stringRequired
commentImageURLs
array
commentValue
string
postID
stringRequired
shouldNotifyVoters
boolean
status
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CANNY_CREATE_CHANGELOG_ENTRY

Tool to create and optionally publish a new changelog entry. use when you need to add a product update record, control publish timing, and notify users. example: "create changelog entry titled 'version 1.2' with details '...' and publish immediately.".

Action Parameters

details
stringRequired
labelIDs
array
notify
boolean
postIDs
array
published
boolean
publishedOn
string
scheduledFor
string
title
stringRequired
type
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CANNY_CREATE_COMMENT

Tool to create a new comment on a post. use when you have the authorid and postid and want to submit feedback or replies.

Action Parameters

authorID
stringRequired
createdAt
string
imageURLs
array
internal
boolean
parentID
string
postID
stringRequired
shouldNotifyVoters
boolean
value
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CANNY_CREATE_OR_UPDATE_USER

Tool to create or update a user in canny. use when you need to provision a new user or synchronize updates to an existing user profile. example: "create or update user with email user@example.com"

Action Parameters

alias
string
avatarURL
string
companies
array
created
string
customFields
object
email
string
id
string
name
stringRequired
userID
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CANNY_CREATE_POST

Tool to create a new post on a board. use when you have the boardid and userid and need to submit new feedback.

Action Parameters

assigneeID
string
boardID
stringRequired
created
integer
details
string
isPrivate
boolean
tags
array
title
stringRequired
userID
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CANNY_CREATE_TAG

Tool to create a new tag. use when you have the boardid and tag name and need to categorize posts.

Action Parameters

boardID
stringRequired
name
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CANNY_CREATE_VOTE

Tool to create a vote for a post. use when you need to record or migrate a user's vote on a post, optionally setting priority or original creation time. example: create a vote for postid abc123 with voterid user 456.

Action Parameters

byID
string
createdAt
string
postID
stringRequired
votePriority
integer
voterID
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CANNY_DELETE_COMMENT

Tool to delete a comment. use when moderation is required to remove a specific comment by its id. example: "delete the comment with id 553c3ef8b8cdcd1501ba1238."

Action Parameters

commentID
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CANNY_DELETE_POST

Tool to delete a post. use when you need to permanently remove a post by its id. example: "delete the post with id 553c3ef8b8cdcd1501ba1238."

Action Parameters

postID
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CANNY_DELETE_USER

Tool to delete a user and their comments and votes. use when you need to fully remove a user's account and all associated data (e.g., gdpr compliance).

Action Parameters

id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CANNY_DELETE_VOTE

Tool to delete a vote. use when you need to remove a user's vote from a specific post by its id. example: "delete the vote from postid abc123 for voterid user 456."

Action Parameters

postID
stringRequired
voterID
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CANNY_LIST_BOARDS

Tool to list all boards. use when you need to retrieve every board for your company after authentication.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CANNY_LIST_CATEGORIES

Tool to list categories. use when fetching categories for a specific board by its id.

Action Parameters

boardID
string
limit
integer
skip
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CANNY_LIST_COMMENTS

Tool to list comments for posts, boards, or authors. use after authentication to fetch comments with optional filters.

Action Parameters

authorID
string
boardID
string
companyID
string
limit
integerDefaults to 10
postID
string
skip
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CANNY_LIST_COMPANIES

Tool to list companies associated with your canny account. use after authentication to retrieve companies with pagination support.

Action Parameters

cursor
string
limit
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CANNY_LIST_OPPORTUNITIES

Tool to list opportunities linked to posts. use when you need to fetch customer opportunities synced from crm.

Action Parameters

limit
integer
skip
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CANNY_LIST_POSTS

Tool to list posts with various filters. use after selecting a board or to search/filter posts.

Action Parameters

authorID
string
boardID
string
companyID
string
limit
integer
search
string
skip
integer
sort
string
status
string
tagIDs
array

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CANNY_LIST_TAGS

Tool to list tags. use when fetching tags optionally filtered by board id and handling pagination.

Action Parameters

boardID
string
limit
integer
skip
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CANNY_LIST_USERS

Tool to list end-users in your workspace. use when you need to fetch and paginate through your workspace's users.

Action Parameters

cursor
string
limit
integerDefaults to 10

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CANNY_LIST_VOTES

Tool to list votes for a post. use after retrieving post details to view voters.

Action Parameters

boardID
string
limit
integerDefaults to 10
postID
string
skip
integer
voterID
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CANNY_RETRIEVE_BOARD

Tool to retrieve details of a board by its id. use when you need metadata for a specific board.

Action Parameters

id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CANNY_RETRIEVE_TAG

Tool to retrieve details of a tag by its id. use after obtaining a valid tag id.

Action Parameters

id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CANNY_RETRIEVE_USER

Tool to retrieve user details by canny user id, app user id, or email. use when you have exactly one identifier and need full user information. example: "retrieve user with email user@example.com"

Action Parameters

email
string
id
string
userID
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CANNY_UPDATE_POST

Tool to update post details. use when you need to change a post's title, details, eta, images, or custom fields.

Action Parameters

customFields
object
details
string
eta
string
etaPublic
boolean
imageURLs
array
postID
stringRequired
title
string

Action Response

data
objectRequired
error
string
successful
booleanRequired