Canny

App · 31 actions

Collect and manage customer feedback in Canny. Read boards, posts, comments, votes, users and tags, create and update posts, move them through statuses, comment and vote as your users, and write, publish or schedule changelog entries. Triggers start a workflow when a new post arrives or a post changes status.

Actions

ActionWhat it does
Add tag to postTag a post.
Add voteAdd a user's vote to a post.
Change post categoryPut a post in a category, or take it out of its category.
Change post statusMove a post to a new status, optionally telling the people who voted and leaving a comment.
Create categoryAdd a category to a board, optionally under another category.
Create changelog entryWrite a changelog entry.
Create commentComment on a post, written as one of the company's users.
Create or update userCreate a user, or update the one with the same email or id.
Create postCreate a post on a board, written as one of the company's users.
Create tagAdd a tag to a board.
Delete categoryDelete a category.
Delete changelog entryDelete a changelog entry.
Delete commentDelete a comment.
Delete postDelete a post for good, with its comments and votes.
Delete userDelete a user, with all their comments and votes.
Get boardGet one board with its name, privacy and number of posts.
Get postGet one post with its author, board, category, tags, status and vote count.
Get userFind one user by their Canny id, your own id for them, or their email.
List boardsList every board in the company, with its name, privacy and number of posts.
List categoriesList categories, of one board or of every board.
List changelog entriesList changelog entries, filtered by status, type or label.
List commentsList comments, of one post, board, author or company, or all of them.
List postsList posts, filtered by board, author, company, tags, status or a search.
List tagsList tags, of one board or of every board.
List usersList the company's users.
List votesList votes, of one post, board, voter or company, or all of them.
Publish or unpublish changelog entryPublish an entry, schedule it for later, or turn it back into a draft.
Remove tag from postTake a tag off a post.
Remove voteTake a user's vote off a post.
Update changelog entryChange an entry's title, text, type, labels or linked posts.
Update postChange a post's title, details, owner, ETA or custom fields.

Add tag to post

Tag a post. The tag must be one of its board's tags.

Inputs

Post IDpost_idtextRequired
The post's id, from 'List posts', 'Create post' or an earlier step.
Tagtag_idtextRequired
The tag. Pick one, or give its id from an earlier step.

Outputs

postobject
The updated post
Example output
{
  "post": {
    "author": {
      "alias": "jo",
      "avatarURL": "",
      "companies": [],
      "created": "2026-01-05T10:00:00.000Z",
      "customFields": {},
      "email": "jo@example.com",
      "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
      "isAdmin": false,
      "lastActivity": "2026-02-01T09:00:00.000Z",
      "name": "Jo Bloggs",
      "url": "https://acme.canny.io/admin/users/jo",
      "userID": "usr_123"
    },
    "board": {
      "created": "2026-01-01T10:00:00.000Z",
      "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
      "isPrivate": false,
      "name": "Feature Requests",
      "postCount": 12,
      "privateComments": false,
      "url": "https://acme.canny.io/feature-requests"
    },
    "by": null,
    "category": {
      "board": {
        "created": "2026-01-01T10:00:00.000Z",
        "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
        "isPrivate": false,
        "name": "Feature Requests",
        "postCount": 12,
        "privateComments": false,
        "url": "https://acme.canny.io/feature-requests"
      },
      "created": "2026-01-02T10:00:00.000Z",
      "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
      "name": "Integrations",
      "parentID": "",
      "postCount": 4,
      "url": "https://acme.canny.io/feature-requests?category=integrations"
    },
    "commentCount": 2,
    "created": "2026-01-10T10:00:00.000Z",
    "customFields": {},
    "details": "Please add a dark theme.",
    "eta": "03/2027",
    "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
    "imageURLs": [],
    "owner": null,
    "score": 14,
    "status": "planned",
    "statusChangedAt": "2026-02-01T10:00:00.000Z",
    "tags": [
      {
        "board": {
          "created": "2026-01-01T10:00:00.000Z",
          "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
          "isPrivate": false,
          "name": "Feature Requests",
          "postCount": 12,
          "privateComments": false,
          "url": "https://acme.canny.io/feature-requests"
        },
        "created": "2026-01-02T10:00:00.000Z",
        "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
        "name": "enterprise",
        "postCount": 3,
        "url": "https://acme.canny.io/feature-requests?tags=enterprise"
      }
    ],
    "title": "Dark mode",
    "url": "https://acme.canny.io/feature-requests/p/dark-mode"
  }
}

Add vote

Add a user's vote to a post.

Inputs

Post IDpost_idtextRequired
The post's id, from 'List posts', 'Create post' or an earlier step.
Votervoter_idtextRequired
Who is voting. The Canny id of a user, from 'Get user', 'List users' or 'Create or update user' (not your own user id).
Voted atcreated_atdate and time
Back-date the vote to this date and time.

Outputs

post_idtext
The post's id
votedtrue/false
True once Canny confirms it
voter_idtext
The voter's id
Example output
{
  "post_id": "5f8a1b2c3d4e5f6a7b8c9d0e",
  "voted": true,
  "voter_id": "5f8a1b2c3d4e5f6a7b8c9d0e"
}

Change post category

Put a post in a category, or take it out of its category.

Inputs

Post IDpost_idtextRequired
The post's id, from 'List posts', 'Create post' or an earlier step.
Categorycategory_idtext
The category. Pick one, or give its id from an earlier step.
Remove categoryremove_categorytrue/false
Take the post out of its category instead of choosing one.Default: false.

Outputs

