---
title: "Register Webhook Endpoint"
method: POST
path: "/api/v1/webhooks/"
tags: ["Webhooks"]
---

# Register Webhook Endpoint

`POST /api/v1/webhooks/`

## Request

- Base URL: `https://earningscalls.dev`
- URL: `https://earningscalls.dev/api/v1/webhooks/`
- Auth: API key in header `X-API-Key`

Register an HTTPS endpoint that receives a POST for every newly ingested transcript (event transcript.created), signed with HMAC-SHA256 in the X-EC-Signature header. Optional comma-separated ticker/country filters. Deliveries are retried twice (after 5 and 30 minutes); an endpoint failing 10 deliveries in a row is auto-disabled. Enterprise / Ultra only.

## Request body

- object
  - `url` string, required: HTTPS endpoint to POST events to
  - `tickers` string: Optional comma-separated ticker filter, e.g. "BHP,RIO,CSL". Suffix-free base tickers.
  - `countries` string: Optional comma-separated ISO country filter, e.g. "AU,US"

## Response `200`

Default Response

---

[API](https://skmtc.dev/earningscalls/apis/earnings-call-transcripts-api.md) · [All operations](https://skmtc.dev/earningscalls/apis/earnings-call-transcripts-api/llms.txt) · [OpenAPI document](https://skmtc.dev/earningscalls/apis/earnings-call-transcripts-api/revisions/00131591f434?raw)