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)

Process GitHub Enterprise string payload

POST /api/v1/webhooks/:token

Some older GitHub Enterprise versions send webhook payload as a JSON string in the 'payload' parameter instead of a parsed object. This is handled by automatically parsing the JSON string.

Typical GitHub Enterprise string payload format:

• payload: '{"action":"edited","issue":{"id":1777079849,"number":150},"repository":{"id":987654321}}'
• Content-Type: application/x-www-form-urlencoded

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" \
	-H "Smartsheet-Hook-Challenge: smartsheet-challenge-456"

Request

contentType: application/json
accept: application/json

Response

Status: 200 OK
contentType: application/json