Configure your Endpoints

To start listening to events sent by Anduin webhooks, you need to register and validate your endpoints.

Register an endpoint by calling the following REST API:

Update an endpoint by calling the following REST API:

These REST APIs allow you to specify the URL of your endpoint and the list of event types from which you want your endpoint to receive messages.

Endpoint Validation

Before a registered or updated endpoint can start receiving actual events, it needs to pass the following validation scheme:

  • Request: A validation request will be sent to your endpoint. This request is a GET request that includes a randomly generated validation key in the x-anduin-webhook-validation-key header. The validation request can be represented using cURL as follows:
    curl
    	-X GET https\\:\\\\\\\\[yourdomain.com](<http://yourdomain.com/>)
      -H 'x-anduin-webhook-validation-key: [RANDOM_VALIDATIONKEY]'
    
  • Response: To successfully pass the validation, your endpoint should respond with a 200 status code and include the same header with the received validation key.