Send challenge token
less than a minute
PUT
Use this endpoint to send an event with a challenge token a webhook endpoint. The challenge token event has this format:https://www.digicert.com/services/v2/webhook/{{webhook_id}}/send-challenge
{
"event": "challenge_webhook_endpoint",
"data": {
"token": <token>,
"webhook_id": 12345
}
}
After receiving the token, use the Verify challenge token endpoint to send the token back to DigiCert and complete the verification challenge.
Challenge tokens are valid for 30 minutes. If your token expires before you complete the verification challenge, use the Send challenge token endpoint to send another one.
Example requests and responses
cURL
curl --request PUT 'https://www.digicert.com/services/v2/webhook/{{webhook_id}}/send-challenge' \
--header 'X-DC-DEVKEY: {{api_key}}' \
--header 'Content-Type: application/json'
204 No Content
// No content
Path parameters
| Name | Opt/Req | Type | Description |
|---|---|---|---|
| webhook_id | required | number | ID of the webhook that should receive the challenge token. |
Error cases
| Status | Code | Description |
|---|---|---|
| 404 | not_found | webhook |
Was this page helpful?
Provide feedback