bldinit Webhooks API
The webhooks API from bldinit — 7 operation(s) for webhooks.
The webhooks API from bldinit — 7 operation(s) for webhooks.
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/mcpweave-com:mcpweave-com-webhooks-api"
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.
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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. 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: mcpweave Webhooks API
description: Asia-native MCP Gateway — Native pass-through, FastMCP, Paddle+Toss billing
version: '2026-04-27'
tags:
- name: Webhooks
paths:
/api/v1/webhooks/{provider}:
post:
tags:
- Webhooks
summary: Receive Provider Webhook
operationId: receive_provider_webhook_api_v1_webhooks__provider__post
parameters:
- name: provider
in: path
required: true
schema:
type: string
title: Provider
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Receive Provider Webhook Api V1 Webhooks Provider Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/webhooks/{provider}/{tenant}:
post:
tags:
- Webhooks
summary: Receive Provider Webhook With Tenant
description: 'Tenant-suffix variant — used by providers that don''t carry a merchant
identifier in the body (Toss, Naver). The verifier picks up the suffix
via the synthetic ``X-Mcpweave-Tenant-Hint`` header.'
operationId: receive_provider_webhook_with_tenant_api_v1_webhooks__provider___tenant__post
parameters:
- name: provider
in: path
required: true
schema:
type: string
title: Provider
- name: tenant
in: path
required: true
schema:
type: string
title: Tenant
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Receive Provider Webhook With Tenant Api V1 Webhooks Provider Tenant Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/webhook-subscriptions:
post:
tags:
- Webhooks
summary: Create Subscription
operationId: create_subscription_api_v1_webhook_subscriptions_post
parameters:
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/WebhookSubscriptionCreate'
responses:
'201':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/WebhookSubscriptionCreateResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
get:
tags:
- Webhooks
summary: List Subscriptions
operationId: list_subscriptions_api_v1_webhook_subscriptions_get
parameters:
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/WebhookSubscriptionRead'
title: Response List Subscriptions Api V1 Webhook Subscriptions Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/webhook-subscriptions/{subscription_id}:
get:
tags:
- Webhooks
summary: Get Subscription
operationId: get_subscription_api_v1_webhook_subscriptions__subscription_id__get
parameters:
- name: subscription_id
in: path
required: true
schema:
type: string
format: uuid
title: Subscription Id
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/WebhookSubscriptionRead'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
delete:
tags:
- Webhooks
summary: Delete Subscription
operationId: delete_subscription_api_v1_webhook_subscriptions__subscription_id__delete
parameters:
- name: subscription_id
in: path
required: true
schema:
type: string
format: uuid
title: Subscription Id
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
responses:
'204':
description: Successful Response
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/admin/webhooks:
get:
tags:
- Webhooks
summary: Webhooks Dashboard
operationId: webhooks_dashboard_admin_webhooks_get
parameters:
- name: events_page
in: query
required: false
schema:
type: integer
default: 1
title: Events Page
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
responses:
'200':
description: Successful Response
content:
text/html:
schema:
type: string
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/admin/webhooks/subscriptions:
post:
tags:
- Webhooks
summary: Add Subscription
operationId: add_subscription_admin_webhooks_subscriptions_post
parameters:
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
requestBody:
content:
application/x-www-form-urlencoded:
schema:
$ref: '#/components/schemas/Body_add_subscription_admin_webhooks_subscriptions_post'
responses:
'200':
description: Successful Response
content:
text/html:
schema:
type: string
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/admin/webhooks/subscriptions/{subscription_id}/delete:
post:
tags:
- Webhooks
summary: Delete Subscription Form
operationId: delete_subscription_form_admin_webhooks_subscriptions__subscription_id__delete_post
parameters:
- name: subscription_id
in: path
required: true
schema:
type: string
format: uuid
title: Subscription Id
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
responses:
'200':
description: Successful Response
content:
text/html:
schema:
type: string
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
WebhookSubscriptionCreateResponse:
properties:
id:
type: string
format: uuid
title: Id
url:
type: string
title: Url
events:
items:
type: string
type: array
title: Events
description:
anyOf:
- type: string
- type: 'null'
title: Description
is_active:
type: boolean
title: Is Active
last_delivery_at:
anyOf:
- type: string
- type: 'null'
title: Last Delivery At
consecutive_failures:
type: integer
title: Consecutive Failures
created_at:
type: string
title: Created At
updated_at:
type: string
title: Updated At
secret:
type: string
title: Secret
type: object
required:
- id
- url
- events
- description
- is_active
- last_delivery_at
- consecutive_failures
- created_at
- updated_at
- secret
title: WebhookSubscriptionCreateResponse
WebhookSubscriptionCreate:
properties:
url:
type: string
maxLength: 2083
minLength: 1
format: uri
title: Url
events:
items:
type: string
type: array
maxItems: 64
minItems: 1
title: Events
description:
anyOf:
- type: string
maxLength: 2048
- type: 'null'
title: Description
type: object
required:
- url
- events
title: WebhookSubscriptionCreate
Body_add_subscription_admin_webhooks_subscriptions_post:
properties:
url:
type: string
title: Url
default: ''
events:
type: string
title: Events
default: ''
all_events:
type: string
title: All Events
default: ''
description:
type: string
title: Description
default: ''
type: object
title: Body_add_subscription_admin_webhooks_subscriptions_post
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
WebhookSubscriptionRead:
properties:
id:
type: string
format: uuid
title: Id
url:
type: string
title: Url
events:
items:
type: string
type: array
title: Events
description:
anyOf:
- type: string
- type: 'null'
title: Description
is_active:
type: boolean
title: Is Active
last_delivery_at:
anyOf:
- type: string
- type: 'null'
title: Last Delivery At
consecutive_failures:
type: integer
title: Consecutive Failures
created_at:
type: string
title: Created At
updated_at:
type: string
title: Updated At
type: object
required:
- id
- url
- events
- description
- is_active
- last_delivery_at
- consecutive_failures
- created_at
- updated_at
title: WebhookSubscriptionRead