APIContext Hooks API
Manage inbound hooks: workflow triggers that run when their public URL receives a request.
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/apicontext:apicontext-hooks-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: APImetrics Hooks API
description: API for the APImetrics platform
termsOfService: http://apimetrics.io/tos/
contact:
name: APIContext Support
url: https://apicontext.io/
email: support@apicontext.com
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
version: v2026-09-02
tags:
- name: Hooks
description: 'Manage inbound hooks: workflow triggers that run when their public URL receives a request.'
paths:
/api/2/hooks/:
get:
tags:
- Hooks
summary: List-Hooks
description: List hooks for the project, newest first.
operationId: list-hooks
security:
- OAuth2: []
- ApiKey: []
parameters:
- name: cursor
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Cursor
- name: limit
in: query
required: false
schema:
type: integer
maximum: 500
minimum: 1
default: 100
title: Limit
- name: apimetrics-project-id
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Apimetrics-Project-Id
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/HookListResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
put:
tags:
- Hooks
summary: Create-Hook
description: Create a hook bound to a workflow target.
operationId: create-hook
security:
- OAuth2: []
- ApiKey: []
parameters:
- name: apimetrics-project-id
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Apimetrics-Project-Id
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/CreateHookRequest'
responses:
'201':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/HookResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/2/hooks/{hook_key_str}:
get:
tags:
- Hooks
summary: Get-Hook
description: Get a hook.
operationId: get-hook
security:
- OAuth2: []
- ApiKey: []
parameters:
- name: hook_key_str
in: path
required: true
schema:
type: string
pattern: ^[A-Za-z0-9_-]+$
title: Hook ID
- name: apimetrics-project-id
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Apimetrics-Project-Id
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/HookResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
post:
tags:
- Hooks
summary: Update-Hook
description: Partially update a hook.
operationId: update-hook
security:
- OAuth2: []
- ApiKey: []
parameters:
- name: hook_key_str
in: path
required: true
schema:
type: string
pattern: ^[A-Za-z0-9_-]+$
title: Hook ID
- name: apimetrics-project-id
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Apimetrics-Project-Id
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateHookRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/HookResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
delete:
tags:
- Hooks
summary: Delete-Hook
description: Delete a hook, returning the deleted representation.
operationId: delete-hook
security:
- OAuth2: []
- ApiKey: []
parameters:
- name: hook_key_str
in: path
required: true
schema:
type: string
pattern: ^[A-Za-z0-9_-]+$
title: Hook ID
- name: apimetrics-project-id
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Apimetrics-Project-Id
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/HookResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
input:
title: Input
ctx:
type: object
title: Context
type: object
required:
- loc
- msg
- type
title: ValidationError
CreateHookRequest:
properties:
name:
anyOf:
- type: string
maxLength: 400
- type: 'null'
title: Name
description:
anyOf:
- type: string
maxLength: 1000
- type: 'null'
title: Description
tags:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Tags
save_timestamp:
anyOf:
- type: boolean
- type: 'null'
title: Save Timestamp
variables:
anyOf:
- additionalProperties:
type: string
type: object
- type: 'null'
title: Variables
target_id:
type: string
title: Target Id
additionalProperties: false
type: object
required:
- target_id
title: CreateHookRequest
HookListResponse:
properties:
meta:
$ref: '#/components/schemas/HookListMeta'
results:
items:
$ref: '#/components/schemas/HookResponse'
type: array
title: Results
type: object
required:
- meta
- results
title: HookListResponse
UpdateHookRequest:
properties:
name:
anyOf:
- type: string
maxLength: 400
- type: 'null'
title: Name
description:
anyOf:
- type: string
maxLength: 1000
- type: 'null'
title: Description
tags:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Tags
save_timestamp:
anyOf:
- type: boolean
- type: 'null'
title: Save Timestamp
variables:
anyOf:
- additionalProperties:
type: string
type: object
- type: 'null'
title: Variables
additionalProperties: false
type: object
title: UpdateHookRequest
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
HookListMeta:
properties:
next_cursor:
anyOf:
- type: string
- type: 'null'
title: Next Cursor
more:
type: boolean
title: More
default: false
project_id:
anyOf:
- type: string
- type: 'null'
title: Project Id
type: object
title: HookListMeta
HookResponse:
properties:
id:
type: string
title: Id
guid:
type: string
title: Guid
url:
type: string
title: Url
target_id:
type: string
title: Target Id
name:
anyOf:
- type: string
- type: 'null'
title: Name
description:
anyOf:
- type: string
- type: 'null'
title: Description
tags:
items:
type: string
type: array
title: Tags
save_timestamp:
type: boolean
title: Save Timestamp
default: false
variables:
additionalProperties:
type: string
type: object
title: Variables
project_id:
type: string
title: Project Id
created:
anyOf:
- type: string
format: date-time
- type: 'null'
title: Created
last_update:
anyOf:
- type: string
format: date-time
- type: 'null'
title: Last Update
type: object
required:
- id
- guid
- url
- target_id
- project_id
title: HookResponse
securitySchemes:
OAuth2:
type: oauth2
flows:
authorizationCode:
scopes:
openid: OpenID Connect identity
profile: User profile
email: User email address
authorizationUrl: https://auth.apimetrics.io/authorize?audience=https://client.apimetrics.io
tokenUrl: https://auth.apimetrics.io/oauth/token
ApiKey:
type: apiKey
in: header
name: X-Api-Key
x-provenance:
method: harvested
publisher: APIContext
source: https://client.apimetrics.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)