postobject
The updated post
Example output
{
  "post": {
    "author": {
      "alias": "jo",
      "avatarURL": "",
      "companies": [],
      "created": "2026-01-05T10:00:00.000Z",
      "customFields": {},
      "email": "jo@example.com",
      "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
      "isAdmin": false,
      "lastActivity": "2026-02-01T09:00:00.000Z",
      "name": "Jo Bloggs",
      "url": "https://acme.canny.io/admin/users/jo",
      "userID": "usr_123"
    },
    "board": {
      "created": "2026-01-01T10:00:00.000Z",
      "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
      "isPrivate": false,
      "name": "Feature Requests",
      "postCount": 12,
      "privateComments": false,
      "url": "https://acme.canny.io/feature-requests"
    },
    "by": null,
    "category": {
      "board": {
        "created": "2026-01-01T10:00:00.000Z",
        "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
        "isPrivate": false,
        "name": "Feature Requests",
        "postCount": 12,
        "privateComments": false,
        "url": "https://acme.canny.io/feature-requests"
      },
      "created": "2026-01-02T10:00:00.000Z",
      "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
      "name": "Integrations",
      "parentID": "",
      "postCount": 4,
      "url": "https://acme.canny.io/feature-requests?category=integrations"
    },
    "commentCount": 2,
    "created": "2026-01-10T10:00:00.000Z",
    "customFields": {},
    "details": "Please add a dark theme.",
    "eta": "03/2027",
    "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
    "imageURLs": [],
    "owner": null,
    "score": 14,
    "status": "planned",
    "statusChangedAt": "2026-02-01T10:00:00.000Z",
    "tags": [
      {
        "board": {
          "created": "2026-01-01T10:00:00.000Z",
          "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
          "isPrivate": false,
          "name": "Feature Requests",
          "postCount": 12,
          "privateComments": false,
          "url": "https://acme.canny.io/feature-requests"
        },
        "created": "2026-01-02T10:00:00.000Z",
        "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
        "name": "enterprise",
        "postCount": 3,
        "url": "https://acme.canny.io/feature-requests?tags=enterprise"
      }
    ],
    "title": "Dark mode",
    "url": "https://acme.canny.io/feature-requests/p/dark-mode"
  }
}

Change post status

Move a post to a new status, optionally telling the people who voted and leaving a comment.

Inputs

Post IDpost_idtextRequired
The post's id, from 'List posts', 'Create post' or an earlier step.
Changed bychanger_idtextRequired
The admin changing it. The Canny id of a user, from 'Get user', 'List users' or 'Create or update user' (not your own user id).
StatusstatustextRequired
The post's new status.One of: open, under review, planned, in progress, complete, closed.
Tell votersshould_notify_voterstrue/false
Email the people who voted that the status changed.Default: false.
Commentcommenttext
A comment to show with the change, up to 2,500 characters.

Outputs

postobject
The updated post
Example output
{
  "post": {
    "author": {
      "alias": "jo",
      "avatarURL": "",
      "companies": [],
      "created": "2026-01-05T10:00:00.000Z",
      "customFields": {},
      "email": "jo@example.com",
      "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
      "isAdmin": false,
      "lastActivity": "2026-02-01T09:00:00.000Z",
      "name": "Jo Bloggs",
      "url": "https://acme.canny.io/admin/users/jo",
      "userID": "usr_123"
    },
    "board": {
      "created": "2026-01-01T10:00:00.000Z",
      "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
      "isPrivate": false,
      "name": "Feature Requests",
      "postCount": 12,
      "privateComments": false,
      "url": "https://acme.canny.io/feature-requests"
    },
    "by": null,
    "category": {
      "board": {
        "created": "2026-01-01T10:00:00.000Z",
        "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
        "isPrivate": false,
        "name": "Feature Requests",
        "postCount": 12,
        "privateComments": false,
        "url": "https://acme.canny.io/feature-requests"
      },
      "created": "2026-01-02T10:00:00.000Z",
      "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
      "name": "Integrations",
      "parentID": "",
      "postCount": 4,
      "url": "https://acme.canny.io/feature-requests?category=integrations"
    },
    "commentCount": 2,
    "created": "2026-01-10T10:00:00.000Z",
    "customFields": {},
    "details": "Please add a dark theme.",
    "eta": "03/2027",
    "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
    "imageURLs": [],
    "owner": null,
    "score": 14,
    "status": "planned",
    "statusChangedAt": "2026-02-01T10:00:00.000Z",
    "tags": [
      {
        "board": {
          "created": "2026-01-01T10:00:00.000Z",
          "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
          "isPrivate": false,
          "name": "Feature Requests",
          "postCount": 12,
          "privateComments": false,
          "url": "https://acme.canny.io/feature-requests"
        },
        "created": "2026-01-02T10:00:00.000Z",
        "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
        "name": "enterprise",
        "postCount": 3,
        "url": "https://acme.canny.io/feature-requests?tags=enterprise"
      }
    ],
    "title": "Dark mode",
    "url": "https://acme.canny.io/feature-requests/p/dark-mode"
  }
}

Create category

Add a category to a board, optionally under another category.

Inputs

Boardboard_idtextRequired
The board. Pick one, or give its id from an earlier step.
NamenametextRequired
The category's name, 1 to 30 characters.
Parent categoryparent_idtext
The category. Pick one, or give its id from an earlier step.
Subscribe adminssubscribe_adminstrue/false
Subscribe the company's admins to new posts in it.Default: false.

Outputs

