Verify challenge token
less than a minute
PUT
Use this endpoint to complete the verification challenge for a webhook endpoint.https://www.digicert.com/services/v2/webhook/{{webhook_id}}/check-challenge
Example requests and responses
cURL
curl --request PUT 'https://www.digicert.com/services/v2/webhook/{{webhook_id}}/check-challenge' \
--header 'X-DC-DEVKEY: {{api_key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"token": "<token>"
}'
204 No Content
// No content
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 |
| 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. |
Was this page helpful?
Provide feedback