Quickstart

npm install @webhook-co/sdk

pip install webhook-co

go get github.com/webhook-co/webhook-go

wbhk endpoints create orders-prod
# prints the ingest URL: https://wbhk.my/whep_...

curl -X POST https://api.webhook.co/v1/endpoints \
  -H "Authorization: Bearer $WEBHOOK_API_KEY" \
  -H "content-type: application/json" \
  -d '{"name":"orders-prod"}'
# → { "id": "...", "ingestUrl": "https://wbhk.my/whep_...", ... }

import { WebhookClient } from "@webhook-co/sdk";

const webhook = new WebhookClient({ apiKey: process.env.WEBHOOK_API_KEY! });
const endpoint = await webhook.endpoints.create({ name: "orders-prod" });
console.log(endpoint.ingestUrl); // https://wbhk.my/whep_...

import os
from webhook_co import WebhookClient

client = WebhookClient(api_key=os.environ["WEBHOOK_API_KEY"])
endpoint = client.endpoints.create(name="orders-prod")
print(endpoint.ingest_url)  # https://wbhk.my/whep_...

client, _ := webhook.NewClient(os.Getenv("WEBHOOK_API_KEY"))
ep, _ := client.Endpoints.Create(ctx, webhook.EndpointsCreateParams{Name: "orders-prod"})
fmt.Println(ep.IngestUrl) // https://wbhk.my/whep_...

wbhk events list <endpoint-id>

# One endpoint. Drop the endpointId query to list your whole org's events.
curl "https://api.webhook.co/v1/events?endpointId=<endpoint-id>" \
  -H "Authorization: Bearer $WEBHOOK_API_KEY"

// Pass { endpointId } for one endpoint; omit it to list the whole org.
for await (const event of webhook.events.list({ endpointId: endpoint.id })) {
  console.log(event.id, event.provider, event.verificationState);
}

# Pass endpoint_id for one endpoint; omit it to list the whole org.
for event in client.events.list(endpoint_id=endpoint.id):
    print(event.id, event.provider, event.verification_state)

// Set EndpointID for one endpoint; omit it (nil params) to list the whole org.
it := client.Events.List(&webhook.EventsListParams{EndpointID: &ep.ID})
for it.Next(ctx) {
    e := it.Value()
    fmt.Println(e.ID, e.Provider, e.VerificationState)
}
if err := it.Err(); err != nil {
    log.Fatal(err)
}