> 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](/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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.