Skip to main content

Verify challenge token

PUT https://www.digicert.com/services/v2/webhook/{{webhook_id}}/check-challenge

Use this endpoint to complete the verification challenge for a webhook endpoint.

Example requests and responses

Path parameters

Name

Opt/Req

Type

Description

webhook_id

required

number

ID of the webhook to check the token for.

Request parameters

Name

Opt/Req

Type

Description

token

required

string

Challenge token your webhook endpoint received.

Challenge tokens are valid for 30 minutes. If your token expires before you complete the verification challenge, use the Send challenge token API endpoint to send another one.

Error cases

Status

Code

Description

404

not_found|webhook

A webhook with the given ID does not exist.

400

webhook_invalid_token

The token is invalid, expired, or missing from the request. Make sure the token in your request payload matches the token your webhook listener recieved. To send a new token, use the Send challenge token API endpoint.