# Setting up a webhook

Rather than manually retrieving results using the [](https://manual.personr.co/api-documentation/applicant-results/retrieving-applicant-verification-results "mention") endpoint, you can set up a webhook that sends the verification status and extracted data to your API once a verification has finished processing.

Providing us your endpoint URL is easy. Simply head to <https://enterprise.personr.co/dashboard/dev-space> and click on Webhooks.

Enter your API endpoint that's listening, and hit Save.

<figure><img src="https://2927352434-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyAmEVMxhOOdXgxn7sjnz%2Fuploads%2FIqZoJbMXSJDRkhTz1Gqz%2FScreenshot%202024-02-28%20at%2012.28.43%E2%80%AFpm.png?alt=media&#x26;token=5571b80b-0cb7-424a-b9ae-9340357d7464" alt=""><figcaption></figcaption></figure>

Be sure to generate a webhook authentication token, and only accept authenticated calls from us. We'll send a POST request to your endpoint, with your generated token in the header.&#x20;

#### Webhook Response

```json
{
  "applicantId": "14000394983x200039203940",
  "actionStatus": "Reviewed",
  "reviewAnswer": "Rejected",
  "rejectLabels": [
    "FORGERY",
    "CRIMINAL"
  ],
  "extFirstName": "JOHN",
  "extLastName": "DOE",
  "extDob": "1996-07-01",
  "extStreetNumber": "123",
  "extStreetName": "EXAMPLE LANE",
  "extCity": "PERTH",
  "extPostCode": "6000",
  "extCountry": "AUSTRALIA",
  "docCountryISO": "AUS",
  "docExpiry": "2035-12-01",
  "sourceKey": "Example Source Key",
  "externalUserId": []
}
```