The Webhook Management API from Ada — 5 operation(s) for webhook management.
Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/ada:ada-webhook-management-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
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: 3.2.0
info:
title: Knowledge Webhook Management API
version: 1.0.0
servers:
- url: https://example.ada.support/api
description: Production
tags:
- name: Webhook Management
paths:
/v2/webhooks/:
get:
operationId: list-webhooks
summary: List webhooks
description: List all webhook subscriptions configured for this AI Agent
tags:
- Webhook Management
parameters:
- name: limit
in: query
description: Maximum number of webhooks to return
required: false
schema:
type: integer
- name: cursor
in: query
description: Cursor for pagination
required: false
schema:
type: string
- name: Authorization
in: header
description: Bearer authentication
required: true
schema:
type: string
responses:
'200':
description: List of webhooks
content:
application/json:
schema:
$ref: '#/components/schemas/Webhook_Management_listWebhooks_Response_200'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'429':
description: Too Many Requests
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
post:
operationId: create-webhook
summary: Create a webhook
description: Create a new webhook subscription. If this is the first webhook for this AI Agent, the webhook infrastructure is automatically provisioned
tags:
- Webhook Management
parameters:
- name: Authorization
in: header
description: Bearer authentication
required: true
schema:
type: string
responses:
'201':
description: Webhook created
content:
application/json:
schema:
$ref: '#/components/schemas/Webhook'
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
requestBody:
content:
application/json:
schema:
type: object
properties:
url:
type: string
format: uri
description: The URL that will receive webhook events
description:
type: string
default: ''
description: A description of the webhook
event_filters:
type: array
items:
type: string
description: Event types to subscribe to. An empty list subscribes to all events
enabled:
type: boolean
default: true
description: Whether the webhook is enabled
required:
- url
/v2/webhooks/{id}:
get:
operationId: get-webhook
summary: Get a webhook
description: Get the details of a specific webhook subscription
tags:
- Webhook Management
parameters:
- name: id
in: path
description: The webhook ID
required: true
schema:
type: string
- name: Authorization
in: header
description: Bearer authentication
required: true
schema:
type: string
responses:
'200':
description: Webhook details
content:
application/json:
schema:
$ref: '#/components/schemas/Webhook'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
delete:
operationId: delete-webhook
summary: Delete a webhook
description: Delete a webhook subscription
tags:
- Webhook Management
parameters:
- name: id
in: path
description: The webhook ID
required: true
schema:
type: string
- name: Authorization
in: header
description: Bearer authentication
required: true
schema:
type: string
responses:
'204':
description: Webhook deleted
content:
application/json:
schema:
$ref: '#/components/schemas/Webhook_Management_deleteWebhook_Response_204'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
patch:
operationId: update-webhook
summary: Update a webhook
description: Update a webhook subscription. Only the fields provided in the request body will be updated
tags:
- Webhook Management
parameters:
- name: id
in: path
description: The webhook ID
required: true
schema:
type: string
- name: Authorization
in: header
description: Bearer authentication
required: true
schema:
type: string
responses:
'200':
description: Webhook updated
content:
application/json:
schema:
$ref: '#/components/schemas/Webhook'
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
requestBody:
content:
application/json:
schema:
type: object
properties:
url:
type: string
format: uri
description: The URL that will receive webhook events
description:
type: string
description: A description of the webhook
event_filters:
type: array
items:
type: string
description: Event types to subscribe to. An empty list subscribes to all events
enabled:
type: boolean
description: Whether the webhook is enabled
/v2/webhooks/{id}/secret/:
get:
operationId: get-webhook-secret
summary: Get webhook signing secret
description: Get the signing secret for a webhook. Use this secret to verify that incoming webhook payloads are authentic
tags:
- Webhook Management
parameters:
- name: id
in: path
description: The webhook ID
required: true
schema:
type: string
- name: Authorization
in: header
description: Bearer authentication
required: true
schema:
type: string
responses:
'200':
description: Webhook signing secret
content:
application/json:
schema:
$ref: '#/components/schemas/Webhook_Management_getWebhookSecret_Response_200'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
/v2/webhooks/{id}/secret/rotate/:
post:
operationId: rotate-webhook-secret
summary: Rotate webhook signing secret
description: Rotate the signing secret for a webhook. Optionally provide a custom key. The new secret is not returned in the response — use the get secret endpoint to retrieve it
tags:
- Webhook Management
parameters:
- name: id
in: path
description: The webhook ID
required: true
schema:
type: string
- name: Authorization
in: header
description: Bearer authentication
required: true
schema:
type: string
responses:
'200':
description: Signing secret rotated
content:
application/json:
schema:
$ref: '#/components/schemas/Webhook_Management_rotateWebhookSecret_Response_200'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
requestBody:
content:
application/json:
schema:
type: object
properties:
key:
type: string
description: An optional custom signing key. If not provided, a new key is generated automatically
/v2/webhooks/event-types/:
get:
operationId: list-webhook-event-types
summary: List webhook event types
description: List all available event types that webhooks can subscribe to
tags:
- Webhook Management
parameters:
- name: Authorization
in: header
description: Bearer authentication
required: true
schema:
type: string
responses:
'200':
description: List of event types
content:
application/json:
schema:
$ref: '#/components/schemas/Webhook_Management_listWebhookEventTypes_Response_200'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
components:
schemas:
V2WebhooksEventTypesGetResponsesContentApplicationJsonSchemaDataItems:
type: object
properties:
name:
type: string
description: The event type identifier
description:
type: string
description: Human-readable description of the event type
title: V2WebhooksEventTypesGetResponsesContentApplicationJsonSchemaDataItems
Webhook_Management_listWebhooks_Response_200:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Webhook'
meta:
$ref: '#/components/schemas/V2WebhooksGetResponsesContentApplicationJsonSchemaMeta'
title: Webhook Management_listWebhooks_Response_200
V2WebhooksGetResponsesContentApplicationJsonSchemaMeta:
type: object
properties:
next_page_url:
type:
- string
- 'null'
description: URL for the next page of results, or null if no pages remain
title: V2WebhooksGetResponsesContentApplicationJsonSchemaMeta
Errors:
type: object
properties:
errors:
type: array
items:
$ref: '#/components/schemas/ErrorsErrorsItems'
description: A list of errors
required:
- errors
title: Errors
ErrorsErrorsItems:
type: object
properties:
type:
type: string
description: The error type
message:
type: string
description: The error message
details:
type:
- string
- 'null'
description: Extra information about the error
required:
- type
- message
title: ErrorsErrorsItems
Webhook_Management_getWebhookSecret_Response_200:
type: object
properties:
key:
type: string
description: The webhook signing secret
title: Webhook Management_getWebhookSecret_Response_200
Webhook_Management_listWebhookEventTypes_Response_200:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/V2WebhooksEventTypesGetResponsesContentApplicationJsonSchemaDataItems'
title: Webhook Management_listWebhookEventTypes_Response_200
Webhook_Management_rotateWebhookSecret_Response_200:
type: object
properties: {}
title: Webhook Management_rotateWebhookSecret_Response_200
Webhook_Management_deleteWebhook_Response_204:
type: object
properties: {}
description: Empty response body
title: Webhook Management_deleteWebhook_Response_204
Webhook:
type: object
properties:
id:
type: string
description: The webhook ID
url:
type: string
format: uri
description: The URL that will receive webhook events
description:
type: string
description: A description of the webhook
event_filters:
type: array
items:
type: string
description: Event types this webhook is subscribed to. If empty, the webhook receives all events
enabled:
type: boolean
description: Whether the webhook is enabled
created_at:
type: string
format: date-time
description: When the webhook was created
updated_at:
type: string
format: date-time
description: When the webhook was last updated
title: Webhook
securitySchemes:
BearerAuth:
type: http
scheme: bearer