FAQ

Where do I find my Aha API key?

Log in to Aha and click on your profile avatar in the top right corner. Go to Profile settings, then navigate to the Developer section. You'll find your API key there. If you don't see a Developer section, your plan may not include API access — check with your Aha administrator.

What do I enter as the Aha domain?

Enter only the subdomain part of your Aha workspace URL. If your workspace URL is yourcompany.aha.io, you would enter yourcompany. Do not include https:// or .aha.io.

Can I pull data from multiple Aha products at once?

Yes. The Aha API returns data across all products your API key has access to. When you import Features streams or Ideas streams, you'll get records from all accessible products in one go. You can then filter by product_id on the Data sets step or in your destination tool to focus on a specific product.

Why do I see HTML tags in my description fields?

Aha stores rich text content as HTML. This is how the Aha API returns it, and Coupler.io passes it through as-is. To get plain text, use a formula or text-cleaning function in your destination tool (e.g., a REGEXREPLACE in Google Sheets or a transformation in your BI tool) to strip the HTML tags.

Can I get idea votes or endorsement counts?

Yes. The Ideas streams entity includes a votes field with the total count. If you need to see who endorsed each idea (user-level detail), set up a separate source for Idea endorsements streams and join it to your ideas data on idea_id on the Data sets step.

How do I connect features to strategic goals?

Both Features streams and Goals streams include a product_id field. You can join them on product_id to understand which features belong to products that have associated goals. For tighter goal-to-feature mapping, check if your Aha workspace uses the goals relationship field on feature records.

Will archived or deleted records appear in my data flows?

Generally, no. The Aha API typically only returns active records. If you're missing records you expect to see, check whether they've been archived in your Aha workspace. There's currently no option in Coupler.io to specifically request archived records from Aha.

How often can I refresh my Aha data?

Coupler.io supports flexible scheduling — from every 15 minutes to weekly. However, Aha enforces API rate limits, so very frequent refreshes on large workspaces may cause issues. A daily or hourly schedule works well for most teams.

For tips on scheduling and rate limit management, see the Best Practices article. For connection or missing data problems, check Common Issues.

What's the difference between Ideas streams and Idea categories streams?

Ideas streams contain the actual ideas — titles, descriptions, statuses, votes, and so on. Idea categories streams contain only the category labels used to tag and organize those ideas. You'd typically use categories as a reference table to enrich your ideas data with human-readable category names.

For a full breakdown of all available fields per entity, see the Data Overview article.