Create Multiple Bookings

curl --request POST \
  --url https://api.example.com/wp-json/latepoint-api/v1/bookings/bulk \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <x-api-key>' \
  --data '
{
  "bookings": [
    {}
  ],
  "bookings[].service_id": 123,
  "bookings[].agent_id": {},
  "bookings[].start_date": "<string>",
  "bookings[].start_time": "<string>",
  "bookings[].customer_id": 123,
  "bookings[].customer.first_name": "<string>",
  "bookings[].customer.last_name": "<string>",
  "bookings[].customer.email": "<string>",
  "bookings[].customer.phone": "<string>",
  "bookings[].location_id": 123,
  "bookings[].duration": 123,
  "bookings[].status": "<string>",
  "bookings[].notes": "<string>",
  "send_confirmation": true
}
'

import requests

url = "https://api.example.com/wp-json/latepoint-api/v1/bookings/bulk"

payload = {
    "bookings": [{}],
    "bookings[].service_id": 123,
    "bookings[].agent_id": {},
    "bookings[].start_date": "<string>",
    "bookings[].start_time": "<string>",
    "bookings[].customer_id": 123,
    "bookings[].customer.first_name": "<string>",
    "bookings[].customer.last_name": "<string>",
    "bookings[].customer.email": "<string>",
    "bookings[].customer.phone": "<string>",
    "bookings[].location_id": 123,
    "bookings[].duration": 123,
    "bookings[].status": "<string>",
    "bookings[].notes": "<string>",
    "send_confirmation": True
}
headers = {
    "X-API-Key": "<x-api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<x-api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    bookings: [{}],
    'bookings[].service_id': 123,
    'bookings[].agent_id': {},
    'bookings[].start_date': '<string>',
    'bookings[].start_time': '<string>',
    'bookings[].customer_id': 123,
    'bookings[].customer.first_name': '<string>',
    'bookings[].customer.last_name': '<string>',
    'bookings[].customer.email': '<string>',
    'bookings[].customer.phone': '<string>',
    'bookings[].location_id': 123,
    'bookings[].duration': 123,
    'bookings[].status': '<string>',
    'bookings[].notes': '<string>',
    send_confirmation: true
  })
};

fetch('https://api.example.com/wp-json/latepoint-api/v1/bookings/bulk', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/wp-json/latepoint-api/v1/bookings/bulk",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'bookings' => [
        [
                
        ]
    ],
    'bookings[].service_id' => 123,
    'bookings[].agent_id' => [
        
    ],
    'bookings[].start_date' => '<string>',
    'bookings[].start_time' => '<string>',
    'bookings[].customer_id' => 123,
    'bookings[].customer.first_name' => '<string>',
    'bookings[].customer.last_name' => '<string>',
    'bookings[].customer.email' => '<string>',
    'bookings[].customer.phone' => '<string>',
    'bookings[].location_id' => 123,
    'bookings[].duration' => 123,
    'bookings[].status' => '<string>',
    'bookings[].notes' => '<string>',
    'send_confirmation' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/wp-json/latepoint-api/v1/bookings/bulk"

	payload := strings.NewReader("{\n  \"bookings\": [\n    {}\n  ],\n  \"bookings[].service_id\": 123,\n  \"bookings[].agent_id\": {},\n  \"bookings[].start_date\": \"<string>\",\n  \"bookings[].start_time\": \"<string>\",\n  \"bookings[].customer_id\": 123,\n  \"bookings[].customer.first_name\": \"<string>\",\n  \"bookings[].customer.last_name\": \"<string>\",\n  \"bookings[].customer.email\": \"<string>\",\n  \"bookings[].customer.phone\": \"<string>\",\n  \"bookings[].location_id\": 123,\n  \"bookings[].duration\": 123,\n  \"bookings[].status\": \"<string>\",\n  \"bookings[].notes\": \"<string>\",\n  \"send_confirmation\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-Key", "<x-api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.example.com/wp-json/latepoint-api/v1/bookings/bulk")
  .header("X-API-Key", "<x-api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"bookings\": [\n    {}\n  ],\n  \"bookings[].service_id\": 123,\n  \"bookings[].agent_id\": {},\n  \"bookings[].start_date\": \"<string>\",\n  \"bookings[].start_time\": \"<string>\",\n  \"bookings[].customer_id\": 123,\n  \"bookings[].customer.first_name\": \"<string>\",\n  \"bookings[].customer.last_name\": \"<string>\",\n  \"bookings[].customer.email\": \"<string>\",\n  \"bookings[].customer.phone\": \"<string>\",\n  \"bookings[].location_id\": 123,\n  \"bookings[].duration\": 123,\n  \"bookings[].status\": \"<string>\",\n  \"bookings[].notes\": \"<string>\",\n  \"send_confirmation\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/wp-json/latepoint-api/v1/bookings/bulk")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<x-api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"bookings\": [\n    {}\n  ],\n  \"bookings[].service_id\": 123,\n  \"bookings[].agent_id\": {},\n  \"bookings[].start_date\": \"<string>\",\n  \"bookings[].start_time\": \"<string>\",\n  \"bookings[].customer_id\": 123,\n  \"bookings[].customer.first_name\": \"<string>\",\n  \"bookings[].customer.last_name\": \"<string>\",\n  \"bookings[].customer.email\": \"<string>\",\n  \"bookings[].customer.phone\": \"<string>\",\n  \"bookings[].location_id\": 123,\n  \"bookings[].duration\": 123,\n  \"bookings[].status\": \"<string>\",\n  \"bookings[].notes\": \"<string>\",\n  \"send_confirmation\": true\n}"

