NAiOS IconNAiOS Logo
Contacto
Volver al catálogo

Canny

canny

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

Product ManagementForms & SurveysWeb del proveedor
Acciones
25
Triggers
0
Autenticación
—
OAuth gestionado
No
Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

Acciones disponibles (25)

Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.

Add Post TagCANNY_ADD_POST_TAGAcción

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

Parámetros de entrada

  • tagIDstringObligatorio

    Unique identifier of the tag to add to the post.

  • postIDstringObligatorio

    Unique identifier of the post to which the tag will be added.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete UserCANNY_CANNY_DELETE_USERAcción

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).

Parámetros de entrada

  • idstringObligatorio

    The unique identifier of the user to delete.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Change Post StatusCANNY_CHANGE_POST_STATUSAcción

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

Parámetros de entrada

  • postIDstringObligatorio

    Unique identifier of the post to update.

  • statusstringObligatorio

    New status for the post. Common values include 'open', 'under review', 'planned', 'in progress', 'complete', 'closed', or any custom status configured in Canny.

  • changerIDstringObligatorio

    Identifier of the admin making the status change.

  • commentValuestring

    Optional comment for the status change. Use ' ' for new lines.

  • commentImageURLsstring[]

    Optional list of image URLs to attach to the status change.

  • shouldNotifyVotersboolean

    Whether non-admin voters should be notified of the status change.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create Changelog EntryCANNY_CREATE_CHANGELOG_ENTRYAcción

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.".

Parámetros de entrada

  • typestringenum

    Optional type of your changelog entry: 'fixed', 'new', or 'improved'.

    fixednewimproved
  • titlestringObligatorio

    The title of your changelog entry.

  • notifyboolean

    If publishing immediately, whether to notify users by email. Defaults to false.

  • detailsstringObligatorio

    The Markdown-formatted details of your changelog entry.

  • postIDsstring[]

    List of post IDs to link to this changelog entry.

  • labelIDsstring[]

    List of label IDs to assign to this changelog entry.

  • publishedboolean

    Whether to publish the entry immediately. Defaults to false.

  • publishedOnstring

    If 'published' is true, override the publish date (ISO 8601 format, must not be in the future).

  • scheduledForstring

    Schedule a future publish date (ISO 8601 format, must be in the future).

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create CommentCANNY_CREATE_COMMENTAcción

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

Parámetros de entrada

  • valuestring

    Text content of the comment, up to 2500 characters. Required if no images.

  • postIDstringObligatorio

    Unique identifier of the post to which the comment is added.

  • authorIDstringObligatorio

    Unique identifier of the comment's author.

  • internalboolean

    Flag for internal-use-only comments. Can only be true if the author is a company member.

  • parentIDstring

    If this comment is a reply, the unique identifier of the parent comment.

  • createdAtstring

    Original creation timestamp in ISO 8601 format (useful for migrating comments)

  • imageURLsstring[]

    List of image URLs to attach to the comment.

  • shouldNotifyVotersboolean

    Whether to send email notifications to voters of the post.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create or Update UserCANNY_CREATE_OR_UPDATE_USERAcción

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"

Parámetros de entrada

  • idstring

    Canny's unique identifier for the user.

  • namestringObligatorio

    The user's name (1-50 characters).

  • aliasstring

    Optional alias for the user.

  • emailstring

    The user's email address.

  • userIDstring

    Your application's unique identifier for the user.

  • createdstring

    Date the user was created in your system (ISO 8601 format).

  • avatarURLstring

    URL to the user's avatar image.

  • companiesobject[]

    List of companies associated with the user.

  • customFieldsobject

    Custom fields for the user (keys 0-30 chars; string values <200 chars).

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create PostCANNY_CREATE_POSTAcción

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

Parámetros de entrada

  • tagsstring[]

    List of tags to associate with the post.

  • titlestringObligatorio

    Title of the post.

  • userIDstringObligatorio

    ID of the user creating the post.

  • boardIDstringObligatorio

    ID of the board where the post will be created.

  • createdinteger

    Unix timestamp for when the post was created. Defaults to server time if not provided.

  • detailsstring

    Detailed description or body of the post.

  • isPrivateboolean

    Flag indicating if the post should be private.

  • assigneeIDstring

    ID of the team member assigned to the post.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create TagCANNY_CREATE_TAGAcción

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

Parámetros de entrada

  • namestringObligatorio

    Name of the tag, between 1 and 30 characters.

  • boardIDstringObligatorio

    ID of the board where the tag should be created.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create VoteCANNY_CREATE_VOTEAcción

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.

Parámetros de entrada

  • byIDstring

    The unique identifier of the user casting the vote on behalf of the voter. Must be a Canny administrator.

  • postIDstringObligatorio

    The unique identifier of the post to vote on.

  • voterIDstringObligatorio

    The unique identifier of the user casting the vote.

  • createdAtstring

    If migrating votes, the original creation timestamp in ISO 8601 format.

  • votePriorityintegerenum

    Priority of the vote: 0 (Nice to have), 10 (Important), or 20 (Must have).

    01020

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete CommentCANNY_DELETE_COMMENTAcción

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."

