Skip to main content

Send challenge token

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

Use this endpoint to send an event with a challenge token a webhook endpoint. The challenge token event has this format:

{
  "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

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

A webhook with the given ID does not exist.