response = http.request(request)
puts response.read_body

POST

wp-json

latepoint-api

bookings

bulk

Create Multiple Bookings

curl --request POST \
  --url https://api.example.com/wp-json/latepoint-api/v1/bookings/bulk \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <x-api-key>' \
  --data '
{
  "bookings": [
    {}
  ],
  "bookings[].service_id": 123,
  "bookings[].agent_id": {},
  "bookings[].start_date": "<string>",
  "bookings[].start_time": "<string>",
  "bookings[].customer_id": 123,
  "bookings[].customer.first_name": "<string>",
  "bookings[].customer.last_name": "<string>",
  "bookings[].customer.email": "<string>",
  "bookings[].customer.phone": "<string>",
  "bookings[].location_id": 123,
  "bookings[].duration": 123,
  "bookings[].status": "<string>",
  "bookings[].notes": "<string>",
  "send_confirmation": true
}
'

import requests

url = "https://api.example.com/wp-json/latepoint-api/v1/bookings/bulk"

payload = {
    "bookings": [{}],
    "bookings[].service_id": 123,
    "bookings[].agent_id": {},
    "bookings[].start_date": "<string>",
    "bookings[].start_time": "<string>",
    "bookings[].customer_id": 123,
    "bookings[].customer.first_name": "<string>",
    "bookings[].customer.last_name": "<string>",
    "bookings[].customer.email": "<string>",
    "bookings[].customer.phone": "<string>",
    "bookings[].location_id": 123,
    "bookings[].duration": 123,
    "bookings[].status": "<string>",
    "bookings[].notes": "<string>",
    "send_confirmation": True
}
headers = {
    "X-API-Key": "<x-api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<x-api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    bookings: [{}],
    'bookings[].service_id': 123,
    'bookings[].agent_id': {},
    'bookings[].start_date': '<string>',
    'bookings[].start_time': '<string>',
    'bookings[].customer_id': 123,
    'bookings[].customer.first_name': '<string>',
    'bookings[].customer.last_name': '<string>',
    'bookings[].customer.email': '<string>',
    'bookings[].customer.phone': '<string>',
    'bookings[].location_id': 123,
    'bookings[].duration': 123,
    'bookings[].status': '<string>',
    'bookings[].notes': '<string>',
    send_confirmation: true
  })
};

