Push Updates to Seyaha

Rather than waiting for the next scheduled nightly sync, your platform can push updates to Seyaha the moment your catalog or availability changes. Seyaha exposes two inbound webhook endpoints for this purpose. Both endpoints authenticate via the x-webhook-secret header — the secret is generated when you register your integration.

Trigger a catalog sync

Call this when products are added, removed, or have pricing/metadata changes:

POST https://api.seyaha.net/api/v1/partner-integrations/{integrationId}/sync/trigger
x-webhook-secret: <your-webhook-secret>

Seyaha will call your GET /products endpoint immediately and process any changes. Response:

{ "success": 1, "data": { "synced": 12, "skipped": false } }

skipped: true means the response hash matched the previous sync — no changes written.

Push an availability change

Call this when a single slot’s status, capacity, or vacancies change. This is faster than a full sync and avoids re-fetching the entire catalog.

POST https://api.seyaha.net/api/v1/partner-integrations/{integrationId}/availability/notify
x-webhook-secret: <your-webhook-secret>
Content-Type: application/json

{
  "productId": "product_abc",
  "optionId": "option_xyz",
  "availabilityId": "avail_001",
  "localDateTimeStart": "2026-07-15T10:00:00+03:00",
  "status": "LIMITED",
  "vacancies": 3,
  "capacity": 20
}

Response:

{ "success": 1, "data": { "updated": true } }

If updated is false, Seyaha could not match the productId/optionId to an existing activity in its database and will trigger a full background sync automatically.

Choosing sync vs. notify

Change type	Use
Product added or removed	`sync/trigger`
Pricing or option metadata changed	`sync/trigger`
Single slot capacity/status changed	`availability/notify`
Many slots changed at once	`sync/trigger`

Your webhook_secret is shown once at registration. Store it in a secrets manager. If lost, you need to delete and recreate the integration to get a new secret.

Dashboard Guide

Developer Integration

API Reference

Push Updates to Seyaha

Trigger a catalog sync

Push an availability change

Choosing sync vs. notify

​Trigger a catalog sync

​Push an availability change

​Choosing sync vs. notify

Trigger a catalog sync

Push an availability change

Choosing sync vs. notify