category_idtext
The new category's id
Example output
{
  "category_id": "5f8a1b2c3d4e5f6a7b8c9d0e"
}

Create changelog entry

Write a changelog entry. It is a draft unless you publish it now or schedule it.

Inputs

TitletitletextRequired
The entry's title, up to 400 characters.
DetailsdetailstextRequired
The entry's text, in Markdown.
Typetypetext
What kind of change it is.One of: new, improved, fixed.
Publish nowpublishedtrue/false
Publish the entry straight away.Default: false.
Published onpublished_ondate and time
A date and time in the past to show as the publish time.
Schedule forscheduled_fordate and time
A date and time in the future to publish the entry.
Email subscribersnotifytrue/false
Tell the entry's subscribers when it is published.Default: false.
Label IDslabel_idslist
The ids of the changelog labels, from an earlier entry's labels.
Linked post IDspost_idslist
The ids of posts this entry is about; their voters can be told when it is published.

Outputs

entry_idtext
The new entry's id
Example output
{
  "entry_id": "5f8a1b2c3d4e5f6a7b8c9d0e"
}

Create comment

Comment on a post, written as one of the company's users.

Inputs

Post IDpost_idtextRequired
The post's id, from 'List posts', 'Create post' or an earlier step.
Authorauthor_idtextRequired
Who is commenting. The Canny id of a user, from 'Get user', 'List users' or 'Create or update user' (not your own user id).
CommentvaluetextRequired
The comment's text, under 2,500 characters.
Internalinternaltrue/false
Show the comment to the company's team only.Default: false.
Reply toparent_idtext
The id of the comment this replies to.
Tell votersshould_notify_voterstrue/false
Email the people who voted on the post.Default: false.
Created atcreated_atdate and time
Back-date the comment to this date and time.

Outputs

comment_idtext
The new comment's id
Example output
{
  "comment_id": "5f8a1b2c3d4e5f6a7b8c9d0e"
}

Create or update user

Create a user, or update the one with the same email or id. Returns the user's Canny id, which posts, comments and votes need.

Inputs

NamenametextRequired
The user's name, up to 50 characters.
Emailemailtext
The user's email address. Give this, 'Your user ID' or 'Canny ID'.
Your user IDexternal_idtext
The id your own app uses for the user.
Canny IDcanny_idtext
The user's Canny id, to update them.
Avatar URLavatar_urltext
A link to the user's picture.
Aliasaliastext
A short name or handle.
Signed up atcreateddate and time
When the user signed up to your product.
Custom fieldscustom_fieldsobject
Extra facts about the user, as {"Plan": "Pro"}.

Outputs

idtext
The user's Canny id
Example output
{
  "id": "5f8a1b2c3d4e5f6a7b8c9d0e"
}

Create post

Create a post on a board, written as one of the company's users.

Inputs

Boardboard_idtextRequired
The board. Pick one, or give its id from an earlier step.
Authorauthor_idtextRequired
Who is posting. The Canny id of a user, from 'Get user', 'List users' or 'Create or update user' (not your own user id).
TitletitletextRequired
The post's title, up to 400 characters.
DetailsdetailstextRequired
The post's text, up to 10,000 characters.
Categorycategory_idtext
The category. Pick one, or give its id from an earlier step.
Ownerowner_idtext
The admin responsible for it. The Canny id of a user, from 'Get user', 'List users' or 'Create or update user' (not your own user id).
ETAetadate
When the work should be done. Canny keeps the month and year.
Show ETA to everyoneeta_publictrue/false
Make the ETA public.Default: false.
Custom fieldscustom_fieldsobject
Values for the company's custom post fields, as {"Field name": value}. Values must suit each field's type.
Created atcreated_atdate and time
Back-date the post to this date and time.

Outputs

post_idtext
The new post's id
Example output
{
  "post_id": "5f8a1b2c3d4e5f6a7b8c9d0e"
}

Create tag

Add a tag to a board. If it already has a tag of that name, that tag is returned.

Inputs

Boardboard_idtextRequired
The board. Pick one, or give its id from an earlier step.
NamenametextRequired
The tag's name, 1 to 30 characters.

Outputs

tagobject
The tag
Example output
{
  "tag": {
    "board": {
      "created": "2026-01-01T10:00:00.000Z",
      "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
      "isPrivate": false,
      "name": "Feature Requests",
      "postCount": 12,
      "privateComments": false,
      "url": "https://acme.canny.io/feature-requests"
    },
    "created": "2026-01-02T10:00:00.000Z",
    "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
    "name": "enterprise",
    "postCount": 3,
    "url": "https://acme.canny.io/feature-requests?tags=enterprise"
  }
}

Delete category

Delete a category. It must have no subcategories; its posts stay, without a category.

Inputs

Categorycategory_idtext
The category. Pick one, or give its id from an earlier step.

Outputs

category_idtext
The deleted category's id
deletedtrue/false
True once Canny confirms it
Example output
{
  "category_id": "5f8a1b2c3d4e5f6a7b8c9d0e",
  "deleted": true
}

Delete changelog entry

Delete a changelog entry.

Inputs

Entry IDentry_idtextRequired
The changelog entry's id, from 'List changelog entries' or 'Create changelog entry'.

Outputs

deletedtrue/false
True once Canny confirms it
entry_idtext
The deleted entry's id
Example output
{
  "deleted": true,
  "entry_id": "5f8a1b2c3d4e5f6a7b8c9d0e"
}

Delete comment

Delete a comment.

Inputs

