Destinations

Create/Update a destination

Changed on Sep 9, 2026

This endpoint creates a destination, or updates an existing destination by name.

put/destinations

Request

Base URL
https://api.hookdeck.com/2025-07-01
Auth
- HTTP bearer
- or HTTP basic

Request body

namestring required

Name for the destination

type'HTTP' | 'CLI' | 'MOCK_API'

Type of the destination

descriptionstring nullable

Description for the destination

Response

A single destination

idstring required

ID of the destination

namestring required

A unique, human-friendly name for the destination

descriptionstring nullable

Description of the destination

team_idstring required

ID of the project

type'HTTP' | 'CLI' | 'MOCK_API' required

Type of the destination

disabled_atstring date-time nullable required

Date the destination was disabled

updated_atstring date-time required

Date the destination was last updated

created_atstring date-time required

Date the destination was created

Changes

Sep 9, 20268e3ce7869510 Revision changes
- breaking
  the request property //////// became not nullable
- breaking
  the request property ////// became not nullable
- breaking
  the request property ////// became not nullable
- breaking
  the request property //////// became not nullable
- breaking
  the request property ////// became not nullable
- breaking
  the request property ////// became not nullable
- breaking
  the request property ////// became required
- breaking
  the request property ////// became required
- breaking
  the request property ////// became required
- breaking
  the request property ////// became required
- info
  the response property ////// became required for the status
- info
  the response property ////// became required for the status
- info
  the response property ////// became required for the status
- info
  the response property ////// became required for the status

Operation history