Skip to content

A workflow's managed webhook, without its secret

GET
/api/v1/workspaces/{workspace}/integration/hooks/{hookId}
curl --request GET \
--url https://reputecast.example.com/api/v1/workspaces/acme-newsletter/integration/hooks/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
--header 'Authorization: Bearer <token>'

Permission: webhooks:manage

Keys: only an integration’s key can call this operation.

n8n checks that a workflow’s webhook still exists when the workflow is turned on, and subscribes again when it answers 404.

workspace
required

Workspace slug

string
/^[a-z0-9][a-z0-9-]{1,62}$/

Workspace slug

hookId
required
string format: uuid

OK

Media typeapplication/json
object
createdAt
required
string format: date-time
event
required
string
id
required
string
secret

The signing secret. Only in the answer to the subscribe call.

string
signatureHeader
required
string
timestampHeader
required
string
url
required
string

Example generated

{
"createdAt": "2026-04-15T12:00:00Z",
"event": "example",
"id": "example",
"secret": "example",
"signatureHeader": "example",
"timestampHeader": "example",
"url": "example"
}

Error

Media typeapplication/problem+json
object
code

Stable error code, e.g. permission_denied

string
detail

A human-readable explanation specific to this occurrence of the problem.

string
errors

Optional list of individual error details

Array<object>
object
location

Where the error occurred, e.g. ‘body.items[3].tags’ or ‘path.thing-id’

string
message

Error message text

string
value

The value at the given location

helpers

Members who hold the missing permission

Array<string>
instance

A URI reference that identifies the specific occurrence of the problem.

string format: uri
meta
object
key
additional properties
permission

The missing permission key

string
status

HTTP status code

integer format: int64
title

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

string
type

A URI reference to human-readable documentation for the error.

string format: uri
default: about:blank

Example

{
"detail": "Property foo is required but is missing.",
"instance": "https://example.com/error-log/abc123",
"status": 400,
"title": "Bad Request",
"type": "about:blank"
}