Parámetros de entrada

  • commentIDstringObligatorio

    The unique identifier of the comment to delete.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete PostCANNY_DELETE_POSTAcción

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

Parámetros de entrada

  • postIDstringObligatorio

    The unique identifier of the post to delete.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete VoteCANNY_DELETE_VOTEAcción

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."

Parámetros de entrada

  • postIDstringObligatorio

    The unique identifier of the post from which the vote will be removed.

  • voterIDstringObligatorio

    The unique identifier of the user whose vote is being removed.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List BoardsCANNY_LIST_BOARDSAcción

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

Parámetros de entrada

Sin parámetros.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List CategoriesCANNY_LIST_CATEGORIESAcción

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

Parámetros de entrada

  • skipinteger

    Number of categories to skip. Defaults to 0 if not specified.

  • limitinteger

    Number of categories to return. Defaults to 10 if not specified.

  • boardIDstring

    Filter categories by this board's ID.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List CommentsCANNY_LIST_COMMENTSAcción

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

Parámetros de entrada

  • skipinteger

    Number of comments to skip before fetching (default: 0).

  • limitinteger

    Number of comments to fetch (default: 10).

  • postIDstring

    Filter comments by this post ID.

  • boardIDstring

    Filter comments by this board ID.

  • authorIDstring

    Filter comments by this author ID.

  • companyIDstring

    Fetch comments for posts created by users linked to this company ID.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List CompaniesCANNY_LIST_COMPANIESAcción

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

Parámetros de entrada

  • limitinteger

    Maximum number of companies to return (1-100).

  • cursorstring

    Pagination cursor from a previous listCompanies response.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List OpportunitiesCANNY_LIST_OPPORTUNITIESAcción

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

Parámetros de entrada

  • skipinteger

    Number of opportunities to skip before returning. Defaults to 0.

  • limitinteger

    Maximum number of opportunities to return. Defaults to 10 if unspecified.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List PostsCANNY_LIST_POSTSAcción

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

Parámetros de entrada

  • skipinteger

    Number of posts to skip before fetching; defaults to 0.

  • sortstringenum

    Order in which to fetch posts. 'relevance' requires a search value.

    newestoldestrelevancescorestatusChangedtrending
  • limitinteger

    Number of posts to fetch; defaults to 10.

  • searchstring

    Search query to filter posts by title or details.

  • statusstring

    Comma-separated list of statuses to filter by (e.g. 'planned,complete').

  • tagIDsstring[]

    Only fetch posts tagged with at least one of these tag IDs.

  • boardIDstring

    ID of the board to fetch posts for.

  • authorIDstring

    Only fetch posts by this author ID.

  • companyIDstring

    Only fetch posts created by users linked to this company identifier.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List TagsCANNY_LIST_TAGSAcción

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

Parámetros de entrada

  • skipinteger

    Number of tags to skip before returning results. Defaults to 0.

  • limitinteger

    Maximum number of tags to return. Defaults to 10.

  • boardIDstring

    Filter tags by this board's ID.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List UsersCANNY_LIST_USERSAcción

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

Parámetros de entrada

  • limitinteger

    Number of entries to fetch (1-100). Defaults to 10.

  • cursorstring

    Cursor from a previous request to continue pagination.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List VotesCANNY_LIST_VOTESAcción

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

Parámetros de entrada

  • skipinteger

    Number of votes to skip before fetching (default: 0).

  • limitinteger

    Number of votes to fetch (default: 10).

  • postIDstring

    Filter votes by this post ID.

  • boardIDstring

    Filter votes by this board ID.

  • voterIDstring

    Filter votes by this voter ID.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Retrieve BoardCANNY_RETRIEVE_BOARDAcción

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

Parámetros de entrada

  • idstringObligatorio

    Unique identifier of the board.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Retrieve TagCANNY_RETRIEVE_TAGAcción

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

Parámetros de entrada

  • idstringObligatorio

    Unique identifier of the tag to retrieve.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Retrieve UserCANNY_RETRIEVE_USERAcción

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"

Parámetros de entrada

  • idstring

    Canny user ID (provide one of 'id', 'userID', or 'email').

  • emailstring

    User's email address (provide one of 'id', 'userID', or 'email').

  • userIDstring

    Your application user ID (provide one of 'id', 'userID', or 'email').

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Update PostCANNY_UPDATE_POSTAcción

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

Parámetros de entrada

  • etastring

    Estimated completion date in MM/YYYY format, e.g., '06/2022'.

  • titlestring

    Short title of the post.

  • postIDstringObligatorio

    Unique identifier of the post to update.

  • detailsstring

    Detailed text body of the post.

  • etaPublicboolean

    Whether the ETA should be visible to end-users.

  • imageURLsstring[]

    List of image URLs to attach to the post.

  • customFieldsobject

    Custom fields to set on the post. Keys must be 0-30 characters; values can be string, number, or boolean.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not