Webhook event

BookingProviderAssignedEvent

The BookingProviderAssignedEvent webhook notifies subscribers when a service provider (technician, professional, or company) has been assigned to a booking 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 BookingProviderAssignedEvent webhook notifies subscribers when a service provider (technician, professional, or company) has been assigned to a booking within the Sodtrack platform.

This event is triggered when a provider is matched and assigned to fulfill a service request — typically through automatic matching algorithms, manual assignment by administrators, or when a provider accepts a booking request.

Integrating this webhook allows client systems to automatically track provider assignments, trigger provider-specific workflows (e.g., job notifications, schedule synchronization, resource preparation), handle provider reassignments, and maintain real-time operational consistency with Sodtrack.

Trigger Condition

This webhook is triggered when:

  • A provider is successfully assigned to a booking (either initial assignment or reassignment), and

  • The provider assignment is recorded and validated in the Sodtrack system.

The event includes information about the assigned provider and the booking details, enabling systems to handle provider assignments appropriately.

Example Use Cases

  • Automatically synchronize provider assignments in external workforce management, ERP, or scheduling systems.

  • Trigger provider notification workflows (e.g., job alerts, schedule updates, mobile app notifications).

  • Maintain synchronized provider assignment records between Sodtrack and third-party platforms.

  • Handle provider reassignment logic, including notification of previous providers when assignments change.

  • Update resource allocation and capacity planning systems based on provider commitments.

  • Track provider performance metrics by monitoring assignment frequency and patterns.

Body

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