fetch('https://api.example.com/wp-json/latepoint-api/v1/bookings/bulk', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/wp-json/latepoint-api/v1/bookings/bulk",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'bookings' => [
        [
                
        ]
    ],
    'bookings[].service_id' => 123,
    'bookings[].agent_id' => [
        
    ],
    'bookings[].start_date' => '<string>',
    'bookings[].start_time' => '<string>',
    'bookings[].customer_id' => 123,
    'bookings[].customer.first_name' => '<string>',
    'bookings[].customer.last_name' => '<string>',
    'bookings[].customer.email' => '<string>',
    'bookings[].customer.phone' => '<string>',
    'bookings[].location_id' => 123,
    'bookings[].duration' => 123,
    'bookings[].status' => '<string>',
    'bookings[].notes' => '<string>',
    'send_confirmation' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/wp-json/latepoint-api/v1/bookings/bulk"

	payload := strings.NewReader("{\n  \"bookings\": [\n    {}\n  ],\n  \"bookings[].service_id\": 123,\n  \"bookings[].agent_id\": {},\n  \"bookings[].start_date\": \"<string>\",\n  \"bookings[].start_time\": \"<string>\",\n  \"bookings[].customer_id\": 123,\n  \"bookings[].customer.first_name\": \"<string>\",\n  \"bookings[].customer.last_name\": \"<string>\",\n  \"bookings[].customer.email\": \"<string>\",\n  \"bookings[].customer.phone\": \"<string>\",\n  \"bookings[].location_id\": 123,\n  \"bookings[].duration\": 123,\n  \"bookings[].status\": \"<string>\",\n  \"bookings[].notes\": \"<string>\",\n  \"send_confirmation\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-Key", "<x-api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.example.com/wp-json/latepoint-api/v1/bookings/bulk")
  .header("X-API-Key", "<x-api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"bookings\": [\n    {}\n  ],\n  \"bookings[].service_id\": 123,\n  \"bookings[].agent_id\": {},\n  \"bookings[].start_date\": \"<string>\",\n  \"bookings[].start_time\": \"<string>\",\n  \"bookings[].customer_id\": 123,\n  \"bookings[].customer.first_name\": \"<string>\",\n  \"bookings[].customer.last_name\": \"<string>\",\n  \"bookings[].customer.email\": \"<string>\",\n  \"bookings[].customer.phone\": \"<string>\",\n  \"bookings[].location_id\": 123,\n  \"bookings[].duration\": 123,\n  \"bookings[].status\": \"<string>\",\n  \"bookings[].notes\": \"<string>\",\n  \"send_confirmation\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/wp-json/latepoint-api/v1/bookings/bulk")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<x-api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"bookings\": [\n    {}\n  ],\n  \"bookings[].service_id\": 123,\n  \"bookings[].agent_id\": {},\n  \"bookings[].start_date\": \"<string>\",\n  \"bookings[].start_time\": \"<string>\",\n  \"bookings[].customer_id\": 123,\n  \"bookings[].customer.first_name\": \"<string>\",\n  \"bookings[].customer.last_name\": \"<string>\",\n  \"bookings[].customer.email\": \"<string>\",\n  \"bookings[].customer.phone\": \"<string>\",\n  \"bookings[].location_id\": 123,\n  \"bookings[].duration\": 123,\n  \"bookings[].status\": \"<string>\",\n  \"bookings[].notes\": \"<string>\",\n  \"send_confirmation\": true\n}"

response = http.request(request)
puts response.read_body

Description

This endpoint allows you to create multiple bookings at once in your LatePoint system. It includes automatic availability validation for all bookings, creation of new customers if necessary, and comprehensive error handling for partial failures. Key Features:

Create up to 50 bookings in a single request
Automatic availability validation for all bookings before creation
Support for both existing and new customers
Partial success handling (some bookings may succeed while others fail)
Detailed error reporting for each failed booking
Optional confirmation email sending

Authentication

string

