Create New Webhook

Authorization

Bearer

AuthorizationBearer <token>

In: header

Request Body

application/json

url
string
length: 1 <= length <= 2083urihttps://example.com/webhook
required
URL of the webhook
search_id
integer
123
required
ID of the search that the webhook is listening to.
description
stringnullable
Webhook for new jobs
Description of the webhook
listening_start_time
stringnullable
date-time2024-01-01T00:00:00
Date when the webhook started listening for events. If listening_start_time is None, the webhook will listen to all events matching the search query regardless of when they occurred.
trigger_once_per_company
boolean
default: falsetrue
Only for webhook type ='job.new'. If true, Company A with 5 jobs → 1 event triggered. If false, Company A with 5 jobs → 5 events triggered

Response Body

`application/json`

curl -X POST "https://api.theirstack.com/v0/webhooks" \  -H "Content-Type: application/json" \  -d '{    "url": "https://example.com/webhook",    "search_id": 123  }'

{
  "url": "https://example.com/webhook",
  "search_id": 123,
  "description": "Webhook for new jobs",
  "listening_start_time": "2024-01-01T00:00:00",
  "trigger_once_per_company": true,
  "id": 0,
  "user_id": 0,
  "team_id": 0,
  "is_active": true,
  "is_archived": true,
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z",
  "search_name": "string",
  "event_type": "job_new"
}

{
  "request_id": null,
  "error": {
    "code": "E-001",
    "title": "Not allowed exception",
    "description": "string"
  }
}

{
  "request_id": null,
  "error": {
    "code": "E-001",
    "title": "Not allowed exception",
    "description": "string"
  }
}

{
  "request_id": null,
  "error": {
    "code": "E-001",
    "title": "Not allowed exception",
    "description": "string"
  }
}

{
  "request_id": null,
  "error": {
    "code": "E-001",
    "title": "Not allowed exception",
    "description": "string"
  }
}

{ "url": "https://example.com/webhook", "search_id": 123, "description": "Webhook for new jobs", "listening_start_time": "2024-01-01T00:00:00", "trigger_once_per_company": true, "id": 0, "user_id": 0, "team_id": 0, "is_active": true, "is_archived": true, "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z", "search_name": "string", "event_type": "job_new" }

Authorization

Request Body

Response Body

200application/json

400application/json

402application/json

422application/json

500application/json

Create New Webhook

Authorization

Request Body

Response Body

200application/json

400application/json

402application/json

422application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`