Verify a webhook endpoint

POST

/api/v1/organizations/{organizationId}/webhooks/{webhookId}/verify

curl --request POST \
  --url https://api.koneth.com/api/v1/organizations/b7378db4-5a7a-4e69-a8df-04f2e6d94243/webhooks/0f6f2d88-9357-4ce6-9b9e-76db2f98bb2e/verify \
  --header 'Authorization: Bearer <token>'

• Production
• Local development

Sends {"type":"koneth.endpoint.verify","challenge":"…"} to the endpoint URL and activates the endpoint only when the receiver replies with the same challenge value. The request is not signed. Verification fails when the receiver returns a non-2xx status or a body whose challenge does not match.

Authorizations

• consoleSession

Parameters

Path Parameters

organizationId

required

string format: uuid

UUID of the organization the signed-in user belongs to.

Example

b7378db4-5a7a-4e69-a8df-04f2e6d94243

webhookId

required

string format: uuid

UUID of a webhook endpoint in the organization.

Example

0f6f2d88-9357-4ce6-9b9e-76db2f98bb2e

Responses

200

Endpoint activated.

Media typeapplication/json

object

endpoint

required

object

id

required

string format: uuid

status

required

string

Allowed values: active

verifiedAt

required

string format: date-time

Example

{
  "endpoint": {
    "id": "0f6f2d88-9357-4ce6-9b9e-76db2f98bb2e",
    "status": "active",
    "verifiedAt": "2026-09-10T18:02:11.000Z"
  }
}

401

The Console session is missing or expired.

Media typeapplication/json

object

error

required

string

issues

Validation issue details when the request fails schema validation.

Array<object>

object

key

additional properties

any

Example

{
  "error": "Authentication required"
}

403

The signed-in user is not an organization Owner or Finance member.

Media typeapplication/json

object

error

required

string

issues

Validation issue details when the request fails schema validation.

Array<object>

object

key

additional properties

any

Example

{
  "error": "Insufficient organization permission"
}

404

The requested resource was not found.

Media typeapplication/json

object

error

required

string

issues

Validation issue details when the request fails schema validation.

Array<object>

object

key

additional properties

any

Example^generated

{
  "error": "example",
  "issues": [
    {}
  ]
}

409

The request conflicts with the current resource state.

Media typeapplication/json

object

error

required

string

issues

Validation issue details when the request fails schema validation.

Array<object>

object

key

additional properties

any

Example^generated

{
  "error": "example",
  "issues": [
    {}
  ]
}

500

Unexpected server error.

Media typeapplication/json

object

error

required

string

issues

Validation issue details when the request fails schema validation.

Array<object>

object

key

additional properties

any

Example

{
  "error": "Internal server error"
}