Webhook event

BookingCreatedEvent

The BookingCreatedEvent webhook notifies subscribers when a new booking has been successfully created within the Sodtrack platform.

Sodtrack sends POST with Content-Type: application/json to the endpoint configured for your tenant. See webhooks overview for delivery and security guidance.

Payload

Payload
{
  "timestamp": "string",
  "userTriggererEmail": "string",
  "booking": {
    "id": "number",
    "reference": "string",
    "createdDate": "Date",
    "serviceVariantTotalPrice": "number",
    "serviceVariantTotalCost": "number",
    "serviceName": "string",
    "totalAddonsCost": "number",
    "totalAddonsPrice": "number",
    "totalAddonsDuration": "number",
    "status": "string",
    "variantDuration": "number",
    "transportCost": "number",
    "quantity": "number",
    "date": "Date",
    "doneDate": "Date",
    "periodStartTime": "Date",
    "periodEndTime": "Date",
    "finalCost": "number",
    "finalPrice": "number",
    "totalDuration": "number",
    "category": {
      "id": "number",
      "name": "string"
    },
    "saleChannel": {
      "id": "number",
      "name": "string"
    },
    "shoppingCartId": "number",
    "serviceVariant": {
      "id": "number",
      "name": "string",
      "skus": [
        {
          "id": "number",
          "sku": "string"
        }
      ]
    },
    "addons": [
      {
        "id": "number",
        "quantity": "number",
        "name": "string",
        "duration": "number",
        "totalCost": "number",
        "totalPrice": "number",
        "unitCost": "number",
        "unitPrice": "number"
      }
    ],
    "products": [
      {
        "id": "number",
        "quantity": "number",
        "productPromisedDeliveryDate": "Date",
        "sku": "string",
        "name": "string",
        "description": "string",
        "price": "number",
        "unit": {
          "id": "number",
          "serialNumber": "string"
        }
      }
    ],
    "dynamicFieldValues": [
      {
        "id": "number",
        "value": "string"
      }
    ],
    "dynamicFormFields": [
      {
        "reference": "string",
        "value": "string"
      }
    ]
  },
  "customer": {
    "id": "number",
    "name": "string",
    "identificationNumber": "string",
    "lastName": "string",
    "email": "string",
    "phoneNumber": "string"
  },
  "address": {
    "id": "number",
    "coordinates": {
      "lng": "number",
      "lat": "number"
    },
    "address": "string",
    "formattedAddress": "string",
    "areas": [
      {
        "id": "number",
        "name": "string",
        "reference": ""
      }
    ]
  },
  "professional": {
    "id": "number",
    "isCompany": "boolean",
    "reference": "string",
    "name": "string",
    "lastName": "string",
    "email": "string",
    "phoneNumber": "string"
  }
}

Purpose

The BookingCreatedEvent webhook notifies subscribers when a new booking has been successfully created within the Sodtrack platform.

This event is triggered once a booking is created and initialized in the system — typically after a customer completes a service request, a booking is generated from a shopping cart, or a booking is created from a budget execution. At this point, the booking enters the “created” status and becomes ready for provider assignment and scheduling.

Integrating this webhook allows client systems to automatically synchronize new booking records, trigger initial workflows (e.g., provider matching, resource allocation, or external system notifications), and maintain real-time operational consistency with Sodtrack.

Trigger Condition

This webhook is triggered when:

  • A new booking is successfully created in the Sodtrack system, and

  • The booking has been initialized with all required information and assigned the "created" status.

Only bookings that have been fully validated and persisted by the system generate this event.

Example Use Cases

  • Automatically synchronize new booking records in external CRMs, ERPs, or scheduling systems.

  • Maintain synchronized booking creation records between Sodtrack and third-party platforms.

  • Initiate notification workflows to stakeholders about new service requests.

Body

The body of this webhook inherits the standard Sodtrack webhook structure, which includes: