Create Webhook

POST /staff/v1/businessLocations/{businessLocationId}/webhooks

O auth2

Path parameters

businessLocationId integer(int64) Required

The unique identifier for the business location.

application/json

Body Required

notificationType string Required

The type of webhook notification.

Values are shift.created, shift.updated, or shift.deleted.
url string(uri) Required

The URL for the webhook.
webhookName string Required

The name for the webhook.

Responses

200 application/json

Webhook Created
Hide response attributes Show response attributes object
- uuid string(uuid)
  
  The unique identifier for the webhook.
- notificationType string
  
  The type of webhook notification.
  
  Values are shift.created, shift.updated, or shift.deleted.
- url string
  
  The URL for the webhook.
- webhookName string
  
  The name for the webhook.
- businessLocationId integer(int64)
  
  The unique identifier for the business location.
- createdAt string(date-time)
  
  The creation time of the webhook.
- updatedAt string(date-time)
  
  The last update time of the webhook.

POST /staff/v1/businessLocations/{businessLocationId}/webhooks

curl \
 --request POST 'https://api.trial.lsk.lightspeed.app/staff/v1/businessLocations/{businessLocationId}/webhooks' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{"notificationType":"shift.created","url":"https://example.com","webhookName":"string"}'

Request examples

{
  "notificationType": "shift.created",
  "url": "https://example.com",
  "webhookName": "string"
}

Response examples (200)

{
  "uuid": "e95c2cc5-4489-4025-a7e2-a34faeaa5f9d",
  "notificationType": "shift.created",
  "url": "string",
  "webhookName": "My Awesome Webhook",
  "businessLocationId": 1234567890,
  "createdAt": "2025-05-04T09:42:00Z",
  "updatedAt": "2025-05-04T09:42:00Z"
}