API Endpoint Reference / Webhooks

Read a webhook endpoint

GET https://api.printhiv3d.com/v1/webhooks/{id}

Operation ID getWebhook. Requires the read API key scope.

Parameters

NameInTypeRequiredDescription
idpathuuidYes

Responses

StatusDescription
200Default Response
401Default Response
403Default Response
404Default Response

200 response fields

FieldTypeRequiredDescription
iduuidYes
organization_iduuidYes
namestringYes
urlstringYes
event_typesstring[]YesThe types the endpoint subscribes to. Print Hive adds types, so a reader ignores a name it does not know.
enabledbooleanYes
consecutive_failuresintegerYes
created_atstringYes
updated_atstringYes

401 response fields

FieldTypeRequiredDescription
errorstringNo
messagestringNo
requestIdstringNo

403 response fields

FieldTypeRequiredDescription
errorstringNo
messagestringNo
requestIdstringNo

404 response fields

FieldTypeRequiredDescription
errorstringNo
messagestringNo
requestIdstringNo

Example 200 response

{
  "id": "2a6f0d8e-5c3b-4d19-b7a4-9e1c8f5d3a60",
  "organization_id": "3b9e4d71-0c2f-4a58-8e6d-91f2a7c4b605",
  "name": "Fulfilment service",
  "url": "https://hooks.example.com/printhive",
  "event_types": [
    "job.started",
    "job.completed",
    "job.failed",
    "printer.offline"
  ],
  "enabled": true,
  "consecutive_failures": 0,
  "created_at": "2026-11-04T18:00:00.000Z",
  "updated_at": "2026-11-04T18:00:00.000Z"
}