Webhooks allow you to create your own Aha! integration. This allows you to extend, customize, and integrate Aha! with your own custom extensions or other third-party applications.
Before starting this process, though, you may want to search through our list of existing Aha! integrations. If we already integrate with the tool you use, you can find detailed articles for setting up and troubleshooting it here.
If do create your own Aha! integration, it will make an HTTP POST to a URL you specify. The integration will affect Aha! features and releases, and you will see it as an option under the Send dropdown on those records.
Example webhook documentation
You should configure your fixtures to fit your needs. We have a few examples here:
- Create a feature
- Create a feature with an assignee
- Update a feature
- Create a release
- Update a release
Configure the integration
To configure a webhook integration, follow these steps:
Navigate to Settings ⚙️> Workspace and then click the + icon next to Integrations in the left navigation bar.
Choose Integrations webhook.
Enter the URL in the Hook URL field.
Enter a name in the Integration name field and then check Enable.
Note: You should name your integration with a unique identifier based on the configuration settings you make — especially if you plan to have multiple integration webhooks for a single Aha! product.
Test the integration
Test the integration by sending a feature to your webhook by following these steps:
Navigate to Features > Board.
Click on a feature card and select Send > Send to [your integration name] in the Integrations drop-down.
Use REST API
You can also create your own connectors through our REST API.