Comment IDcomment_idtextRequired
The comment's id, from 'List comments' or 'Create comment'.

Outputs

comment_idtext
The deleted comment's id
deletedtrue/false
True once Canny confirms it
Example output
{
  "comment_id": "5f8a1b2c3d4e5f6a7b8c9d0e",
  "deleted": true
}

Delete post

Delete a post for good, with its comments and votes.

Inputs

Post IDpost_idtextRequired
The post's id, from 'List posts', 'Create post' or an earlier step.

Outputs

deletedtrue/false
True once Canny confirms it
post_idtext
The deleted post's id
Example output
{
  "deleted": true,
  "post_id": "5f8a1b2c3d4e5f6a7b8c9d0e"
}

Delete user

Delete a user, with all their comments and votes.

Inputs

Canny IDcanny_idtextRequired
The user's Canny id, from 'Get user' or 'Create or update user'.

Outputs

deletedtrue/false
True once Canny confirms it
idtext
The deleted user's id
Example output
{
  "deleted": true,
  "id": "5f8a1b2c3d4e5f6a7b8c9d0e"
}

Get board

Get one board with its name, privacy and number of posts.

Inputs

Boardboard_idtextRequired
The board. Pick one, or give its id from an earlier step.

Outputs

boardobject
The board
Example output
{
  "board": {
    "created": "2026-01-01T10:00:00.000Z",
    "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
    "isPrivate": false,
    "name": "Feature Requests",
    "postCount": 12,
    "privateComments": false,
    "url": "https://acme.canny.io/feature-requests"
  }
}

Get post

Get one post with its author, board, category, tags, status and vote count.

Inputs

Post IDpost_idtextRequired
The post's id, from 'List posts', 'Create post' or an earlier step.

Outputs

postobject
The post
Example output
{
  "post": {
    "author": {
      "alias": "jo",
      "avatarURL": "",
      "companies": [],
      "created": "2026-01-05T10:00:00.000Z",
      "customFields": {},
      "email": "jo@example.com",
      "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
      "isAdmin": false,
      "lastActivity": "2026-02-01T09:00:00.000Z",
      "name": "Jo Bloggs",
      "url": "https://acme.canny.io/admin/users/jo",
      "userID": "usr_123"
    },
    "board": {
      "created": "2026-01-01T10:00:00.000Z",
      "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
      "isPrivate": false,
      "name": "Feature Requests",
      "postCount": 12,
      "privateComments": false,
      "url": "https://acme.canny.io/feature-requests"
    },
    "by": null,
    "category": {
      "board": {
        "created": "2026-01-01T10:00:00.000Z",
        "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
        "isPrivate": false,
        "name": "Feature Requests",
        "postCount": 12,
        "privateComments": false,
        "url": "https://acme.canny.io/feature-requests"
      },
      "created": "2026-01-02T10:00:00.000Z",
      "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
      "name": "Integrations",
      "parentID": "",
      "postCount": 4,
      "url": "https://acme.canny.io/feature-requests?category=integrations"
    },
    "commentCount": 2,
    "created": "2026-01-10T10:00:00.000Z",
    "customFields": {},
    "details": "Please add a dark theme.",
    "eta": "03/2027",
    "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
    "imageURLs": [],
    "owner": null,
    "score": 14,
    "status": "planned",
    "statusChangedAt": "2026-02-01T10:00:00.000Z",
    "tags": [
      {
        "board": {
          "created": "2026-01-01T10:00:00.000Z",
          "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
          "isPrivate": false,
          "name": "Feature Requests",
          "postCount": 12,
          "privateComments": false,
          "url": "https://acme.canny.io/feature-requests"
        },
        "created": "2026-01-02T10:00:00.000Z",
        "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
        "name": "enterprise",
        "postCount": 3,
        "url": "https://acme.canny.io/feature-requests?tags=enterprise"
      }
    ],
    "title": "Dark mode",
    "url": "https://acme.canny.io/feature-requests/p/dark-mode"
  }
}

Get user

Find one user by their Canny id, your own id for them, or their email. Give exactly one.

Inputs

Canny IDcanny_idtext
The user's Canny id.
Your user IDexternal_idtext
The id your own app uses for the user.
Emailemailtext
The user's email address.

Outputs

userobject
The user
Example output
{
  "user": {
    "alias": "jo",
    "avatarURL": "",
    "companies": [],
    "created": "2026-01-05T10:00:00.000Z",
    "customFields": {},
    "email": "jo@example.com",
    "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
    "isAdmin": false,
    "lastActivity": "2026-02-01T09:00:00.000Z",
    "name": "Jo Bloggs",
    "url": "https://acme.canny.io/admin/users/jo",
    "userID": "usr_123"
  }
}

List boards

List every board in the company, with its name, privacy and number of posts.

Inputs

None.

Outputs

boardslist
The boards
countnumber
How many boards
Example output
{
  "boards": [
    {
      "created": "2026-01-01T10:00:00.000Z",
      "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
      "isPrivate": false,
      "name": "Feature Requests",
      "postCount": 12,
      "privateComments": false,
      "url": "https://acme.canny.io/feature-requests"
    }
  ],
  "count": 1
}

List categories

List categories, of one board or of every board. Returns one page; pass 'next_skip' as 'skip' for more.

Inputs

Boardboard_idtext
The board. Pick one, or give its id from an earlier step.
Page sizelimitnumber
How many to return, 1 to 100. Canny's default is 10.From 1 to 100.
Records to skipskipnumber
How many to skip, to get the next page: pass 'next_skip' from the last page.At least 0.

