An error occurs during the attempt to perform a one-time validation for a newly created event hook. The system displays the following error message in the API:

{
    "errorCode": "E0000001",
    "errorSummary": "Api validation failed: eventHook",
    "errorLink": "E0000001",
    "errorId": "oaeXbZEUojrQR67BJY5da4rXQ",
    "errorCauses": [
        {
            "errorSummary": "Unable to verify event hook. Hook <hook name> execution failed"
        }
    ]
}

• Event Hooks
• One-time verification request

The web server that Okta called for event hook verification did not respond correctly with the value of the X-Okta-Verification-Challenge header present in the request.

For the one-time verification process for event hooks, Okta will send an HTTP request like the following:

GET /event-hook/ HTTP/1.1
User-Agent: Okta-Integrations
Accept: application/json
X-Okta-Request-Id: XOZfPkReFFZ10KWyGkzAMwAAADA
X-Okta-Verification-Challenge: Me_rShK8JHsTnbyYrWXCEoMGbM_zsZ6k0hLPZ_Pg
x-any-key: my-header-value
Authorization: my-shared-secret
Host: example.com

The web server will need to read the request header X-Okta-Verification-Challenge and pass its value in the body of the response, as the following example:

HTTP/1.1 200 OK
Date: Thu, 23 May 2019 08:51:47 GMT
Content-Length: 59
Content-Type: application/json

{"verification":"Me_rShK8JHsTnbyYrWXCEoMGbM_zsZ6k0hLPZ_Pg"}

Related References

• See one-time verification request for more details.