Aha!
What’s Supported
Supported Actions
This connector supports:
- Read Actions, including full historic backfill. Please note that incremental read is supported only for
audits
,historical_audits
,ideas/endorsements
andideas
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
The Aha! connector supports writing to and reading from the following 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
To integrate Aha! with Ampersand, you need to Create an Aha! Account and obtain the following credentials from your Aha! App:
- Client ID
- Client Secret
You will then use these credentials to connect your application to Ampersand.
Create an Aha! Account
You need an Aha! account to connect with Ampersand. If you do not have an Aha! account, here’s how you can sign up:
- 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
Once your Aha! account is ready, you need to create an Aha! application. Learn more about creating an Aha! application here.
-
Log in to Your Aha! Account.
-
Click the gear icon in the top-right corner and then click Personal.
-
On the Personal settings page, click Developer.
-
Click the OAuth applications tab.
-
Click Register OAuth application.
-
On the Register new OAuth application form, enter the Oauth application Name and the Ampersand Redirect URI:
https://api.withampersand.com/callbacks/v1/oauth
-
Click Create.
The OAuth applications tab shows Client ID and Client Secret keys.
Add Aha! App Details in Ampersand
-
Log in to your Ampersand Dashboard.
-
Select the project where you want to add the Aha! App.
-
Navigate to the Provider Apps section.
-
Select Aha! from the Provider list.
-
Enter the previously obtained Client ID / Application ID in the Client ID field and the Client Secret in the Client Secret field.
- Click Save Changes
Using the connector
To start integrating with Aha!:
- 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.