We aim to provide accurate and helpful details about third‑party tools, but we can’t guarantee that this information is always complete or up to date. If you notice any discrepancies, feel free to share them in the feedback section below. For the most reliable information, please always refer to the third‑party tool’s official documentation.
Canny is a customer feedback management platform that helps teams collect, organize, and prioritize product feedback.
This component allows you to manage feedback boards, posts, votes, comments, categories, tags, users, and companies.
API Documentation
This component was built using the Canny API Reference.
Connections
API Key
Authenticate using a Canny API key.
To authenticate with Canny, an API key is required.
Prerequisites
- A Canny account with admin access
Setup Steps
- Log in to the Canny admin panel
- Navigate to Settings > API
- Copy the API Key displayed on the page
Configure the Connection
- Enter the API Key into the connection configuration
| Input | Comments | Default |
|---|---|---|
| API Key | The Canny API key. Generate one at Settings > API in the Canny admin panel. |
Triggers
New and Updated Posts
Retrieves existing and ongoing posts from Canny. Load history once, check for changes on a schedule, or both.
| Input | Comments | Default |
|---|---|---|
| Connection | The Canny connection to use. | |
| Show New Records | When true, posts created since the last poll are included in the trigger output. | true |
| Show Updated Records | When true, posts whose status changed since the last poll are included in the trigger output. | true |
| Look-back Date | The date the initial sync starts from, in YYYY-MM-DD format. Cannot be a future date. Leave empty to start from the first recurrence with no backfill. When set, the initial sync seeds each post created or status-changed on or after this date once, ignoring the field and visibility filters. |
Webhook
Receives webhook events from Canny when configured events occur.
| Input | Comments | Default |
|---|---|---|
| Connection | The Canny connection to use. |
Actions
Change Post Status
Changes the status of a post.
| Input | Comments | Default |
|---|---|---|
| Connection | The Canny connection to use. | |
| Post ID | The unique identifier of the post. | |
| Status | The new status value (e.g., open, under review, planned, in progress, complete, closed). | |
| Changer ID | The admin performing the status change. | |
| Notify Voters | When true, notifies voters of the status change. | false |
| Comment | Optional comment to attach to the status change. | |
| Additional Fields | Additional fields that might not be covered by the standard inputs. |
Create Category
Creates a new category in a board.
| Input | Comments | Default |
|---|---|---|
| Connection | The Canny connection to use. | |
| Board ID | The unique identifier of the board. | |
| Name | The display name shown when grouping posts on the board. | |
| Subscribe Admins | When true, subscribes admins to the category. | false |
| Parent Category ID | Parent category ID for subcategories. |
Create Changelog Entry
Creates a new changelog entry.
| Input | Comments | Default |
|---|---|---|
| Connection | The Canny connection to use. | |
| Title | The headline shown at the top of the changelog entry. | |
| Details | The entry content (markdown supported). | |
| Type | Entry type: new, improved, or fixed. | |
| Additional Fields | Additional optional fields: includes Notify, Published, and Additional Fields. | |
| Notify | When true, sends an email notification for the changelog entry. | false |
| Published | When true, publishes the changelog entry immediately. | false |
| Additional Fields | Additional fields that might not be covered by the standard inputs. |
Create Comment
Creates a new comment on a post.
| Input | Comments | Default |
|---|---|---|
| Connection | The Canny connection to use. | |
| Post ID | The unique identifier of the post. | |
| Author ID | The unique identifier of the comment author. | |
| Comment Text | The body of the comment as it appears on the post. Plain text. | |
| Parent Comment ID | Parent comment ID for threaded replies. | |
| Additional Fields | Additional optional fields: includes Internal, Image URLs, and Additional Fields. | |
| Internal | When true, the comment is internal-only and not visible to end users. | false |
| Image URLs | JSON array of image URLs to attach. | |
| Additional Fields | Additional fields that might not be covered by the standard inputs. |
Create or Update User
Creates a new user or updates an existing one by email.
| Input | Comments | Default |
|---|---|---|
| Connection | The Canny connection to use. | |
| The user's email address. | ||
| Name | The user's display name. | |
| User ID | The unique identifier of the user. | |
| Additional Fields | Additional optional fields: includes Companies, Custom Fields, and Additional Fields. | |
| Companies | JSON array of company objects to associate with the user. | |
| Custom Fields | Custom field key-value pairs as JSON. | |
| Additional Fields | Additional fields that might not be covered by the standard inputs. |
Create Post
Creates a new feedback post.
| Input | Comments | Default |
|---|---|---|
| Connection | The Canny connection to use. | |
| Board ID | The unique identifier of the board. | |
| Author ID | The unique identifier of the post author. | |
| Title | The headline shown in the board list and used for search matching. | |
| Details | The content or description of the post. | |
| Category ID | Category to assign to the post. | |
| Additional Fields | Additional optional fields: includes Custom Fields, ETA, ETA Public, Image URLs, and Additional Fields. | |
| Custom Fields | Custom field key-value pairs as JSON. | |
| ETA | Estimated delivery date in MM/YYYY format. | |
| ETA Public | When true, the ETA is visible to all users. | false |
| Image URLs | JSON array of image URLs to attach. | |
| Additional Fields | Additional fields that might not be covered by the standard inputs. |
Create Tag
Creates a new tag in a board.
| Input | Comments | Default |
|---|---|---|
| Connection | The Canny connection to use. | |
| Board ID | The unique identifier of the board. | |
| Name | The label applied to posts for filtering, such as bug or feature-request. |
Create Vote
Creates a vote on a post.
| Input | Comments | Default |
|---|---|---|
| Connection | The Canny connection to use. | |
| Post ID | The unique identifier of the post. | |
| Voter ID | The unique identifier of the user casting the vote. | |
| Additional Fields | Additional fields that might not be covered by the standard inputs. |
Delete Category
Deletes a category.
| Input | Comments | Default |
|---|---|---|
| Connection | The Canny connection to use. | |
| Category ID | The unique identifier of the category. |
Delete Comment
Deletes a comment.
| Input | Comments | Default |
|---|---|---|
| Connection | The Canny connection to use. | |
| Comment ID | The unique identifier of the comment. |
Delete Company
Deletes a company.
| Input | Comments | Default |
|---|---|---|
| Connection | The Canny connection to use. | |
| Company ID | The unique identifier of the company. |
Delete Post
Deletes a post.
| Input | Comments | Default |
|---|---|---|
| Connection | The Canny connection to use. | |
| Post ID | The unique identifier of the post. |
Delete User
Deletes a user.
| Input | Comments | Default |
|---|---|---|
| Connection | The Canny connection to use. | |
| User ID | The unique identifier of the user. |
Delete Vote
Deletes a vote.
| Input | Comments | Default |
|---|---|---|
| Connection | The Canny connection to use. | |
| Vote ID | The unique identifier of the vote. |
List Boards
Lists all boards.
| Input | Comments | Default |
|---|---|---|
| Connection | The Canny connection to use. |
List Categories
Lists categories with optional board filter and pagination.
| Input | Comments | Default |
|---|---|---|
| Connection | The Canny connection to use. | |
| Board ID | Filter results by board. | |
| Fetch All | When true, automatically fetches all pages of results using pagination. | false |
| Pagination | Page and page-size controls. | |
| Limit | Number of results to return per page. | |
| Skip | The number of results to skip before returning data (0-based). |
List Changelog Entries
Lists changelog entries with optional filtering.
| Input | Comments | Default |
|---|---|---|
| Connection | The Canny connection to use. | |
| Type | Entry type: new, improved, or fixed. | |
| Sort | Sort order for changelog entries. | |
| Fetch All | When true, automatically fetches all pages of results using pagination. | false |
| Pagination | Page and page-size controls. | |
| Limit | Number of results to return per page. | |
| Skip | The number of results to skip before returning data (0-based). |
List Comments
Lists comments with optional filtering and cursor-based pagination.
| Input | Comments | Default |
|---|---|---|
| Connection | The Canny connection to use. | |
| Board ID | Filter results by board. | |
| Post ID | Filter results by post. | |
| Author ID | Filter by or specify the post author. | |
| Company ID | Filter results by company. | |
| Fetch All | When true, automatically fetches all pages of results using pagination. | false |
| Pagination | Cursor and page-size controls for paging through results. | |
| Cursor | Pagination cursor from a previous response. | |
| Limit | Number of results to return per page. |
List Companies
Lists companies with cursor-based pagination.
| Input | Comments | Default |
|---|---|---|
| Connection | The Canny connection to use. | |
| Search | Search term to filter companies. | |
| Segment | Restricts results to companies in a single segment, matched exactly against the segment name. | |
| Fetch All | When true, automatically fetches all pages of results using pagination. | false |
| Pagination | Cursor and page-size controls for paging through results. | |
| Cursor | Pagination cursor from a previous response. | |
| Limit | Number of results to return per page. |
List Posts
Lists posts with optional filtering and pagination.
| Input | Comments | Default |
|---|---|---|
| Connection | The Canny connection to use. | |
| Board ID | Filter results by board. | |
| Author ID | Filter by or specify the post author. | |
| Company ID | Filter results by company. | |
| Tag IDs | JSON array of tag IDs to filter by. | |
| Fetch All | When true, automatically fetches all pages of results using pagination. | false |
| Pagination | Page and page-size controls. | |
| Limit | Number of results to return per page. | |
| Skip | The number of results to skip before returning data (0-based). | |
| List Controls | Search, sort, and status filter controls. | |
| Search | Search term to filter posts. | |
| Sort | Sort order for post results. | |
| Status | Comma-separated list of statuses to filter by. |
List Status Changes
Lists post status changes with optional filtering and cursor-based pagination.
| Input | Comments | Default |
|---|---|---|
| Connection | The Canny connection to use. | |
| Board ID | Filter results by board. | |
| Fetch All | When true, automatically fetches all pages of results using pagination. | false |
| Pagination | Cursor and page-size controls for paging through results. | |
| Cursor | Pagination cursor from a previous response. | |
| Limit | Number of results to return per page. |
List Tags
Lists tags with optional board filter and pagination.
| Input | Comments | Default |
|---|---|---|
| Connection | The Canny connection to use. | |
| Board ID | Filter results by board. | |
| Fetch All | When true, automatically fetches all pages of results using pagination. | false |
| Pagination | Page and page-size controls. | |
| Limit | Number of results to return per page. | |
| Skip | The number of results to skip before returning data (0-based). |
List Users
Lists users with cursor-based pagination.
| Input | Comments | Default |
|---|---|---|
| Connection | The Canny connection to use. | |
| Fetch All | When true, automatically fetches all pages of results using pagination. | false |
| Pagination | Cursor and page-size controls for paging through results. | |
| Cursor | Pagination cursor from a previous response. | |
| Limit | Number of results to return per page. |
List Votes
Lists votes with optional filtering and cursor-based pagination (v2).
| Input | Comments | Default |
|---|---|---|
| Connection | The Canny connection to use. | |
| Board ID | Filter results by board. | |
| Post ID | Filter results by post. | |
| Company ID | Filter results by company. | |
| User ID | Filter results by user. | |
| Fetch All | When true, automatically fetches all pages of results using pagination. | false |
| Pagination | Cursor and page-size controls for paging through results. | |
| Cursor | Pagination cursor from a previous response. | |
| Limit | Number of results to return per page. |
Raw Request
Sends a raw HTTP request to the Canny API. The API key is injected automatically into the request body.
| Input | Comments | Default |
|---|---|---|
| Connection | The Canny connection to use. | |
| URL | Input the path only (e.g., /v1/posts/list). The base URL is already included (https://canny.io/api). For example, to connect to https://canny.io/api/v1/posts/list, only /v1/posts/list is entered in this field. | |
| Method | The HTTP method to use. | |
| Data | The HTTP body payload to send to the URL. | |
| Form Data | The Form Data to be sent as a multipart form upload. | |
| File Data | File Data to be sent as a multipart form upload. | |
| File Data File Names | File names to apply to the file data inputs. Keys must match the file data keys above. | |
| Query Parameter | A list of query parameters to send with the request. This is the portion at the end of the URL similar to ?key1=value1&key2=value2. | |
| Header | A list of headers to send with the request. | |
| Response Type | The type of data you expect in the response. You can request json, text, or binary data. | json |
| Timeout | The maximum time that a client will await a response to its request | |
| Retry Delay (ms) | The delay in milliseconds between retries. This is used when 'Use Exponential Backoff' is disabled. | 0 |
| Retry On All Errors | If true, retries on all erroneous responses regardless of type. This is helpful when retrying after HTTP 429 or other 3xx or 4xx errors. Otherwise, only retries on HTTP 5xx and network errors. | false |
| Max Retry Count | The maximum number of retries to attempt. Specify 0 for no retries. | 0 |
| Use Exponential Backoff | Specifies whether to use a pre-defined exponential backoff strategy for retries. When enabled, 'Retry Delay (ms)' is ignored. | false |
Retrieve Board
Retrieves a single board by ID.
| Input | Comments | Default |
|---|---|---|
| Connection | The Canny connection to use. | |
| Board ID | The unique identifier of the board. |
Retrieve Category
Retrieves a single category by ID.
| Input | Comments | Default |
|---|---|---|
| Connection | The Canny connection to use. | |
| Category ID | The unique identifier of the category. |
Retrieve Comment
Retrieves a single comment by ID.
| Input | Comments | Default |
|---|---|---|
| Connection | The Canny connection to use. | |
| Comment ID | The unique identifier of the comment. |
Retrieve Post
Retrieves a single post by ID.
| Input | Comments | Default |
|---|---|---|
| Connection | The Canny connection to use. | |
| Post ID | The unique identifier of the post. |
Retrieve Tag
Retrieves a single tag by ID.
| Input | Comments | Default |
|---|---|---|
| Connection | The Canny connection to use. | |
| Tag ID | The unique identifier of the tag. |
Retrieve User
Retrieves a single user by ID.
| Input | Comments | Default |
|---|---|---|
| Connection | The Canny connection to use. | |
| User ID | The unique identifier of the user. |
Retrieve Vote
Retrieves a single vote by ID.
| Input | Comments | Default |
|---|---|---|
| Connection | The Canny connection to use. | |
| Vote ID | The unique identifier of the vote. |
Update Company
Updates an existing company.
| Input | Comments | Default |
|---|---|---|
| Connection | The Canny connection to use. | |
| Company ID | The unique identifier of the company. | |
| Name | The company name (0-100 characters). | |
| Additional Fields | Additional optional fields: includes Monthly Spend, Custom Fields, and Additional Fields. | |
| Monthly Spend | Monthly recurring revenue in dollars. | |
| Custom Fields | Custom field key-value pairs as JSON. | |
| Additional Fields | Additional fields that might not be covered by the standard inputs. |
Update Post
Updates an existing post.
| Input | Comments | Default |
|---|---|---|
| Connection | The Canny connection to use. | |
| Post ID | The unique identifier of the post. | |
| Title | Replaces the post headline. Leave blank to keep the current title. | |
| Details | Replaces the post body. Leave blank to keep the current details. | |
| Additional Fields | Additional optional fields: includes Custom Fields, ETA, Image URLs, and Additional Fields. | |
| Custom Fields | Custom field key-value pairs as JSON. | |
| ETA | Estimated delivery date in MM/YYYY format. | |
| Image URLs | JSON array of image URLs to attach. | |
| Additional Fields | Additional fields that might not be covered by the standard inputs. |