Webhooks

Update Webhook

Changed on

Update an existing webhook destination. Webhooks are available on paid subscriptions only.

put/webhooks/{webhookId}

Request

  • Base URL: https://api.thanks.io/api/v2
  • URL: https://api.thanks.io/api/v2/webhooks/{webhookId}
  • Auth: HTTP bearer

Request body

urlstring uri required
descriptionstring nullable
verbstring required
type'order_item.status_update' | 'order.status_update' | 'order_item.delivered' | 'scans.scan_update' | 'scan_board.status_update' required
scan_board_status'new' | 'contacted' | 'follow_up' | 'done' | 'null' nullable

The Scan Board stage this webhook fires on. Required when type is scan_board.status_update; null for other types.

Example request

{
  "url": "https://example.com/webhooks/thanksio-updated",
  "description": "Updated webhook destination",
  "verb": "get",
  "type": "order_item.status_update"
}

Response

OK

idinteger
user_idinteger
mailing_list_idinteger nullable
type'order_item.status_update' | 'order.status_update' | 'order_item.delivered' | 'scans.scan_update' | 'scan_board.status_update'
scan_board_status'new' | 'contacted' | 'follow_up' | 'done' | 'null' nullable

The Scan Board stage this webhook fires on. Required when type is scan_board.status_update; null for other types.

descriptionstring nullable
invoke_countinteger
urlstring uri
verbstring
created_atstring date-time nullable
updated_atstring date-time
deleted_atstring date-time nullable

Example response

{
  "id": 13,
  "user_id": 2,
  "type": "order_item.status_update",
  "description": "Updated webhook destination",
  "url": "https://example.com/webhooks/thanksio-updated",
  "verb": "get",
  "created_at": "2026-03-10T18:59:24.000000Z",
  "updated_at": "2026-03-10T20:54:01.000000Z"
}

Changes

  • 6a3359b14347Revision changes
    • warning

      added the new scan_board.status_update enum value to the response property for the response status

    • info

      added the new optional request property

    • info

      added the new scan_board.status_update enum value to the request property

    • info

      added the optional property to the response with the status

  • bbe02ffe74f3Revision changes
    • breaking

      removed the enum value scan_board.status_update of the request property

    • warning

      removed the request property

    • warning

      removed the optional property from the response with the status

    • info

      removed the scan_board.status_update enum value from the response property for the response status