Aha.io Integrations API
The Integrations API from Aha.io — 4 operation(s) for integrations.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/aha:aha-integrations-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Aha! Integrations API
version: 1.0.0
description: Complete API documentation for Aha! generated from actual test responses
contact:
name: Aha! Support
url: https://www.aha.io/support
servers:
- url: https://{account-domain}.aha.io/api/v1
description: Aha! API Server
variables:
account-domain:
description: Your Aha! account domain
default: company
security:
- OAuth2: []
- ApiKeyAuth: []
- CookieAuth: []
tags:
- name: Integrations
paths:
/integrations:
get:
summary: List integrations for an account
description: null
tags:
- Integrations
parameters:
- name: page
in: query
required: false
schema:
type: string
example: '1'
- name: per_page
in: query
required: false
schema:
type: string
example: '30'
responses:
'200':
description: Successful operation
headers:
Content-Type:
description: application/json; charset=utf-8
schema:
type: string
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/IntegrationsGetResponse'
example:
integrations:
- id: '79015308'
service_name: salesforce
name: Salesforce
created_at: '2019-01-01T00:00:00.000Z'
- id: '84619270'
service_name: salesforce
name: Salesforce V2
created_at: '2019-01-01T00:00:00.000Z'
- id: '163322775'
service_name: audit_webhook
name: Activity webhook
created_at: '2019-01-01T00:00:00.000Z'
- id: '241856910'
service_name: trello
name: Trello
created_at: '2019-01-01T00:00:00.000Z'
- id: '390243673'
service_name: zendesk
name: Zendesk
created_at: '2019-01-01T00:00:00.000Z'
- id: '494508339'
service_name: hubspot
name: HubSpot
created_at: '2019-01-01T00:00:00.000Z'
- id: '578818383'
service_name: slack
name: Aha! (to Slack)
created_at: '2019-01-01T00:00:00.000Z'
- id: '828392279'
service_name: security_webhook
name: Security webhook
created_at: '2019-01-01T00:00:00.000Z'
- id: '922472543'
service_name: slack_commands
name: Aha! (from Slack)
created_at: '2019-01-01T00:00:00.000Z'
- id: '938531265'
service_name: slack_commands
name: Aha! (from Slack)
created_at: '2019-01-01T00:00:00.000Z'
pagination:
total_records: 10
total_pages: 1
current_page: 1
security:
- OAuth2: []
- ApiKeyAuth: []
- CookieAuth: []
operationId: getIntegrations
x-operation-id-source: derived
post:
summary: Create an integration for an account
description: null
tags:
- Integrations
parameters: []
responses:
'200':
description: Successful operation
headers:
Content-Type:
description: application/json; charset=utf-8
schema:
type: string
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/IntegrationsPostResponse'
example:
integration:
id: '6776881149498164474'
service_name: zendesk
name: Zendesk
created_at: '2019-01-01T00:00:00.000Z'
template_id: null
enabled: true
callback_token: 5e0c51800087c7f9
updated_at: '2019-01-01T00:00:00.000Z'
last_error_at: null
last_webhook_request_at: null
url: https://company.aha.io/integrations/6776881149498164474
resource: https://company.aha.io/api/v1/integrations/6776881149498164474
owner:
type: Account
id: '303742481'
url: https://company.aha.io/account/303742481
resource: https://company.aha.io/account/303742481
security:
- OAuth2: []
- ApiKeyAuth: []
- CookieAuth: []
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/IntegrationsPostRequest'
example:
integration:
service_name: zendesk
enabled: true
operationId: postIntegrations
x-operation-id-source: derived
/products/{product_id}/integrations:
get:
summary: List integrations for a product
description: null
tags:
- Integrations
parameters:
- name: product_id
in: path
required: true
schema:
type: string
description: ProductId identifier
- name: page
in: query
required: false
schema:
type: string
example: '1'
- name: per_page
in: query
required: false
schema:
type: string
example: '30'
responses:
'200':
description: Successful operation
headers:
Content-Type:
description: application/json; charset=utf-8
schema:
type: string
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/IntegrationsGetResponse'
example:
integrations:
- id: '31907509'
service_name: rally
name: Rally
created_at: '2019-01-01T00:00:00.000Z'
- id: '36231792'
service_name: github_issues
name: GitHub Issues
created_at: '2019-01-01T00:00:00.000Z'
- id: '186281709'
service_name: jira
name: Jira
created_at: '2019-01-01T00:00:00.000Z'
- id: '202598724'
service_name: jira_connect
name: Jira via Connect
created_at: '2019-01-01T00:00:00.000Z'
- id: '204584239'
service_name: jira
name: Jira
created_at: '2019-01-01T00:00:00.000Z'
- id: '207648948'
service_name: jira
name: Jira
created_at: '2019-01-01T00:00:00.000Z'
- id: '222276392'
service_name: jira
name: Jira
created_at: '2019-01-01T00:00:00.000Z'
- id: '322044925'
service_name: jira
name: Jira
created_at: '2019-01-01T00:00:00.000Z'
- id: '342659513'
service_name: jira
name: Jira
created_at: '2019-01-01T00:00:00.000Z'
- id: '386928799'
service_name: vsts
name: Azure DevOps Services
created_at: '2019-01-01T00:00:00.000Z'
- id: '413207847'
service_name: jira
name: Jira
created_at: '2019-01-01T00:00:00.000Z'
- id: '453754848'
service_name: jira
name: Jira
created_at: '2019-01-01T00:00:00.000Z'
- id: '503406710'
service_name: github_app
name: GitHub App
created_at: '2019-01-01T00:00:00.000Z'
- id: '550349479'
service_name: jira_connect
name: Jira via Connect
created_at: '2019-01-01T00:00:00.000Z'
- id: '583937884'
service_name: jira
name: Jira template (visible to all)
created_at: '2019-01-01T00:00:00.000Z'
- id: '706216981'
service_name: rally
name: Rally
created_at: '2019-01-01T00:00:00.000Z'
- id: '791044582'
service_name: vsts
name: Azure DevOps Services
created_at: '2019-01-01T00:00:00.000Z'
- id: '804274302'
service_name: jira
name: Jira V2 Disabled
created_at: '2019-01-01T00:00:00.000Z'
- id: '846899991'
service_name: tfs
name: Azure DevOps Services
created_at: '2019-01-01T00:00:00.000Z'
- id: '868040294'
service_name: rally
name: Rally
created_at: '2019-01-01T00:00:00.000Z'
- id: '945767377'
service_name: trello
name: Trello
created_at: '2019-01-01T00:00:00.000Z'
- id: '952935179'
service_name: jira
name: Jira
created_at: '2019-01-01T00:00:00.000Z'
pagination:
total_records: 22
total_pages: 1
current_page: 1
security:
- OAuth2: []
- ApiKeyAuth: []
- CookieAuth: []
operationId: getProductsByProductIdIntegrations
x-operation-id-source: derived
post:
summary: Create an integration based on a template for a product
description: null
tags:
- Integrations
parameters:
- name: product_id
in: path
required: true
schema:
type: string
description: ProductId identifier
responses:
'200':
description: Successful operation
headers:
Content-Type:
description: application/json; charset=utf-8
schema:
type: string
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/IntegrationsPostResponse'
example:
integration:
id: '6776881149495993093'
service_name: zendesk
name: Zendesk
created_at: '2019-01-01T00:00:00.000Z'
template_id: null
enabled: true
callback_token: 5e0c518000f2be23
updated_at: '2019-01-01T00:00:00.000Z'
last_error_at: null
last_webhook_request_at: null
url: https://company.aha.io/integrations/6776881149495993093
resource: https://company.aha.io/api/v1/integrations/6776881149495993093
owner:
type: Project
id: '131414752'
url: https://company.aha.io/projects/PRJ1
resource: https://company.aha.io/projects/PRJ1
security:
- OAuth2: []
- ApiKeyAuth: []
- CookieAuth: []
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/IntegrationsPostRequest'
example:
integration:
service_name: jira
enabled: true
template_id: 204584239
operationId: postProductsByProductIdIntegrations
x-operation-id-source: derived
/products/{product_id}/integrations/{integration_id}:
get:
summary: Get a specific integration
description: null
tags:
- Integrations
parameters:
- name: product_id
in: path
required: true
schema:
type: string
description: ProductId identifier
- name: integration_id
in: path
required: true
schema:
type: string
description: IntegrationId identifier
responses:
'200':
description: Successful operation
headers:
Content-Type:
description: application/json; charset=utf-8
schema:
type: string
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/IntegrationsGetResponse'
example:
integration:
id: '204584239'
service_name: jira
name: Jira
created_at: '2019-01-01T00:00:00.000Z'
template_id: null
enabled: true
callback_token: 22b7893e7fa1c4c60847090f78fbf0ec
updated_at: '2019-01-01T00:00:00.000Z'
last_error_at: null
last_webhook_request_at: null
url: https://company.aha.io/integrations/204584239
resource: https://company.aha.io/api/v1/integrations/204584239
jql_filter: null
owner:
type: Project
id: '131414752'
url: https://company.aha.io/projects/PRJ1
resource: https://company.aha.io/projects/PRJ1
security:
- OAuth2: []
- ApiKeyAuth: []
- CookieAuth: []
operationId: getProductsByProductIdIntegrationsByIntegrationId
x-operation-id-source: derived
put:
summary: Enable integration
description: null
tags:
- Integrations
parameters:
- name: product_id
in: path
required: true
schema:
type: string
description: ProductId identifier
- name: integration_id
in: path
required: true
schema:
type: string
description: IntegrationId identifier
responses:
'200':
description: Successful operation
headers:
Content-Type:
description: application/json; charset=utf-8
schema:
type: string
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/IntegrationsPutResponse'
example:
integration:
id: '204584239'
service_name: jira
name: Jira
created_at: '2019-01-01T00:00:00.000Z'
template_id: null
enabled: true
callback_token: 22b7893e7fa1c4c60847090f78fbf0ec
updated_at: '2019-01-01T00:00:00.000Z'
last_error_at: null
last_webhook_request_at: null
url: https://company.aha.io/integrations/204584239
resource: https://company.aha.io/api/v1/integrations/204584239
jql_filter: null
owner:
type: Project
id: '131414752'
url: https://company.aha.io/projects/PRJ1
resource: https://company.aha.io/projects/PRJ1
security:
- OAuth2: []
- ApiKeyAuth: []
- CookieAuth: []
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/IntegrationsPostRequest'
example:
integration:
enabled: true
operationId: putProductsByProductIdIntegrationsByIntegrationId
x-operation-id-source: derived
/products/{product_id}/integrations/{service_name}:
get:
summary: Get a specific integration by service name
description: 'DEPRECATED: provide :integration_id rather than :service_name to identify the integration.'
tags:
- Integrations
parameters:
- name: product_id
in: path
required: true
schema:
type: string
description: ProductId identifier
- name: service_name
in: path
required: true
schema:
type: string
description: ServiceName identifier
responses:
'200':
description: Successful operation
headers:
Content-Type:
description: application/json; charset=utf-8
schema:
type: string
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/IntegrationsGetResponse'
example:
integration:
id: '204584239'
service_name: jira
name: Jira
created_at: '2019-01-01T00:00:00.000Z'
template_id: null
enabled: true
callback_token: 22b7893e7fa1c4c60847090f78fbf0ec
updated_at: '2019-01-01T00:00:00.000Z'
last_error_at: null
last_webhook_request_at: null
url: https://company.aha.io/integrations/204584239
resource: https://company.aha.io/api/v1/integrations/204584239
jql_filter: null
owner:
type: Project
id: '131414752'
url: https://company.aha.io/projects/PRJ1
resource: https://company.aha.io/projects/PRJ1
security:
- OAuth2: []
- ApiKeyAuth: []
- CookieAuth: []
operationId: getProductsByProductIdIntegrationsByServiceName
x-operation-id-source: derived
components:
schemas:
IntegrationsPutResponse:
type: object
properties:
integration:
type: object
properties:
id:
type: string
example: '204584239'
service_name:
type: string
example: jira
name:
type: string
example: Jira
created_at:
type: string
example: '2019-01-01T00:00:00.000Z'
template_id:
type: 'null'
enabled:
type: boolean
example: true
callback_token:
type: string
example: 22b7893e7fa1c4c60847090f78fbf0ec
updated_at:
type: string
example: '2019-01-01T00:00:00.000Z'
last_error_at:
type: 'null'
last_webhook_request_at:
type: 'null'
url:
type: string
example: https://company.aha.io/integrations/204584239
resource:
type: string
example: https://company.aha.io/api/v1/integrations/204584239
jql_filter:
type: 'null'
owner:
type: object
properties:
type:
type: string
example: Project
id:
type: string
example: '131414752'
url:
type: string
example: https://company.aha.io/projects/PRJ1
resource:
type: string
example: https://company.aha.io/projects/PRJ1
example:
type: Project
id: '131414752'
url: https://company.aha.io/projects/PRJ1
resource: https://company.aha.io/projects/PRJ1
example:
id: '204584239'
service_name: jira
name: Jira
created_at: '2019-01-01T00:00:00.000Z'
template_id: null
enabled: true
callback_token: 22b7893e7fa1c4c60847090f78fbf0ec
updated_at: '2019-01-01T00:00:00.000Z'
last_error_at: null
last_webhook_request_at: null
url: https://company.aha.io/integrations/204584239
resource: https://company.aha.io/api/v1/integrations/204584239
jql_filter: null
owner:
type: Project
id: '131414752'
url: https://company.aha.io/projects/PRJ1
resource: https://company.aha.io/projects/PRJ1
example:
integration:
id: '204584239'
service_name: jira
name: Jira
created_at: '2019-01-01T00:00:00.000Z'
template_id: null
enabled: true
callback_token: 22b7893e7fa1c4c60847090f78fbf0ec
updated_at: '2019-01-01T00:00:00.000Z'
last_error_at: null
last_webhook_request_at: null
url: https://company.aha.io/integrations/204584239
resource: https://company.aha.io/api/v1/integrations/204584239
jql_filter: null
owner:
type: Project
id: '131414752'
url: https://company.aha.io/projects/PRJ1
resource: https://company.aha.io/projects/PRJ1
IntegrationsPostResponse:
type: object
properties:
integration:
type: object
properties:
id:
type: string
example: '6776881149495993093'
service_name:
type: string
example: zendesk
name:
type: string
example: Zendesk
created_at:
type: string
example: '2019-01-01T00:00:00.000Z'
template_id:
type: 'null'
enabled:
type: boolean
example: true
callback_token:
type: string
example: 5e0c518000f2be23
updated_at:
type: string
example: '2019-01-01T00:00:00.000Z'
last_error_at:
type: 'null'
last_webhook_request_at:
type: 'null'
url:
type: string
example: https://company.aha.io/integrations/6776881149495993093
resource:
type: string
example: https://company.aha.io/api/v1/integrations/6776881149495993093
owner:
type: object
properties:
type:
type: string
example: Project
id:
type: string
example: '131414752'
url:
type: string
example: https://company.aha.io/projects/PRJ1
resource:
type: string
example: https://company.aha.io/projects/PRJ1
example:
type: Project
id: '131414752'
url: https://company.aha.io/projects/PRJ1
resource: https://company.aha.io/projects/PRJ1
example:
id: '6776881149495993093'
service_name: zendesk
name: Zendesk
created_at: '2019-01-01T00:00:00.000Z'
template_id: null
enabled: true
callback_token: 5e0c518000f2be23
updated_at: '2019-01-01T00:00:00.000Z'
last_error_at: null
last_webhook_request_at: null
url: https://company.aha.io/integrations/6776881149495993093
resource: https://company.aha.io/api/v1/integrations/6776881149495993093
owner:
type: Project
id: '131414752'
url: https://company.aha.io/projects/PRJ1
resource: https://company.aha.io/projects/PRJ1
example:
integration:
id: '6776881149495993093'
service_name: zendesk
name: Zendesk
created_at: '2019-01-01T00:00:00.000Z'
template_id: null
enabled: true
callback_token: 5e0c518000f2be23
updated_at: '2019-01-01T00:00:00.000Z'
last_error_at: null
last_webhook_request_at: null
url: https://company.aha.io/integrations/6776881149495993093
resource: https://company.aha.io/api/v1/integrations/6776881149495993093
owner:
type: Project
id: '131414752'
url: https://company.aha.io/projects/PRJ1
resource: https://company.aha.io/projects/PRJ1
IntegrationsGetResponse:
type: object
properties:
integration:
type: object
properties:
id:
type: string
example: '204584239'
service_name:
type: string
example: jira
name:
type: string
example: Jira
created_at:
type: string
example: '2019-01-01T00:00:00.000Z'
template_id:
type: 'null'
enabled:
type: boolean
example: true
callback_token:
type: string
example: 22b7893e7fa1c4c60847090f78fbf0ec
updated_at:
type: string
example: '2019-01-01T00:00:00.000Z'
last_error_at:
type: 'null'
last_webhook_request_at:
type: 'null'
url:
type: string
example: https://company.aha.io/integrations/204584239
resource:
type: string
example: https://company.aha.io/api/v1/integrations/204584239
jql_filter:
type: 'null'
owner:
type: object
properties:
type:
type: string
example: Project
id:
type: string
example: '131414752'
url:
type: string
example: https://company.aha.io/projects/PRJ1
resource:
type: string
example: https://company.aha.io/projects/PRJ1
example:
type: Project
id: '131414752'
url: https://company.aha.io/projects/PRJ1
resource: https://company.aha.io/projects/PRJ1
example:
id: '204584239'
service_name: jira
name: Jira
created_at: '2019-01-01T00:00:00.000Z'
template_id: null
enabled: true
callback_token: 22b7893e7fa1c4c60847090f78fbf0ec
updated_at: '2019-01-01T00:00:00.000Z'
last_error_at: null
last_webhook_request_at: null
url: https://company.aha.io/integrations/204584239
resource: https://company.aha.io/api/v1/integrations/204584239
jql_filter: null
owner:
type: Project
id: '131414752'
url: https://company.aha.io/projects/PRJ1
resource: https://company.aha.io/projects/PRJ1
example:
integration:
id: '204584239'
service_name: jira
name: Jira
created_at: '2019-01-01T00:00:00.000Z'
template_id: null
enabled: true
callback_token: 22b7893e7fa1c4c60847090f78fbf0ec
updated_at: '2019-01-01T00:00:00.000Z'
last_error_at: null
last_webhook_request_at: null
url: https://company.aha.io/integrations/204584239
resource: https://company.aha.io/api/v1/integrations/204584239
jql_filter: null
owner:
type: Project
id: '131414752'
url: https://company.aha.io/projects/PRJ1
resource: https://company.aha.io/projects/PRJ1
IntegrationsPostRequest:
type: object
properties:
integration:
type: object
properties:
enabled:
type: boolean
example: true
example:
enabled: true
example:
integration:
enabled: true
securitySchemes:
OAuth2:
type: oauth2
description: OAuth2 authentication with bearer tokens
flows:
authorizationCode:
authorizationUrl: https://{account-domain}.aha.io/oauth/authorize
tokenUrl: https://{account-domain}.aha.io/oauth/token
scopes: {}
ApiKeyAuth:
type: http
scheme: bearer
description: API key authentication using Bearer token in Authorization header. Generate API keys at https://secure.aha.io/settings/api_keys
CookieAuth:
type: apiKey
in: cookie
name: session
description: Cookie-based authentication for web browser integration
x-provenance:
method: harvested
publisher: Aha.io
source: https://www.aha.io/openapi.json
note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
stamped by stamp-openapi-provenance.py (roadmap#793)