Update a webhook endpoint (POST /organization/webhooks/{webhook_id}/update) — Kite API
Skip to content
KitePlatform
Pricing
Browse endpoints
All endpoints

Reference data

  • List cities
  • List neighborhoods
  • List city directions
  • List enumerated values
  • Get this key's limits
  • What the API covers

Listings

  • Search listings
  • Count listings
  • Get listings by id
  • Get a listing
  • Get a listing's price history
  • Get a listing's advertiser contact

Market data

  • Market summary
  • Price distribution
  • Area distribution
  • New supply
  • Vacancy indicator
  • Prices by neighborhood
  • Commercial rent per m² by neighborhood
  • Plots for sale against their last registered sale
  • Registered sale price against the asking price
  • Places, population and landmarks around a point or in a neighborhood

Official data

  • Registered rents (REGA)
  • Kite Property Index

Analytics

  • Get comparable listings
  • Get a listing's market position
  • Get a listing's nearby asking-price band
  • Find below-market listings
  • Find below-market listings (old path)
  • Get gross rental yield
  • Get price trends
  • Compare neighborhoods
  • List advertisers by matching listings
  • Check the asking price for any home

Registered transactions

  • Search registered deals
  • Registered deal statistics
  • Land prices per m²

Off-plan projects

  • Search projects
  • Get a project
  • List a project's units
  • Get a project's unit availability over time
  • Search project units
  • List developers
  • Get a project's absorption by month
  • Project absorption by area, developer or type

Exports

  • Create an export
  • List exports
  • Get an export

Administration

  • Get your organization
  • List data keys
  • Create a data key
  • Revoke a key
  • List projects
  • Daily usage
  • List members and invitations
  • List audit events
  • List request logs
  • Create a webhook endpoint
  • List webhook endpoints
  • Update a webhook endpoint
  • Re-enable a webhook endpoint
  • Rotate a webhook signing secret
  • Delete a webhook endpoint
  • List deliveries
  • Replay a delivery

Interactive reference

All endpoints

Reference data

  • List cities
  • List neighborhoods
  • List city directions
  • List enumerated values
  • Get this key's limits
  • What the API covers

Listings

  • Search listings
  • Count listings
  • Get listings by id
  • Get a listing
  • Get a listing's price history
  • Get a listing's advertiser contact

Market data

  • Market summary
  • Price distribution
  • Area distribution
  • New supply
  • Vacancy indicator
  • Prices by neighborhood
  • Commercial rent per m² by neighborhood
  • Plots for sale against their last registered sale
  • Registered sale price against the asking price
  • Places, population and landmarks around a point or in a neighborhood

Official data

  • Registered rents (REGA)
  • Kite Property Index

Analytics

  • Get comparable listings
  • Get a listing's market position
  • Get a listing's nearby asking-price band
  • Find below-market listings
  • Find below-market listings (old path)
  • Get gross rental yield
  • Get price trends
  • Compare neighborhoods
  • List advertisers by matching listings
  • Check the asking price for any home

Registered transactions

  • Search registered deals
  • Registered deal statistics
  • Land prices per m²

Off-plan projects

  • Search projects
  • Get a project
  • List a project's units
  • Get a project's unit availability over time
  • Search project units
  • List developers
  • Get a project's absorption by month
  • Project absorption by area, developer or type

Exports

  • Create an export
  • List exports
  • Get an export

Administration

  • Get your organization
  • List data keys
  • Create a data key
  • Revoke a key
  • List projects
  • Daily usage
  • List members and invitations
  • List audit events
  • List request logs
  • Create a webhook endpoint
  • List webhook endpoints
  • Update a webhook endpoint
  • Re-enable a webhook endpoint
  • Rotate a webhook signing secret
  • Delete a webhook endpoint
  • List deliveries
  • Replay a delivery

Interactive reference

Administration

Update a webhook endpoint

POST/organization/webhooks/{webhook_id}/update

