---
title: "Verify challenge token"
source_url: https://dev.digicert.com/certcentral-apis/services-api/webhooks/verify-challenge-token.html
api_method: PUT
api_endpoint: "/services/v2/webhook/{{webhook_id}}/check-challenge"
api_url: "https://www.digicert.com/services/v2/webhook/{{webhook_id}}/check-challenge"
---

**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

## cURL

```bash
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

```console
// No content
```

## Path parameters

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Opt/Req</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>webhook_id</td>
<td>required</td>
<td>number</td>
<td>ID of the webhook to check the token for.</td>
</tr>
</tbody>
</table>

## Request parameters

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Opt/Req</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>token</td>
<td>required</td>
<td>string</td>
<td>Challenge token your webhook endpoint received.<br>Challenge tokens are valid for 30 minutes. If your token expires before you complete the verification challenge, use the <a href="https://dev.digicert.com/md/certcentral-apis/services-api/webhooks/send-challenge-token.md">Send challenge token</a> API endpoint to send another one.</td>
</tr>
</tbody>
</table>

## Error cases

<table>
<thead>
<tr>
<th>Status</th>
<th>Code</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>404</td>
<td>not_found|webhook</td>
<td>A webhook with the given ID does not exist.</td>
</tr>
<tr>
<td>400</td>
<td>webhook_invalid_token</td>
<td>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 <a href="https://dev.digicert.com/md/certcentral-apis/services-api/webhooks/send-challenge-token.md">Send challenge token</a> API endpoint.</td>
</tr>
</tbody>
</table>