Webhooks API

Webhooks allow Aha! to receive real-time updates from integrated development tools and services. When configured properly, external systems can send webhook notifications to Aha! whenever relevant events occur (like issue updates, code commits, or task status changes).

Authentication: Webhooks use callback tokens instead of standard API authentication. Each integration has a unique callback token that must be included in webhook requests.

Supported Integrations: Aha! supports webhooks from many popular development tools including:

• Jira - Issue and project updates
• GitHub - Issue, pull request, and commit events
• Rally - Work item and project updates
• Asana - Task and project notifications
• Salesforce - Opportunity and case updates
• Smartsheet - Sheet and row changes
• Trello - Card and board updates

Setup Requirements:

1. Integration must be properly configured and enabled
2. Callback token must be valid and active
3. Account must be in good standing (not disabled/suspended)
4. Webhook payload must match the expected format for the integration type

Error Handling: Webhook endpoints return appropriate HTTP status codes:

• 200 OK - Webhook processed successfully
• 410 Gone - Invalid token or disabled account
• 500 Error - Processing error (automatically retried by most systems)

Handle Asana resthook confirmation

POST /api/v1/webhooks/:token

Asana and other services implementing the Resthooks specification send a confirmation request with an X-Hook-Secret header when setting up webhooks. Aha! responds with the same secret to confirm the webhook endpoint is valid.

Example request

POST /api/v1/webhooks/22b7893e7fa1c4c60847090f78fbf0ec

Example CURL command

curl "https://company.aha.io/api/v1/webhooks/22b7893e7fa1c4c60847090f78fbf0ec" -d '' -X POST \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Hook-Secret: confirmation-secret-123"

Request

contentType: application/json
accept: application/json

Response

Status: 200 OK
contentType: application/json