Aha
This page contains the setup guide and reference information for the Aha! source connector. The connector reads data from the Aha! REST API.
Prerequisites
- An Aha! account with access to the data you want to sync
- An Aha! API key
- The URL of your Aha! account, for example
https://yourcompany.aha.io
Setup guide
Step 1: Generate an Aha! API key
Generate an API key in Aha! as described in the Aha! authentication documentation.
Step 2: Set up the connector in Airbyte
- In Airbyte, create a new source and select Aha.
- For API Bearer Token, enter your Aha! API key.
- For Aha Url Instance, enter the base URL of your Aha! account, such as
https://yourcompany.aha.io. Don't include a trailing slash or the/api/v1path. The connector appends/api/v1to this URL. - Click Set up source. Airbyte tests the connection by reading the
products_streamstream.
Supported sync modes
| Feature | Supported? |
|---|---|
| Full Refresh Sync | Yes |
| Incremental Sync | No |
Supported streams
| Stream | Aha! API endpoint | Notes |
|---|---|---|
features_stream | List features | |
products_stream | List products | |
idea_categories_stream | GET /products/{product_id}/idea_categories | Read once for each product in products_stream. |
ideas_stream | List ideas | |
idea_endorsements_stream | GET /ideas/{idea_id}/endorsements | Read once for each idea in ideas_stream. |
idea_comments_stream | GET /ideas/{idea_id}/idea_comments | Read once for each idea in ideas_stream. |
users_stream | List users | |
goals_stream | List goals |
Limitations
- The connector requests 5 records per page for every stream. Large accounts require many API requests, and the per-product and per-idea substreams make one or more requests for each parent record, so syncs can take a long time.
- Aha! allows up to 300 API requests per minute and 20 requests per second. See the Aha! rate limiting documentation for details.
IP allow list
If you use Airbyte Cloud and your organization restricts access to specific IPs, add the Airbyte Cloud IP addresses to your allow list.
Reference
Config fields reference
Field
Type
Property name
string
api_key
string
url
Changelog
Expand to review
| Version | Date | Pull Request | Subject |
|---|---|---|---|
| 0.4.25 | 2026-11-10 | 91318 | Update to source-declarative-manifest base image 7.47.0 (airbyte-cdk 7.x) |
| 0.4.24 | 2025-05-10 | 59855 | Update dependencies |
| 0.4.23 | 2025-05-03 | 59356 | Update dependencies |
| 0.4.22 | 2025-04-26 | 58723 | Update dependencies |
| 0.4.21 | 2025-04-19 | 57608 | Update dependencies |
| 0.4.20 | 2025-04-05 | 57119 | Update dependencies |
| 0.4.19 | 2025-03-29 | 56597 | Update dependencies |
| 0.4.18 | 2025-03-22 | 56112 | Update dependencies |
| 0.4.17 | 2025-03-08 | 55406 | Update dependencies |
| 0.4.16 | 2025-03-01 | 54899 | Update dependencies |
| 0.4.15 | 2025-02-22 | 54214 | Update dependencies |
| 0.4.14 | 2025-02-15 | 53905 | Update dependencies |
| 0.4.13 | 2025-02-08 | 53439 | Update dependencies |
| 0.4.12 | 2025-02-01 | 52886 | Update dependencies |
| 0.4.11 | 2025-01-25 | 52192 | Update dependencies |
| 0.4.10 | 2025-01-18 | 51732 | Update dependencies |
| 0.4.9 | 2025-01-11 | 51234 | Update dependencies |
| 0.4.8 | 2024-12-28 | 50490 | Update dependencies |
| 0.4.7 | 2024-12-21 | 50158 | Update dependencies |
| 0.4.6 | 2024-12-14 | 49548 | Update dependencies |
| 0.4.5 | 2024-12-12 | 49298 | Update dependencies |
| 0.4.4 | 2024-12-11 | 48246 | Starting with this version, the Docker image is now rootless. Please note that this and future versions will not be compatible with Airbyte versions earlier than 0.64 |
| 0.4.3 | 2024-10-29 | 47904 | Update dependencies |
| 0.4.2 | 2024-10-28 | 47641 | Update dependencies |
| 0.4.1 | 2024-08-16 | 44196 | Bump source-declarative-manifest version |
| 0.4.0 | 2024-08-14 | 44042 | Refactor connector to manifest-only format |
| 0.3.14 | 2024-08-12 | 43748 | Update dependencies |
| 0.3.13 | 2024-08-10 | 43556 | Update dependencies |
| 0.3.12 | 2024-08-03 | 43186 | Update dependencies |
| 0.3.11 | 2024-07-27 | 42737 | Update dependencies |
| 0.3.10 | 2024-07-20 | 42306 | Update dependencies |
| 0.3.9 | 2024-07-13 | 41914 | Update dependencies |
| 0.3.8 | 2024-07-10 | 41568 | Update dependencies |
| 0.3.7 | 2024-07-09 | 41170 | Update dependencies |
| 0.3.6 | 2024-07-06 | 40774 | Update dependencies |
| 0.3.5 | 2024-06-25 | 40435 | Update dependencies |
| 0.3.4 | 2024-06-22 | 40000 | Update dependencies |
| 0.3.3 | 2024-06-06 | 39153 | [autopull] Upgrade base image to v1.2.2 |
| 0.3.2 | 2024-05-14 | 38144 | Make connector compatible with Builder |
| 0.3.1 | 2023-06-05 | 27002 | Flag spec api_key field as airbyte-secret |
| 0.3.0 | 2023-05-30 | 22642 | Add idea_comments, idea_endorsements, and idea_categories streams |
| 0.2.0 | 2023-05-26 | 26666 | Fix integration test and schemas |
| 0.1.0 | 2022-11-02 | 18893 | 🎉 New Source: Aha |