required

Your LatePoint API key. You can get it from the admin panel.

Request Body

Required Fields

array

required

Array of booking objects to create (maximum 50 bookings per request)

Booking Object Structure

Each booking object in the bookings array must contain:

integer

required

ID of the service to book

integer|string

required

ID of the agent who will provide the service. Use “any” or “-1” for automatic agent assignment based on availability

string

required

Booking date (format: YYYY-MM-DD)

string

required

Start time (format: HH:MM in 24-hour format)

Customer Information (per booking)

integer

ID of an existing customer. If provided, new customer fields are ignored

string

Customer first name (required if customer_id is not provided)

string

Customer last name (required if customer_id is not provided)

string

Customer email (required if customer_id is not provided)

string

Customer phone number

Optional Fields (per booking)

integer

ID of the location where the service will be provided. If not specified, the default location will be used

integer

Duration of the booking in minutes. If not provided, the service’s default duration will be used

string

Booking status. Defaults to ‘approved’

string

Additional notes for the booking

Global Options

boolean

Whether to send confirmation emails for successfully created bookings. Defaults to false

Request Example

{
  "bookings": [
    {
      "service_id": 2,
      "agent_id": 1,
      "start_date": "2025-09-01",
      "start_time": "16:00",
      "customer": {
        "first_name": "Ana",
        "last_name": "López",
        "email": "ana.lopez@email.com",
        "phone": "+52 555 987 6543"
      },
      "status": "pending",
      "notes": "Primera reserva"
    },
    {
      "service_id": 3,
      "agent_id": 2,
      "start_date": "2025-09-02",
      "start_time": "10:00",
      "customer_id": 15,
      "status": "approved"
    },
    {
      "service_id": 2,
      "agent_id": 1,
      "start_date": "2025-09-03",
      "start_time": "14:30",
      "customer": {
        "first_name": "Carlos",
        "last_name": "Mendoza",
        "email": "carlos.mendoza@email.com",
        "phone": "+52 555 123 4567"
      }
    }
  ],
  "send_confirmation": true
}

Response Format

The response includes detailed information about the success and failure of each booking creation:

Success Response (201 Created)

{
  "success": true,
  "message": "Bulk booking operation completed. 3 successful, 0 failed out of 3 total.",
  "results": {
    "success": [
      {
        "index": 0,
        "booking_id": 123,
        "data": {
          "id": 123,
          "booking_code": "BK123456",
          "service": {
            "id": 2,
            "name": "Consulta General"
          },
          "agent": {
            "id": 1,
            "full_name": "Dr. García"
          },
          "customer": {
            "id": 45,
            "full_name": "Ana López",
            "email": "ana.lopez@email.com"
          },
          "start_date": "2025-09-01",
          "start_time": "16:00",
          "status": "pending"
        },
        "confirmation_sent": true
      }
    ],
    "errors": [],
    "summary": {
      "total_requested": 3,
      "successful": 3,
      "failed": 0
    }
  }
}

Partial Success Response (207 Multi-Status)

{
  "success": true,
  "message": "Bulk booking operation completed. 2 successful, 1 failed out of 3 total.",
  "results": {
    "success": [
      {
        "index": 0,
        "booking_id": 123,
        "data": {
          "id": 123,
          "booking_code": "BK123456",
          "service": {
            "id": 2,
            "name": "Consulta General"
          },
          "agent": {
            "id": 1,
            "full_name": "Dr. García"
          },
          "customer": {
            "id": 45,
            "full_name": "Ana López",
            "email": "ana.lopez@email.com"
          },
          "start_date": "2025-09-01",
          "start_time": "16:00",
          "status": "pending"
        },
        "confirmation_sent": true
      }
    ],
    "errors": [
      {
        "index": 1,
        "error": "Time slot not available",
        "booking_data": {
          "service_id": 3,
          "agent_id": 2,
          "start_date": "2025-09-02",
          "start_time": "10:00",
          "customer_id": 15
        }
      }
    ],
    "summary": {
      "total_requested": 3,
      "successful": 2,
      "failed": 1
    }
  }
}