Outputs

categorieslist
The categories
countnumber
How many came back
has_moretrue/false
Whether more remain
next_skipnumber
'skip' for the next page, empty on the last
Example output
{
  "categories": [
    {
      "board": {
        "created": "2026-01-01T10:00:00.000Z",
        "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
        "isPrivate": false,
        "name": "Feature Requests",
        "postCount": 12,
        "privateComments": false,
        "url": "https://acme.canny.io/feature-requests"
      },
      "created": "2026-01-02T10:00:00.000Z",
      "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
      "name": "Integrations",
      "parentID": "",
      "postCount": 4,
      "url": "https://acme.canny.io/feature-requests?category=integrations"
    }
  ],
  "count": 1,
  "has_more": false,
  "next_skip": null
}

List changelog entries

List changelog entries, filtered by status, type or label. Returns one page; pass 'next_skip' as 'skip' for more.

Inputs

Statusstatuslist
Only entries in one of these statuses. Leave empty for all.One or more of: draft, scheduled, published.
Typetypetext
Only this kind of entry.One of: new, improved, fixed.
Label IDslabel_idslist
The ids of the changelog labels, from an earlier entry's labels.
Ordersorttext
How to order the entries.One of: nonPublishedFirst (Drafts and scheduled first (default)), created (Newest created), lastSaved (Last saved), publishedAt (Newest published).
Page sizelimitnumber
How many to return, 1 to 100. Canny's default is 10.From 1 to 100.
Records to skipskipnumber
How many to skip, to get the next page: pass 'next_skip' from the last page.At least 0.

Outputs

countnumber
How many came back
entrieslist
The entries
has_moretrue/false
Whether more remain
next_skipnumber
'skip' for the next page, empty on the last
Example output
{
  "count": 1,
  "entries": [
    {
      "created": "2026-02-01T10:00:00.000Z",
      "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
      "labels": [],
      "lastSaved": "2026-02-01T10:00:00.000Z",
      "markdownDetails": "You can now switch to a dark theme.",
      "plaintextDetails": "You can now switch to a dark theme.",
      "posts": [],
      "publishedAt": "2026-02-01T10:00:00.000Z",
      "scheduledFor": "",
      "status": "published",
      "title": "Dark mode is here",
      "types": [
        "new"
      ],
      "url": "https://acme.canny.io/changelog/dark-mode-is-here"
    }
  ],
  "has_more": false,
  "next_skip": null
}

List comments

List comments, of one post, board, author or company, or all of them. Returns one page; pass 'next_cursor' as 'cursor' for more.

Inputs

Post IDpost_idtext
The post's id, from 'List posts', 'Create post' or an earlier step.
Boardboard_idtext
The board. Pick one, or give its id from an earlier step.
Authorauthor_idtext
Only comments by this user. The Canny id of a user, from 'Get user', 'List users' or 'Create or update user' (not your own user id).
Company IDcompany_idtext
Only comments by users of this company.
Page sizelimitnumber
How many to return, 1 to 100. Canny's default is 10.From 1 to 100.
Next page cursorcursortext
The 'next_cursor' from an earlier page, to get the page after it.

Outputs

commentslist
The comments
countnumber
How many came back
has_next_pagetrue/false
Whether more remain
next_cursortext
'cursor' for the next page
Example output
{
  "comments": [
    {
      "author": {
        "alias": "jo",
        "avatarURL": "",
        "companies": [],
        "created": "2026-01-05T10:00:00.000Z",
        "customFields": {},
        "email": "jo@example.com",
        "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
        "isAdmin": false,
        "lastActivity": "2026-02-01T09:00:00.000Z",
        "name": "Jo Bloggs",
        "url": "https://acme.canny.io/admin/users/jo",
        "userID": "usr_123"
      },
      "board": {
        "created": "2026-01-01T10:00:00.000Z",
        "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
        "isPrivate": false,
        "name": "Feature Requests",
        "postCount": 12,
        "privateComments": false,
        "url": "https://acme.canny.io/feature-requests"
      },
      "created": "2026-01-11T10:00:00.000Z",
      "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
      "imageURLs": [],
      "internal": false,
      "likeCount": 1,
      "parentID": "",
      "post": {
        "author": {
          "alias": "jo",
          "avatarURL": "",
          "companies": [],
          "created": "2026-01-05T10:00:00.000Z",
          "customFields": {},
          "email": "jo@example.com",
          "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
          "isAdmin": false,
          "lastActivity": "2026-02-01T09:00:00.000Z",
          "name": "Jo Bloggs",
          "url": "https://acme.canny.io/admin/users/jo",
          "userID": "usr_123"
        },
        "board": {
          "created": "2026-01-01T10:00:00.000Z",
          "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
          "isPrivate": false,
          "name": "Feature Requests",
          "postCount": 12,
          "privateComments": false,
          "url": "https://acme.canny.io/feature-requests"
        },
        "by": null,
        "category": {
          "board": {
            "created": "2026-01-01T10:00:00.000Z",
            "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
            "isPrivate": false,
            "name": "Feature Requests",
            "postCount": 12,
            "privateComments": false,
            "url": "https://acme.canny.io/feature-requests"
          },
          "created": "2026-01-02T10:00:00.000Z",
          "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
          "name": "Integrations",
          "parentID": "",
          "postCount": 4,
          "url": "https://acme.canny.io/feature-requests?category=integrations"
        },
        "commentCount": 2,
        "created": "2026-01-10T10:00:00.000Z",
        "customFields": {},
        "details": "Please add a dark theme.",
        "eta": "03/2027",
        "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
        "imageURLs": [],
        "owner": null,
        "score": 14,
        "status": "planned",
        "statusChangedAt": "2026-02-01T10:00:00.000Z",
        "tags": [
          {
            "board": {
              "created": "2026-01-01T10:00:00.000Z",
              "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
              "isPrivate": false,
              "name": "Feature Requests",
              "postCount": 12,
              "privateComments": false,
              "url": "https://acme.canny.io/feature-requests"
            },
            "created": "2026-01-02T10:00:00.000Z",
            "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
            "name": "enterprise",
            "postCount": 3,
            "url": "https://acme.canny.io/feature-requests?tags=enterprise"
          }
        ],
        "title": "Dark mode",
        "url": "https://acme.canny.io/feature-requests/p/dark-mode"
      },
      "private": false,
      "value": "We are looking into it."
    }
  ],
  "count": 1,
  "has_next_page": false,
  "next_cursor": ""
}

