Clearly AIDocs
Integrations

Aha! Roadmaps

Connect Clearly AI to Aha! Roadmaps.

Connect Aha! Roadmaps so Clearly AI can read ideas and roadmap features as Project sources, post comments, and receive Aha! activity events for Workflows.

Clearly AI acts as the Aha! user whose API key you configure. For example, if the key was generated by alex@example.com, comments created by Clearly AI appear as Alex.

Aha! comment authored by the credential owner

For shared or production use, ask an Aha! administrator to create a dedicated service account, such as Clearly AI bot, and generate the API key from that account. Aha! API keys inherit the permissions of the user that created them, so this keeps Clearly AI activity separate from individual employee accounts.

Create the Aha! API key

  1. In Aha!, click your user avatar and open Settings → Personal.
  2. Select Developer in the left sidebar.
  3. Click Generate API key.
  4. Enter a descriptive name, such as Clearly AI, and click Generate.
  5. Copy the key. Aha! shows it only once.

Aha! Developer settings with Generate API key

Aha! API key created

Connect Aha! in Clearly AI

  1. In Clearly AI, open Integrations and select Aha!.
  2. In Account subdomain, enter the hostname before .aha.io. For https://acme.aha.io, enter acme.
  3. In Personal Key, paste the Aha! API key.
  4. Save the configuration.

Clearly AI Aha! integration configuration

After saving, click Test. A successful test confirms Clearly AI can authenticate against https://{subdomain}.aha.io. If the test fails, the result should identify an invalid subdomain, an inactive key, or an account access problem.

Configure Aha! activity webhooks for Workflows

Configure an activity webhook if you want Aha! events, such as idea or feature changes, to trigger Clearly AI Workflows.

You need Aha! account administrator privileges with customization access to create an account-level activity webhook, or workspace owner access for a single workspace.

Generate the Clearly AI webhook URL

Aha! activity webhooks cannot send custom request headers, so Clearly AI embeds the webhook secret directly in the URL as a whs query parameter. Treat the full webhook URL as a secret.

  1. In the Clearly AI Aha! integration settings, expand the Webhook section.
  2. Click Generate secret.
  3. Click Save.
  4. Copy the Webhook URL. The displayed URL already includes the secret as ?whs=....

Aha! webhook configuration section

Use the full generated URL from Clearly AI when you configure Aha!. Do not remove the ?whs=... query parameter.

Create the activity webhook in Aha!

In Aha!, open Settings → Account → Integrations for an account-level webhook, or Settings → Workspace → Integrations for a single workspace.

  1. Select Activity webhook from the list of available integrations.
  2. In Hook URL, paste the Clearly AI webhook URL, including the ?whs=... portion.
  3. Add the record types that should trigger Workflows:
    • Idea for idea events.
    • Feature for roadmap feature events.
    • Optionally Comment to also receive comments posted on ideas and features.
  4. Enable Deliver immediately if events should bypass the default five-minute Aha! delay.
  5. Check Enable and save the integration.

Aha! activity webhook configuration

Clearly AI only acts on idea and feature audit events. Other record types are accepted by the endpoint but ignored. To confirm the setup, return to the Aha! integration in Clearly AI and use Validate your request configuration. A correct setup returns 200 OK. After validation succeeds, Aha! activity that matches your selected record types can trigger Clearly AI Workflows.

FAQs

Jira

Connect Clearly AI to Jira.

Azure DevOps Work Items

Connect Clearly AI to Azure DevOps Work Items.