--- title: Webhooks description: Learn how to use webhooks to get notified when events occur (new jobs, tech changes, etc) in TheirStack and trigger actions in your external systems like N8N, Zapier, Make, Airtable, etc url: https://theirstack.com/en/docs/webhooks --- ## What are webhooks? Webhooks allow you to send data when specific events occur (new jobs, tech changes, etc) to external systems like N8N, Zapier, Make, Airtable, your own webhook endpoint, etc. For instance, you can configure a webhook to alert you when a new job is listed in a particular location, company, or technology sector. Webhooks are dependent on a search, which defines the criteria for triggering the webhook. Any type of searches (job, company, technology, etc) can be used to trigger a webhook. ### Webhooks Applications - Initiate a workflow in an automation tool like Zapier, Make, N8N when a new job is posted or a company adopts a new technology (e.g., Snowflake, Hubspot, Python). - Send a Slack notification to your team when a new job is found or a company adopts a new technology (e.g., Snowflake, Hubspot, Python). - Automatically update a Google Sheet with new job or [company data](/en/docs/data/company). - Trigger an email alert to a specific distribution list when a new job matches certain criteria. - Create a table in Airtable to store job listings. - Integrate with a CRM system to add new company information as leads. ### Webhook types There are three types of webhooks: - **[job.new](/en/docs/webhooks/event-type/webhook_job_new)**: Fires whenever we discover a new job posting that matches your search criteria. [Data Schema](/en/docs/webhooks/event-type/webhook_job_new). - **[company.new](/en/docs/webhooks/event-type/webhook_company_new)**: Fires whenever we discover a new company that matches your search criteria. [Data Schema](/en/docs/webhooks/event-type/webhook_company_new). - **`tech.new`**: Triggered when company adopts a new technology (request access to this) ## Pricing Webhooks and API requests share the same pricing. When an event is triggered, it consumes 1 (`job.new`) or 3 (`company.new`, `tech.new`) API credits based on the type of event. Learn more about our credit system [here](/en/docs/pricing/credits). - [How to set up a webhook](/en/docs/webhooks/how-to-set-up-a-webhook) — Learn how to set up a webhook to get notified when events occur (new jobs, tech changes, etc) in TheirStack and trigger actions in your external systems like N8N, Zapier, Make, Airtable, etc - [Monitor your webhooks](/en/docs/webhooks/monitor-your-webhooks) — Track your webhook performance with detailed analytics. Learn how to view webhook usage statistics, understand event statuses, and troubleshoot webhook delivery issues using TheirStack's built-in monitoring dashboard. - [Receive TheirStack events in your webhook endpoint](/en/docs/webhooks/receive-theirstack-events-in-your-webhook-endpoint) — Learn the essential technical requirements for building webhook endpoints that receive TheirStack job and company data. Covers status codes, retry logic, concurrency handling, and duplicate prevention. - [Verify webhook signatures](/en/docs/webhooks/verify-webhook-signatures) — Learn how to verify that webhook deliveries come from TheirStack by validating the HMAC-SHA256 signature included in each request. - [Company.New Webhook](/en/docs/webhooks/event-type/webhook_company_new) — Triggered when a new company matching your saved search criteria is discovered. \[Learn more about webhooks\](https://theirstack.com/en/docs/webhooks). - [Job.New Webhook](/en/docs/webhooks/event-type/webhook_job_new) — Triggered when a new job matching your saved search criteria is discovered. \[Learn more about webhooks\](https://theirstack.com/en/docs/webhooks). ## FAQs #### What happens to webhook events when I run out of API credits? When you run out of API credits, webhook event monitoring is temporarily paused. During this period, no new events will appear in your webhook history. Monitoring automatically resumes once you purchase additional API credits. Whether you miss events during the pause depends on your search criteria. For example, if your webhook tracks jobs posted within the last 60 days and you lack credits for 2 days, you won't miss anything - when credits are restored, all jobs discovered during the pause will still trigger your webhook as they match your search parameters. #### What happens if the webhook event fails? If the webhook event fails, it will be automatically retried every hour for 48 hours. #### How much cost to run a webhook? [Webhook events](/en/docs/webhooks/monitor-your-webhooks) are billed at the same rate as API requests. They consume 1 API credit per event.