List posts

List posts, filtered by board, author, company, tags, status or a search. Returns one page; pass 'next_skip' as 'skip' for more.

Inputs

Boardboard_idtext
The board. Pick one, or give its id from an earlier step.
Authorauthor_idtext
Only posts by this user. The Canny id of a user, from 'Get user', 'List users' or 'Create or update user' (not your own user id).
Company IDcompany_idtext
Only posts by users of this company.
Tagstag_idslist
Only posts with one of these tags.
Statusstatuslist
Only posts in one of these statuses. Leave empty for all.One or more of: open, under review, planned, in progress, complete, closed.
Searchsearchtext
Words to look for in titles and details.
Ordersorttext
How to order the posts. Defaults to newest first.One of: newest (Newest first (default)), oldest (Oldest first), score (Most votes), trending, statusChanged (Status changed most recently), relevance (Most relevant (needs a search)).
Page sizelimitnumber
How many to return, 1 to 100. Canny's default is 10.From 1 to 100.
Records to skipskipnumber
How many to skip, to get the next page: pass 'next_skip' from the last page.At least 0.

Outputs

countnumber
How many came back
has_moretrue/false
Whether more remain
next_skipnumber
'skip' for the next page, empty on the last
postslist
The posts
Example output
{
  "count": 1,
  "has_more": false,
  "next_skip": null,
  "posts": [
    {
      "author": {
        "alias": "jo",
        "avatarURL": "",
        "companies": [],
        "created": "2026-01-05T10:00:00.000Z",
        "customFields": {},
        "email": "jo@example.com",
        "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
        "isAdmin": false,
        "lastActivity": "2026-02-01T09:00:00.000Z",
        "name": "Jo Bloggs",
        "url": "https://acme.canny.io/admin/users/jo",
        "userID": "usr_123"
      },
      "board": {
        "created": "2026-01-01T10:00:00.000Z",
        "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
        "isPrivate": false,
        "name": "Feature Requests",
        "postCount": 12,
        "privateComments": false,
        "url": "https://acme.canny.io/feature-requests"
      },
      "by": null,
      "category": {
        "board": {
          "created": "2026-01-01T10:00:00.000Z",
          "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
          "isPrivate": false,
          "name": "Feature Requests",
          "postCount": 12,
          "privateComments": false,
          "url": "https://acme.canny.io/feature-requests"
        },
        "created": "2026-01-02T10:00:00.000Z",
        "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
        "name": "Integrations",
        "parentID": "",
        "postCount": 4,
        "url": "https://acme.canny.io/feature-requests?category=integrations"
      },
      "commentCount": 2,
      "created": "2026-01-10T10:00:00.000Z",
      "customFields": {},
      "details": "Please add a dark theme.",
      "eta": "03/2027",
      "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
      "imageURLs": [],
      "owner": null,
      "score": 14,
      "status": "planned",
      "statusChangedAt": "2026-02-01T10:00:00.000Z",
      "tags": [
        {
          "board": {
            "created": "2026-01-01T10:00:00.000Z",
            "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
            "isPrivate": false,
            "name": "Feature Requests",
            "postCount": 12,
            "privateComments": false,
            "url": "https://acme.canny.io/feature-requests"
          },
          "created": "2026-01-02T10:00:00.000Z",
          "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
          "name": "enterprise",
          "postCount": 3,
          "url": "https://acme.canny.io/feature-requests?tags=enterprise"
        }
      ],
      "title": "Dark mode",
      "url": "https://acme.canny.io/feature-requests/p/dark-mode"
    }
  ]
}

List tags

List tags, of one board or of every board. Returns one page; pass 'next_skip' as 'skip' for more.

Inputs

Boardboard_idtext
The board. Pick one, or give its id from an earlier step.
Page sizelimitnumber
How many to return, 1 to 100. Canny's default is 10.From 1 to 100.
Records to skipskipnumber
How many to skip, to get the next page: pass 'next_skip' from the last page.At least 0.

Outputs

countnumber
How many came back
has_moretrue/false
Whether more remain
next_skipnumber
'skip' for the next page, empty on the last
tagslist
The tags
Example output
{
  "count": 1,
  "has_more": false,
  "next_skip": null,
  "tags": [
    {
      "board": {
        "created": "2026-01-01T10:00:00.000Z",
        "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
        "isPrivate": false,
        "name": "Feature Requests",
        "postCount": 12,
        "privateComments": false,
        "url": "https://acme.canny.io/feature-requests"
      },
      "created": "2026-01-02T10:00:00.000Z",
      "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
      "name": "enterprise",
      "postCount": 3,
      "url": "https://acme.canny.io/feature-requests?tags=enterprise"
    }
  ]
}

