Hookdeck Notifications API
Manage how your team is notified when issues occur — channel routing, mute windows, per-team subscriptions, and the templates rendered to Slack, Email, Microsoft Teams, and Discord.
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/hookdeck-notifications-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
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: Hookdeck Bookmarks Attempts Notifications API
version: 1.0.0
description: Save bookmarked events for quick replay and convenient one-click testing during development.
contact:
name: Hookdeck Support
url: https://hookdeck.com/contact-us
email: info@hookdeck.com
servers:
- url: https://api.hookdeck.com/2025-07-01
description: Production API
security:
- bearerAuth: []
- basicAuth: []
tags:
- name: Notifications
description: Notifications let your team receive alerts anytime an issue changes.
paths:
/notifications/webhooks:
put:
operationId: toggleWebhookNotifications
summary: Webhook Notifications
description: This endpoint enables or disables webhook notifications for the project, and sets the topics and source to deliver them to.
tags:
- Notifications
responses:
'200':
description: Toggle operation status response
content:
application/json:
schema:
$ref: '#/components/schemas/ToggleWebhookNotifications'
parameters: []
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
enabled:
type: boolean
description: Enable or disable webhook notifications on the project
topics:
type: array
items:
$ref: '#/components/schemas/TopicsValue'
description: List of topics to send notifications for
source_id:
type: string
description: The Hookdeck Source to send the webhook to
required:
- enabled
- topics
- source_id
additionalProperties: false
/teams/current/custom_domains:
post:
operationId: addCustomDomain
summary: Add a custom domain to the project
description: ''
tags:
- Notifications
responses:
'200':
description: Custom domain successfuly added
content:
application/json:
schema:
$ref: '#/components/schemas/AddCustomHostname'
parameters: []
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/AddCustomHostname'
get:
operationId: listCustomDomains
summary: List all custom domains and their verification statuses for the project
description: ''
tags:
- Notifications
responses:
'200':
description: List of custom domains
content:
application/json:
schema:
$ref: '#/components/schemas/ListCustomDomainSchema'
parameters: []
/teams/current/custom_domains/{domain_id}:
delete:
operationId: deleteCustomDomain
summary: Removes a custom domain from the project
description: ''
tags:
- Notifications
responses:
'200':
description: Custom domain successfuly removed
content:
application/json:
schema:
$ref: '#/components/schemas/DeleteCustomDomainSchema'
parameters:
- in: path
name: domain_id
schema:
type: string
required: true
components:
schemas:
ToggleWebhookNotifications:
type: object
properties:
enabled:
type: boolean
topics:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/TopicsValue'
source_id:
type: string
required:
- enabled
- source_id
additionalProperties: false
ListCustomDomainSchema:
type: array
items:
type: object
properties:
id:
type: string
hostname:
type: string
status:
type: string
ssl:
type: object
properties:
id:
type: string
type:
type: string
method:
type: string
status:
type: string
txt_name:
type: string
txt_value:
type: string
validation_records:
type: array
items:
type: object
properties:
status:
type: string
txt_name:
type: string
txt_value:
type: string
additionalProperties: false
dcv_delegation_records:
type: array
items:
type: object
properties:
cname:
type: string
cname_target:
type: string
additionalProperties: false
settings:
type: object
properties:
min_tls_version:
type: string
additionalProperties: false
bundle_method:
type: string
wildcard:
type: boolean
certificate_authority:
type: string
additionalProperties: false
verification_errors:
type: array
items:
type: string
ownership_verification:
type: object
properties:
type:
type: string
name:
type: string
value:
type: string
additionalProperties: false
created_at:
type: string
additionalProperties: false
TopicsValue:
type: string
enum:
- issue.opened
- issue.updated
- deprecated.attempt-failed
- event.successful
description: Supported topics
x-docs-type: string
AddCustomHostname:
type: object
properties:
hostname:
type: string
description: The custom hostname to attach to the project
required:
- hostname
additionalProperties: false
DeleteCustomDomainSchema:
type: object
properties:
id:
type: string
description: The custom hostname ID
required:
- id
additionalProperties: false
securitySchemes:
bearerAuth:
type: http
scheme: bearer
basicAuth:
type: http
scheme: basic