Skip to main content

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​

  1. In Airbyte, create a new source and select Aha.
  2. For API Bearer Token, enter your Aha! API key.
  3. 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/v1 path. The connector appends /api/v1 to this URL.
  4. Click Set up source. Airbyte tests the connection by reading the products_stream stream.

Supported sync modes​

FeatureSupported?
Full Refresh SyncYes
Incremental SyncNo

Supported streams​

StreamAha! API endpointNotes
features_streamList features
products_streamList products
idea_categories_streamGET /products/{product_id}/idea_categoriesRead once for each product in products_stream.
ideas_streamList ideas
idea_endorsements_streamGET /ideas/{idea_id}/endorsementsRead once for each idea in ideas_stream.
idea_comments_streamGET /ideas/{idea_id}/idea_commentsRead once for each idea in ideas_stream.
users_streamList users
goals_streamList 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
VersionDatePull RequestSubject
0.4.252026-11-1091318Update to source-declarative-manifest base image 7.47.0 (airbyte-cdk 7.x)
0.4.242025-05-1059855Update dependencies
0.4.232025-05-0359356Update dependencies
0.4.222025-04-2658723Update dependencies
0.4.212025-04-1957608Update dependencies
0.4.202025-04-0557119Update dependencies
0.4.192025-03-2956597Update dependencies
0.4.182025-03-2256112Update dependencies
0.4.172025-03-0855406Update dependencies
0.4.162025-03-0154899Update dependencies
0.4.152025-02-2254214Update dependencies
0.4.142025-02-1553905Update dependencies
0.4.132025-02-0853439Update dependencies
0.4.122025-02-0152886Update dependencies
0.4.112025-01-2552192Update dependencies
0.4.102025-01-1851732Update dependencies
0.4.92025-01-1151234Update dependencies
0.4.82024-12-2850490Update dependencies
0.4.72024-12-2150158Update dependencies
0.4.62024-12-1449548Update dependencies
0.4.52024-12-1249298Update dependencies
0.4.42024-12-1148246Starting 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.32024-10-2947904Update dependencies
0.4.22024-10-2847641Update dependencies
0.4.12024-08-1644196Bump source-declarative-manifest version
0.4.02024-08-1444042Refactor connector to manifest-only format
0.3.142024-08-1243748Update dependencies
0.3.132024-08-1043556Update dependencies
0.3.122024-08-0343186Update dependencies
0.3.112024-07-2742737Update dependencies
0.3.102024-07-2042306Update dependencies
0.3.92024-07-1341914Update dependencies
0.3.82024-07-1041568Update dependencies
0.3.72024-07-0941170Update dependencies
0.3.62024-07-0640774Update dependencies
0.3.52024-06-2540435Update dependencies
0.3.42024-06-2240000Update dependencies
0.3.32024-06-0639153[autopull] Upgrade base image to v1.2.2
0.3.22024-05-1438144Make connector compatible with Builder
0.3.12023-06-0527002Flag spec api_key field as airbyte-secret
0.3.02023-05-3022642Add idea_comments, idea_endorsements, and idea_categories streams
0.2.02023-05-2626666Fix integration test and schemas
0.1.02022-11-0218893🎉 New Source: Aha