List users

List the company's users. Returns one page; pass 'next_cursor' as 'cursor' for more.

Inputs

Page sizelimitnumber
How many to return, 1 to 100. Canny's default is 10.From 1 to 100.
Next page cursorcursortext
The 'next_cursor' from an earlier page, to get the page after it.

Outputs

countnumber
How many came back
has_next_pagetrue/false
Whether more remain
next_cursortext
'cursor' for the next page
userslist
The users
Example output
{
  "count": 1,
  "has_next_page": false,
  "next_cursor": "",
  "users": [
    {
      "alias": "jo",
      "avatarURL": "",
      "companies": [],
      "created": "2026-01-05T10:00:00.000Z",
      "customFields": {},
      "email": "jo@example.com",
      "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
      "isAdmin": false,
      "lastActivity": "2026-02-01T09:00:00.000Z",
      "name": "Jo Bloggs",
      "url": "https://acme.canny.io/admin/users/jo",
      "userID": "usr_123"
    }
  ]
}

List votes

List votes, of one post, board, voter or company, or all of them. Returns one page; pass 'next_cursor' as 'cursor' for more.

Inputs

Post IDpost_idtext
The post's id, from 'List posts', 'Create post' or an earlier step.
Boardboard_idtext
The board. Pick one, or give its id from an earlier step.
Votervoter_idtext
Only votes by this user. The Canny id of a user, from 'Get user', 'List users' or 'Create or update user' (not your own user id).
Company IDcompany_idtext
Only votes by users of this company.
Page sizelimitnumber
How many to return, 1 to 100. Canny's default is 10.From 1 to 100.
Next page cursorcursortext
The 'next_cursor' from an earlier page, to get the page after it.

Outputs

countnumber
How many came back
has_next_pagetrue/false
Whether more remain
next_cursortext
'cursor' for the next page
voteslist
The votes
Example output
{
  "count": 1,
  "has_next_page": false,
  "next_cursor": "",
  "votes": [
    {
      "board": {
        "created": "2026-01-01T10:00:00.000Z",
        "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
        "isPrivate": false,
        "name": "Feature Requests",
        "postCount": 12,
        "privateComments": false,
        "url": "https://acme.canny.io/feature-requests"
      },
      "by": null,
      "created": "2026-01-12T10:00:00.000Z",
      "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
      "post": {
        "author": {
          "alias": "jo",
          "avatarURL": "",
          "companies": [],
          "created": "2026-01-05T10:00:00.000Z",
          "customFields": {},
          "email": "jo@example.com",
          "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
          "isAdmin": false,
          "lastActivity": "2026-02-01T09:00:00.000Z",
          "name": "Jo Bloggs",
          "url": "https://acme.canny.io/admin/users/jo",
          "userID": "usr_123"
        },
        "board": {
          "created": "2026-01-01T10:00:00.000Z",
          "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
          "isPrivate": false,
          "name": "Feature Requests",
          "postCount": 12,
          "privateComments": false,
          "url": "https://acme.canny.io/feature-requests"
        },
        "by": null,
        "category": {
          "board": {
            "created": "2026-01-01T10:00:00.000Z",
            "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
            "isPrivate": false,
            "name": "Feature Requests",
            "postCount": 12,
            "privateComments": false,
            "url": "https://acme.canny.io/feature-requests"
          },
          "created": "2026-01-02T10:00:00.000Z",
          "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
          "name": "Integrations",
          "parentID": "",
          "postCount": 4,
          "url": "https://acme.canny.io/feature-requests?category=integrations"
        },
        "commentCount": 2,
        "created": "2026-01-10T10:00:00.000Z",
        "customFields": {},
        "details": "Please add a dark theme.",
        "eta": "03/2027",
        "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
        "imageURLs": [],
        "owner": null,
        "score": 14,
        "status": "planned",
        "statusChangedAt": "2026-02-01T10:00:00.000Z",
        "tags": [
          {
            "board": {
              "created": "2026-01-01T10:00:00.000Z",
              "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
              "isPrivate": false,
              "name": "Feature Requests",
              "postCount": 12,
              "privateComments": false,
              "url": "https://acme.canny.io/feature-requests"
            },
            "created": "2026-01-02T10:00:00.000Z",
            "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
            "name": "enterprise",
            "postCount": 3,
            "url": "https://acme.canny.io/feature-requests?tags=enterprise"
          }
        ],
        "title": "Dark mode",
        "url": "https://acme.canny.io/feature-requests/p/dark-mode"
      },
      "votePriority": "",
      "voter": {
        "alias": "jo",
        "avatarURL": "",
        "companies": [],
        "created": "2026-01-05T10:00:00.000Z",
        "customFields": {},
        "email": "jo@example.com",
        "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
        "isAdmin": false,
        "lastActivity": "2026-02-01T09:00:00.000Z",
        "name": "Jo Bloggs",
        "url": "https://acme.canny.io/admin/users/jo",
        "userID": "usr_123"
      }
    }
  ]
}

Publish or unpublish changelog entry

Publish an entry, schedule it for later, or turn it back into a draft.

Inputs

Entry IDentry_idtextRequired
The changelog entry's id, from 'List changelog entries' or 'Create changelog entry'.
StatusstatustextRequired
Published, scheduled or draft.One of: draft, scheduled, published.
Published onpublished_ondate and time
A date and time in the past to show as the publish time.
Schedule forscheduled_fordate and time
A date and time in the future to publish the entry.