Changes the URL, event types, filters or description of an endpoint; send only what changes. History and the signing secret are kept, and so is the position of every event type that stays subscribed. An event type you add starts from now and does not replay listings from before the change. Removing a type drops its position, so adding it back also starts from now. New filters apply to events not yet queued. Does not re-enable a disabled endpoint: use the enable call.

Authentication
Send an admin key (dk_admin_…) as a Bearer token. Data keys are refused here.
Scope
organization
Cost
Free

Parameters

NameDescription
webhook_idrequiredType: string · path
Idempotency-KeyType: string · header

A unique string (a UUID is ideal) making this call safe to retry. The same key with the same body replays the first response and sets Idempotent-Replay: true; with a different body it returns 409 idempotency_key_reuse. Remembered for 24 hours.

Request body

NameDescription
urlType: string
event_typesType: string[]

One of: listing.created, listing.price_changed, listing.delisted

filtersType: object

Which listings this endpoint wants, in the vocabulary of GET /listings. The plot filters (zoning, corner, street_width_min, white_land_fee, last_sale_within_months, ask_to_last_sale_max) match a listing's plot; for listing.delisted they match only while the delisted listing's plot facts are still on record, which is until the next scrape. plot_sold matches the sale itself (see plot.registered_sale_while_listed), which stays on record after a listing is delisted.

descriptionType: string | null

Null clears it.

Response

The data field is an object with these fields.

NameDescription
idrequiredType: string
urlrequiredType: string
event_typesrequiredType: string[]
filtersrequiredType: object
descriptionrequiredType: string | null
statusrequiredType: string

One of: active, disabled

disabled_reasonrequiredType: string | null

too_many_failures when we stopped after repeated failures.

consecutive_failuresrequiredType: integer
created_atrequiredType: string (date-time)

ISO 8601 time

Example request

cURL
curl -X POST "https://api.kite.sa/v1/organization/webhooks/webhook_id/update" \  -H "Authorization: Bearer $KITE_ADMIN_KEY" \  -H "Content-Type: application/json" \  -d '{}'
JavaScript (@kite-sa/sdk)
import { Kite } from "@kite-sa/sdk";const kite = new Kite({ apiKey: process.env.KITE_ADMIN_KEY });const result = await kite.organization.webhooks.update("webhook_id", {});
Python (kite-sa)
import osfrom kite_sa import Kitekite = Kite(api_key=os.environ["KITE_ADMIN_KEY"])result = kite.organization.webhooks.update("webhook_id")

Open in the interactive reference

Related endpoints

  • Get your organizationGET /organization
  • List data keysGET /organization/keys
  • Create a data keyPOST /organization/keys
  • Revoke a keyPOST /organization/keys/{key_id}/revoke
  • List projectsGET /organization/projects
  • Daily usageGET /organization/usage
  • List members and invitationsGET /organization/members
  • List audit eventsGET /organization/audit-events
  • List request logsGET /organization/request-logs
  • Create a webhook endpointPOST /organization/webhooks
  • List webhook endpointsGET /organization/webhooks
  • Re-enable a webhook endpointPOST /organization/webhooks/{webhook_id}/enable
  • Rotate a webhook signing secretPOST /organization/webhooks/{webhook_id}/rotate-secret
  • Delete a webhook endpointPOST /organization/webhooks/{webhook_id}/delete
  • List deliveriesGET /organization/webhooks/{webhook_id}/deliveries
  • Replay a deliveryPOST /organization/webhooks/{webhook_id}/deliveries/{delivery_id}/replay

Guides

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

Ready to make a request? The Sandbox plan is free. For volume or licensing, talk to us.

Get an API keyTalk to us
Kite API

Saudi real estate data for developers.

Product
  • Data coverage
  • Pricing
  • Investors and developers
  • Valuation checks
  • Proptech and apps
Developers
  • Quickstart
  • Guides
  • API reference
  • MCP server
  • JavaScript SDK (npm)
  • Python SDK (PyPI)
  • Changelog
  • Status
Company
  • kite.sa
  • Blog
  • Contact
  • Security
Legal
  • Terms
  • Sources and data rights
  • Privacy
  • DPA
  • Subprocessors
© Kite