Aha!

​

What’s Supported

​

Supported Actions

• Read Actions, including full historic backfill. Please note that incremental read is supported only for audits, historical_audits, ideas/endorsements and ideas currently. For all other objects, a full read of the Aha! instance will be done per scheduled read.
• Write Actions.
• Proxy Actions, using the base URL https://{{.workspace}}.aha.io/api.

​

Supported Objects

• audits (incremental read)
• capacity_scenarios (read)
• screen_definitions (read)
• custom_field_definitions (read)
• epics (read)
• features (read)
• goals (read)
• historical_audits (incremental read, write)
• idea_portals (read)
• idea_organizations (read, write)
• idea_users (read, write)
• ideas (incremental read)
• ideas/endorsements (incremental read)
• identity_providers (read)
• initiatives (read)
• integrations (read, write)
• me/tasks (read)
• me/assigned (read)
• paid_seat_groups (read)
• products (read, write)
• release_phases (read, write)
• schedules (read)
• strategy_models (read)
• strategy_positions (read)
• strategy_visions (read)
• team_members (read write)
• teams (read)
• tasks (read, write)
• users (read)

​

Before You Get Started

• Client ID
• Client Secret

​

Create an Aha! Account

• Go to the Aha! site and sign up for a free account.
• Sign up using your preferred account.
• Verify your email and complete the registration process.

​

Creating an Aha! App

1. Log in to Your Aha! Account.
2. Click the gear icon in the top-right corner and then click Personal.
3. On the Personal settings page, click Developer.

4. Click the OAuth applications tab.
5. Click Register OAuth application.
6. On the Register new OAuth application form, enter the Oauth application Name and the Ampersand Redirect URI: https://api.withampersand.com/callbacks/v1/oauth
7. Click Create.

​

Add Aha! App Details in Ampersand

1. Log in to your Ampersand Dashboard.
2. Select the project where you want to add the Aha! App.
3. Navigate to the Provider Apps section.
4. Select Aha! from the Provider list.
5. Enter the previously obtained Client ID / Application ID in the Client ID field and the Client Secret in the Client Secret field.

6. Click Save Changes

​

Using the connector

• Create a manifest file like the example.
• Deploy it using the amp CLI.
• If you are using Read Actions, create a destination.
• Embed the InstallIntegration UI component.
• Start using the connector!
  • If your integration has Read Actions, you’ll start getting webhook messages.
  • If your integration has Write Actions, you can start making API calls to our Write API.
  • If your integration has Proxy Actions, you can start making Proxy API calls.