Error Response (400 Bad Request)

{
  "success": false,
  "message": "Bulk booking operation completed. 0 successful, 3 failed out of 3 total.",
  "results": {
    "success": [],
    "errors": [
      {
        "index": 0,
        "error": "Missing required field: service_id",
        "booking_data": {
          "agent_id": 1,
          "start_date": "2025-09-01",
          "start_time": "16:00"
        }
      },
      {
        "index": 1,
        "error": "Time slot not available",
        "booking_data": {
          "service_id": 3,
          "agent_id": 2,
          "start_date": "2025-09-02",
          "start_time": "10:00",
          "customer_id": 15
        }
      }
    ],
    "summary": {
      "total_requested": 3,
      "successful": 0,
      "failed": 3
    }
  }
}

Response Status Codes

201 Created: All bookings were created successfully
207 Multi-Status: Some bookings were created successfully, others failed
400 Bad Request: All bookings failed or invalid request format
503 Service Unavailable: LatePoint is not available

Error Handling

The endpoint uses a two-phase approach:

Validation Phase: All bookings are validated for required fields and availability
Creation Phase: Only validated bookings are created

This ensures that:

No partial data corruption occurs
Clear error reporting for each failed booking
Successful bookings are not affected by failed ones

Usage Examples

cURL Example

curl -X POST "http://latepoint-dev.local/wp-json/latepoint-api/v1/bookings/bulk" \
  -H "X-API-Key: lp_n1k6BVf3h7JRyjXkWMSoXi0BBZYRaOLL4QohDPQJ" \
  -H "Content-Type: application/json" \
  -d '{
    "bookings": [
      {
        "service_id": 2,
        "agent_id": 1,
        "start_date": "2025-09-01",
        "start_time": "16:00",
        "customer": {
          "first_name": "Ana",
          "last_name": "López",
          "email": "ana.lopez@email.com",
          "phone": "+52 555 987 6543"
        },
        "status": "pending"
      },
      {
        "service_id": 3,
        "agent_id": 2,
        "start_date": "2025-09-02",
        "start_time": "10:00",
        "customer_id": 15
      }
    ],
    "send_confirmation": true
  }'

Limitations

Maximum 50 bookings per request
Each booking must pass availability validation
Customer email must be unique when creating new customers
All standard LatePoint business rules apply to each booking

Integration Notes

This endpoint is perfect for:

Importing bookings from external systems
Creating recurring appointments
Batch booking operations
Integration with calendar systems

For single booking creation, use the standard POST /bookings endpoint for better performance.

Core Concepts

Bookings

Customers

Agents

Services

Payments

Orders

Coupons

Locations

Availability

System

Create Multiple Bookings

Description

Authentication

Request Body

Required Fields

Booking Object Structure

Customer Information (per booking)

Optional Fields (per booking)

Global Options

Request Example

Response Format

Success Response (201 Created)

Partial Success Response (207 Multi-Status)

Error Response (400 Bad Request)

Response Status Codes

Error Handling

Usage Examples

cURL Example

Limitations

Integration Notes

​Description

​Authentication

​Request Body

​Required Fields

​Booking Object Structure

​Customer Information (per booking)

​Optional Fields (per booking)

​Global Options

​Request Example

​Response Format

​Success Response (201 Created)

​Partial Success Response (207 Multi-Status)

​Error Response (400 Bad Request)

​Response Status Codes

​Error Handling

​Usage Examples

​cURL Example

​Limitations

​Integration Notes

Description

Authentication

Request Body

Required Fields

Booking Object Structure

Customer Information (per booking)

Optional Fields (per booking)

Global Options

Request Example

Response Format

Success Response (201 Created)

Partial Success Response (207 Multi-Status)

Error Response (400 Bad Request)

Response Status Codes

Error Handling

Usage Examples

cURL Example

Limitations

Integration Notes