Outputs

entry_idtext
The entry's id
statustext
Its new status
Example output
{
  "entry_id": "5f8a1b2c3d4e5f6a7b8c9d0e",
  "status": "published"
}

Remove tag from post

Take a tag off a post.

Inputs

Post IDpost_idtextRequired
The post's id, from 'List posts', 'Create post' or an earlier step.
Tagtag_idtextRequired
The tag. Pick one, or give its id from an earlier step.

Outputs

postobject
The updated post
Example output
{
  "post": {
    "author": {
      "alias": "jo",
      "avatarURL": "",
      "companies": [],
      "created": "2026-01-05T10:00:00.000Z",
      "customFields": {},
      "email": "jo@example.com",
      "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
      "isAdmin": false,
      "lastActivity": "2026-02-01T09:00:00.000Z",
      "name": "Jo Bloggs",
      "url": "https://acme.canny.io/admin/users/jo",
      "userID": "usr_123"
    },
    "board": {
      "created": "2026-01-01T10:00:00.000Z",
      "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
      "isPrivate": false,
      "name": "Feature Requests",
      "postCount": 12,
      "privateComments": false,
      "url": "https://acme.canny.io/feature-requests"
    },
    "by": null,
    "category": {
      "board": {
        "created": "2026-01-01T10:00:00.000Z",
        "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
        "isPrivate": false,
        "name": "Feature Requests",
        "postCount": 12,
        "privateComments": false,
        "url": "https://acme.canny.io/feature-requests"
      },
      "created": "2026-01-02T10:00:00.000Z",
      "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
      "name": "Integrations",
      "parentID": "",
      "postCount": 4,
      "url": "https://acme.canny.io/feature-requests?category=integrations"
    },
    "commentCount": 2,
    "created": "2026-01-10T10:00:00.000Z",
    "customFields": {},
    "details": "Please add a dark theme.",
    "eta": "03/2027",
    "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
    "imageURLs": [],
    "owner": null,
    "score": 14,
    "status": "planned",
    "statusChangedAt": "2026-02-01T10:00:00.000Z",
    "tags": [
      {
        "board": {
          "created": "2026-01-01T10:00:00.000Z",
          "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
          "isPrivate": false,
          "name": "Feature Requests",
          "postCount": 12,
          "privateComments": false,
          "url": "https://acme.canny.io/feature-requests"
        },
        "created": "2026-01-02T10:00:00.000Z",
        "id": "5f8a1b2c3d4e5f6a7b8c9d0e",
        "name": "enterprise",
        "postCount": 3,
        "url": "https://acme.canny.io/feature-requests?tags=enterprise"
      }
    ],
    "title": "Dark mode",
    "url": "https://acme.canny.io/feature-requests/p/dark-mode"
  }
}

Remove vote

Take a user's vote off a post.

Inputs

Post IDpost_idtextRequired
The post's id, from 'List posts', 'Create post' or an earlier step.
Votervoter_idtextRequired
Whose vote to remove. The Canny id of a user, from 'Get user', 'List users' or 'Create or update user' (not your own user id).

Outputs

post_idtext
The post's id
removedtrue/false
True once Canny confirms it
voter_idtext
The voter's id
Example output
{
  "post_id": "5f8a1b2c3d4e5f6a7b8c9d0e",
  "removed": true,
  "voter_id": "5f8a1b2c3d4e5f6a7b8c9d0e"
}

Update changelog entry

Change an entry's title, text, type, labels or linked posts. Empty fields are left as they are.

Inputs

Entry IDentry_idtextRequired
The changelog entry's id, from 'List changelog entries' or 'Create changelog entry'.
Titletitletext
The entry's title, up to 400 characters.
Detailsdetailstext
The entry's text, in Markdown.
Typetypetext
What kind of change it is.One of: new, improved, fixed.
Email subscribersnotifytrue/false
Tell the entry's subscribers when it is published.Default: false.
Label IDslabel_idslist
The ids of the changelog labels, from an earlier entry's labels.
Linked post IDspost_idslist
The ids of posts this entry is about; their voters can be told when it is published.

Outputs

entry_idtext
The entry's id
updatedtrue/false
True once Canny confirms it
Example output
{
  "entry_id": "5f8a1b2c3d4e5f6a7b8c9d0e",
  "updated": true
}

Update post

Change a post's title, details, owner, ETA or custom fields. Empty fields are left as they are.

Inputs

Post IDpost_idtextRequired
The post's id, from 'List posts', 'Create post' or an earlier step.
Titletitletext
A new title, up to 400 characters.
Detailsdetailstext
New text, up to 10,000 characters.
Ownerowner_idtext
The admin responsible for it. The Canny id of a user, from 'Get user', 'List users' or 'Create or update user' (not your own user id).
Changed bychanger_idtext
Who is making the change. Needed when you set an owner. The Canny id of a user, from 'Get user', 'List users' or 'Create or update user' (not your own user id).
ETAetadate
When the work should be done. Canny keeps the month and year.
Show ETA to everyoneeta_publictrue/false
Make the ETA public.Default: false.
Custom fieldscustom_fieldsobject
Values for the company's custom post fields, as {"Field name": value}. Values must suit each field's type.

Outputs

post_idtext
The post's id
updatedtrue/false
True once Canny confirms it
Example output
{
  "post_id": "5f8a1b2c3d4e5f6a7b8c9d0e",
  "updated": true
}

On this page