1. Locations
Caldasa API Docs
  • Availability
    • List availability slots
      GET
  • Bookings
    • List bookings
      GET
    • Create a booking
      POST
    • Get a booking
      GET
    • Cancel a booking
      POST
    • List signed forms
      GET
    • Get a signed-form download URL
      GET
  • Customers
    • List customers
      GET
    • Create a customer
      POST
    • Get a customer
      GET
    • Update a customer
      PATCH
    • List customer activities
      GET
    • List customer notes
      GET
    • Create a customer note
      POST
    • Update a customer note
      PATCH
    • Delete a customer note
      DELETE
    • Send a customer message
      POST
  • Events
    • List events
    • Create an event
    • Get an event
    • Update an event
    • List ticket types
    • Create a ticket type
    • Get ticket sales report
    • Publish an event
    • Cancel an event
    • Update a ticket type
    • Delete a ticket type
    • List ticket orders
    • Cancel a ticket order
    • Resend ticket QR codes
  • Forms
    • List form templates
    • Get a form template
  • Locations
    • List locations
      GET
    • Create a location
      POST
    • Get a location
      GET
    • Update a location
      PATCH
    • Delete a location
      DELETE
    • List business hours
      GET
    • Replace business hours
      PUT
    • Update location address
      PATCH
    • List location staff
      GET
    • Assign staff to a location
      POST
    • Unassign staff from a location
      DELETE
  • Orders
    • List orders
    • Get an order
  • Reservables
    • List reservables
    • Create a reservable
    • Get a reservable
    • Update a reservable
    • Delete a reservable
    • List reservable variants
    • List reservable staff
  • Resources
    • List resources
    • Create a resource
    • Get a resource
    • Update a resource
    • Delete a resource
    • List resource types
    • Create a resource type
    • Get a resource type
    • Update a resource type
    • Delete a resource type
  • Reviews
    • List reviews
    • Moderate a review
  • Staff
    • List staff members
    • Create a staff member
    • Get a staff member
    • Update a staff member
    • Delete a staff member
    • List staff shifts
    • Create a staff shift
    • List staff blocks
    • Create a staff block
    • Delete a staff shift
    • Delete a staff block
  • Tenant
    • Get the current tenant
  • Tickets
    • Redeem a ticket
  • Webhooks
    • List event types
    • Get an event-type sample
    • List webhooks
    • Create a webhook
    • Update a webhook
    • Delete a webhook
    • Rotate webhook secret
    • Send a test event
    • List webhook deliveries
  • Schemas
    • CancelPublicTicketOrderRequest
    • CreatePublicBookableEventRequest
    • CreatePublicBookingItemRequest
    • CreatePublicBookingRequest
    • CreatePublicBusinessLocationRequest
    • CreatePublicCustomerNoteRequest
    • CreatePublicCustomerRequest
    • CreatePublicReservableRequest
    • CreatePublicResourceRequest
    • CreatePublicResourceTypeRequest
    • CreatePublicStaffBlockRequest
    • CreatePublicStaffMemberRequest
    • CreatePublicStaffShiftRequest
    • CreatePublicTicketTypeRequest
    • CreatePublicWebhookSubscriptionRequest
    • ModeratePublicReviewRequest
    • ProblemDetails
    • PublicAvailabilityResponse
    • PublicAvailabilitySlotDto
    • PublicBookableEventAttendeeDto
    • PublicBookableEventBookingSummaryDto
    • PublicBookableEventDetailDto
    • PublicBookableEventDto
    • PublicBookableEventListResponse
    • PublicBookingDto
    • PublicBookingItemDto
    • PublicBookingListResponse
    • PublicBookingResourceSelection
    • PublicBusinessHourDto
    • PublicBusinessHourListResponse
    • PublicBusinessLocationDto
    • PublicBusinessLocationListResponse
    • PublicBusinessLocationStaffDto
    • PublicBusinessLocationStaffListResponse
    • PublicCustomerActivityDto
    • PublicCustomerActivityListResponse
    • PublicCustomerDto
    • PublicCustomerListResponse
    • PublicCustomerNoteDto
    • PublicCustomerNoteListResponse
    • PublicFormTemplateDto
    • PublicFormTemplateFieldDto
    • PublicFormTemplateListResponse
    • PublicOrderDetailDto
    • PublicOrderDto
    • PublicOrderLineItemDto
    • PublicOrderListResponse
    • PublicOrderTicketDto
    • PublicReservableDto
    • PublicReservableListResponse
    • PublicReservableResourceSummary
    • PublicReservableStaffDto
    • PublicReservableStaffListResponse
    • PublicReservableVariantDto
    • PublicReservableVariantListResponse
    • PublicResourceDto
    • PublicResourceListResponse
    • PublicResourceTypeDto
    • PublicResourceTypeListResponse
    • PublicReviewDto
    • PublicReviewListResponse
    • PublicSignedFormDownloadDto
    • PublicSignedFormDto
    • PublicSignedFormListResponse
    • PublicStaffBlockDto
    • PublicStaffBlockListResponse
    • PublicStaffMemberDto
    • PublicStaffMemberListResponse
    • PublicStaffShiftDto
    • PublicStaffShiftListResponse
    • PublicTenantDto
    • PublicTicketOrderDto
    • PublicTicketOrderTicketDto
    • PublicTicketOrdersResponse
    • PublicTicketRedemptionResultDto
    • PublicTicketSalesReportDto
    • PublicTicketSalesReportTier
    • PublicTicketTypeDto
    • PublicTicketTypeListResponse
    • PublicWebhookDeliveryDto
    • PublicWebhookDeliveryListResponse
    • PublicWebhookEventDescriptorDto
    • PublicWebhookEventTypeListResponse
    • PublicWebhookSubscriptionDto
    • PublicWebhookSubscriptionListResponse
    • PublicWebhookSubscriptionWithSecretDto
    • RedeemPublicTicketRequest
    • SendPublicCustomerMessageRequest
    • SendPublicCustomerMessageResult
    • UpdatePublicBookableEventRequest
    • UpdatePublicBusinessHourEntry
    • UpdatePublicBusinessHoursRequest
    • UpdatePublicBusinessLocationAddressRequest
    • UpdatePublicBusinessLocationDetailsRequest
    • UpdatePublicCustomerNoteRequest
    • UpdatePublicCustomerRequest
    • UpdatePublicReservableRequest
    • UpdatePublicResourceRequest
    • UpdatePublicResourceTypeRequest
    • UpdatePublicStaffMemberRequest
    • UpdatePublicTicketTypeRequest
    • UpdatePublicWebhookSubscriptionRequest
    • ValidationProblemDetails
  1. Locations

Create a location

POST
https://prod.your-api-server.com/locations
Last modified:2026-04-29 08:09:11

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Body Params application/json

Example
{
    "name": "string",
    "timeZoneId": "string"
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://prod.your-api-server.com/locations' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "string",
    "timeZoneId": "string"
}'

Responses

🟢201
application/json
Created
Body

Example
{
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "name": "string",
    "pageLink": "string",
    "active": true,
    "visible": true,
    "addressLine1": "string",
    "addressLine2": "string",
    "locality": "string",
    "administrativeDistrictLevel1": "string",
    "postalCode": "string",
    "country": "string",
    "phone": "string",
    "website": "string",
    "email": "string",
    "currency": "string",
    "industry": "string",
    "about": "string",
    "timeZoneId": "string",
    "createdAt": "2019-08-24T14:15:22.123Z",
    "updatedAt": "2019-08-24T14:15:22.123Z"
}
🟠400
🟠401
🟠409
🟠429
🔴500
Modified at 2026-04-29 08:09:11
Previous
List locations
Next
Get a location
Built with