Administration

Create a webhook endpoint

POST/organization/webhooks

Subscribes an HTTPS URL to listing events. The signing secret is in the response once: store it now, you'll need it to verify deliveries. Filters must include a city.

Authentication

Send an admin key (dk_admin_…) as a Bearer token. Data keys are refused here.

Scope

organization

Cost

Free

Parameters

Request body

Response

The data field is an object with these fields.

Example request

curl -X POST "https://api.kite.sa/v1/organization/webhooks" \
  -H "Authorization: Bearer $KITE_ADMIN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/kite-webhook","event_types":["listing.created"],"filters":{"city":"riyadh"}}'

import { Kite } from "@kite-sa/sdk";

const kite = new Kite({ apiKey: process.env.KITE_ADMIN_KEY });
const result = await kite.organization.webhooks.create({ url: "https://example.com/kite-webhook", event_types: ["listing.created"], filters: { city: "riyadh" } });

import os
from kite_sa import Kite

kite = Kite(api_key=os.environ["KITE_ADMIN_KEY"])
result = kite.organization.webhooks.create(url="https://example.com/kite-webhook", event_types=["listing.created"], filters={"city": "riyadh"})

Open in the interactive reference

Related endpoints

• Get your organization GET /organization
• List data keys GET /organization/keys
• Create a data key POST /organization/keys
• Revoke a key POST /organization/keys/{key_id}/revoke
• List projects GET /organization/projects
• Daily usage GET /organization/usage
• List members and invitations GET /organization/members
• List audit events GET /organization/audit-events
• List request logs GET /organization/request-logs
• List webhook endpoints GET /organization/webhooks
• Delete a webhook endpoint POST /organization/webhooks/{webhook_id}/delete
• List deliveries GET /organization/webhooks/{webhook_id}/deliveries
• Replay a delivery POST /organization/webhooks/{webhook_id}/deliveries/{delivery_id}/replay

Guides

• Quickstart
• Authentication
• Webhooks
• Limits and quotas
• Errors