Square icon

Square

Consume Square API

Booking → Create

AI-generated

Overview

This node operation creates a new booking in the Square system. It is useful for scheduling appointments or services at a specified location, allowing users to specify details such as appointment segments, customer information, notes, and start time. For example, a business can use this node to automate booking appointments for customers with specific team members and service variations.

Use Case Examples

  1. Creating a booking for a customer at a specific location with multiple appointment segments, each with different durations and assigned team members.
  2. Adding customer and seller notes to provide additional context for the booking.
  3. Setting the start time of the booking to coordinate schedules.

Properties

Name Meaning
Location ID The ID of the location where the booking will take place.
Additional Fields Optional fields to provide more details about the booking, including appointment segments, customer ID, customer note, seller note, and start time.

Output

JSON

  • id - The unique identifier of the created booking.
  • location_id - The location ID where the booking is scheduled.
  • start_at - The start time of the booking.
  • appointment_segments - Details of the appointment segments included in the booking.
  • customer_id - The ID of the customer who made the booking.
  • customer_note - Any note provided by the customer.
  • seller_note - Any note provided by the seller.

Dependencies

  • Square API with an API key credential for authentication

Troubleshooting

  • Ensure the Location ID is valid and exists in the Square system to avoid errors.
  • Verify that the appointment segments have valid durations and service variation IDs if provided.
  • Check that the start time is in the correct RFC 3339 format to prevent request failures.
  • If the API returns an error, review the error message for missing or invalid fields and correct them accordingly.

Links

Discussion