Gett · Schema

WebhookSubscription

A Gett Business API webhook subscription

Ground TransportationCorporate TravelRide BookingBusiness TravelExpense Management

Properties

Name Type Description
id string Subscription unique identifier
hook_address string Publicly accessible HTTPS endpoint URL for receiving events
event_types array Subscribed event types
business_ids array Associated business identifiers
secret_id string UUID verification token used to validate that requests were sent from Gett
created_at string Subscription creation timestamp (RFC 3339)
updated_at string Last update timestamp (RFC 3339)
View JSON Schema on GitHub

JSON Schema

webhook-subscription.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://developer.gett.com/schemas/webhook-subscription",
  "title": "WebhookSubscription",
  "description": "A Gett Business API webhook subscription",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Subscription unique identifier"
    },
    "hook_address": {
      "type": "string",
      "format": "uri",
      "description": "Publicly accessible HTTPS endpoint URL for receiving events"
    },
    "event_types": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": ["status_changed", "business_report"]
      },
      "description": "Subscribed event types"
    },
    "business_ids": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uuid"
      },
      "description": "Associated business identifiers"
    },
    "secret_id": {
      "type": "string",
      "format": "uuid",
      "description": "UUID verification token used to validate that requests were sent from Gett"
    },
    "created_at": {
      "type": "string",
      "format": "date-time",
      "description": "Subscription creation timestamp (RFC 3339)"
    },
    "updated_at": {
      "type": "string",
      "format": "date-time",
      "description": "Last update timestamp (RFC 3339)"
    }
  },
  "required": ["hook_address", "event_types"]
}