Skip to main content
GET
/
v1
/
webhooks
curl --location --request GET 'https://api.hirempire.com/v1/webhooks' \
--header 'Authorization: Bearer YOUR_TOKEN'

{
  "success": true,
  "data": [
    {
      "id": "0c8t5e54-e053-40b2-8c9c-b45rgy0acf8a",
      "request_url": "https://example.com/webhook",
      "created_at": "2025-07-01T04:27:13.000Z",
      "active": true,
      "events": [
        "job_added",
        "job_activated",
        "meeting_booked"
      ]
    }
  ]
}

​
Authentication

​
Authorization
string
required
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
curl --location --request GET 'https://api.hirempire.com/v1/webhooks' \
--header 'Authorization: Bearer YOUR_TOKEN'

​
Response

​
success
boolean
Indicates if the request was successful
​
data
array
Array of webhook objects
{
  "success": true,
  "data": [
    {
      "id": "0c8t5e54-e053-40b2-8c9c-b45rgy0acf8a",
      "request_url": "https://example.com/webhook",
      "created_at": "2025-07-01T04:27:13.000Z",
      "active": true,
      "events": [
        "job_added",
        "job_activated",
        "meeting_booked"
      ]
    }
  ]
}
If no webhooks are registered, the data array will be empty: 
{
  "success": true,
  "data": []
}

​
Error Responses

​
Validation Errors

400 - Bad Request 
{
  "success": false,
  "error": "Invalid token"
}
400 - Bad Request 
{
  "success": false,
  "error": "Input is incorrect."
}

​
Authorization Errors

401 - Unauthorized 
{
  "success": false,
  "error": "Token is expired"
}
401 - Unauthorized 
{
  "success": false,
  "error": "Token is missing required scope"
}

​
Forbidden

403 - Forbidden 
{
  "success": false,
  "error": "Token has been deleted"
}