> For the complete documentation index, see [llms.txt](https://ask.birdie.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ask.birdie.ai/integrations-and-data-ingestion/how-to-integrate-with/canny.md).

# Canny

### Overview

This integration imports customer feedback from your Canny workspace into Birdie, allowing you to analyze feature requests, bug reports, and customer suggestions alongside other feedback sources.

The connector imports Canny posts together with their associated metadata, including boards, categories, tags, comments, status, and vote information, providing additional context for your customer feedback.

### Requirements

* A Canny workspace.
* A Canny API Key.

To retrieve your API Key, follow the instructions below.

### Setup in Canny

{% stepper %}
{% step %}

### Access Account Settings

Log in to your Canny workspace and click your profile picture in the bottom-left corner.
{% endstep %}

{% step %}

### Open API Settings

Navigate to **Settings** and then **API**.
{% endstep %}

{% step %}

### Obtain API Key

Copy your API Key.

Once you have access to your API key, share it with us following our guide: [Securely Sharing Credentials for Data Integration](https://ask.birdie.ai/integrations-and-data-ingestion/securely-sharing-credentials-for-data-integration.md).
{% endstep %}
{% endstepper %}

### Connect to Birdie

After securely sharing your Canny API Key, the Birdie team will configure the connector and confirm once the integration is active.

### Data in scope

#### Import Process and Update Frequency

Birdie periodically imports newly created and updated posts from your Canny workspace, along with their associated metadata. This ensures that the latest customer feedback is consistently available for analysis in Birdie.

#### Custom fields

In addition to the standard feedback schema, Birdie imports Canny metadata as custom fields whenever applicable.

Depending on your workspace configuration, Birdie can import metadata associated with:

* Posts
* Boards
* Categories
* Tags
* Votes
* Users
* Companies (when available)

These metadata fields are imported as Birdie custom fields whenever applicable, enabling advanced filtering, segmentation, and analysis across your customer feedback.

### References

* [Canny API Documentation](https://developers.canny.io/api-reference#intro)
* [About Canny API](https://help.canny.io/en/articles/4195400-the-canny-api)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://ask.birdie.ai/integrations-and-data-ingestion/how-to-integrate-with/canny.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
