Setmore API and MCP server

• POST

  list_appointments

  Appointments in a date range with customer, service, team member, time and label.

  read

  Returns appointments between two days, in your account time zone, with the customer, service, team member, start and end and the label if you set one. Filter by team member or service. Use appointment_id from each item in get_appointment, reschedule_appointment and cancel_appointment.

  POST /api/v1/setmore/list_appointments

  Input

  Input: list_appointments

  Parameter	Type	Description
  from required	date	First day, in your account time zone.
  to	date	Last day. Default: same as from.
  staff_id	string	Only this team member, from list_staff.
  service_id	string	Only this service, from list_services.

  Example response

  {
    "appointments": [
      {
        "appointment_id": "apt_51d7e2b9",
        "service": "Massage, 60 min",
        "staff": "Anna",
        "customer": "Sam Client",
        "start": "2026-10-16T15:00:00-04:00",
        "end": "2026-10-16T16:00:00-04:00",
        "label": "Confirmed"
      },
      {
        "appointment_id": "apt_62e8f3ca",
        "service": "Massage, 60 min",
        "staff": "Anna",
        "customer": "Lee Customer",
        "start": "2026-10-16T17:00:00-04:00",
        "end": "2026-10-16T18:00:00-04:00",
        "label": null
      }
    ]
  }

• POST

  get_appointment

  One appointment: customer, service, team member, start and end, label and where it was booked.

  read

  Returns one appointment with the customer, service, team member, start and end, and its label. Booked via is the source Setmore assigns when the appointment is created, such as the web app, your website or Instagram. It is read only and cannot be edited.

  POST /api/v1/setmore/get_appointment

  Input

  Input: get_appointment

  Parameter	Type	Description
  appointment_id required	string	Appointment ID from list_appointments.

  Example response

  {
    "appointment_id": "apt_51d7e2b9",
    "service": "Massage, 60 min",
    "staff": "Anna",
    "customer": {
      "customer_id": "cus_7c04a1",
      "name": "Sam Client"
    },
    "start": "2026-10-16T15:00:00-04:00",
    "end": "2026-10-16T16:00:00-04:00",
    "label": "Confirmed",
    "booked_via": "Booked from website"
  }

• POST

  list_available_slots

  Open times for a service on a day, based on working hours and existing bookings.

  read

  Returns open start times for one service on one day. A team member's open times follow their working hours, not your business hours, and exclude their appointments and events. Pass a start from this list to create_appointment or reschedule_appointment.

  POST /api/v1/setmore/list_available_slots

  Input

  Input: list_available_slots

  Parameter	Type	Description
  service_id required	string	Service from list_services.
  date required	date	Day to check.
  staff_id	string	Only this team member. Default: everyone who offers the service.

  Example response

  {
    "service": "Massage, 60 min",
    "date": "2026-10-16",
    "slots": [
      {
        "staff_id": "stf_3a90de",
        "staff": "Anna",
        "start": "2026-10-16T09:00:00-04:00"
      },
      {
        "staff_id": "stf_3a90de",
        "staff": "Anna",
        "start": "2026-10-16T13:00:00-04:00"
      },
      {
        "staff_id": "stf_5b12c7",
        "staff": "Ben",
        "start": "2026-10-16T10:00:00-04:00"
      }
    ]
  }

• POST

  list_services

  Services and classes with category, cost, duration and the team members who offer them.

  read

  Lists the services and classes set up in your account, grouped by the categories you use on your Booking Page. Use service_id from each item in list_available_slots, create_appointment and get_appointment_report.

  POST /api/v1/setmore/list_services

  Input

  No parameters.

  Example response

  {
    "services": [
      {
        "service_id": "svc_8f21c4",
        "name": "Massage, 60 min",
        "category": "Massage",
        "duration_minutes": 60,
        "cost": 80,
        "staff": [
          "Anna",
          "Ben"
        ]
      },
      {
        "service_id": "svc_a19d03",
        "name": "Consultation, 30 min",
        "category": "Consultations",
        "duration_minutes": 30,
        "cost": 0,
        "staff": [
          "Anna"
        ]
      }
    ]
  }

• POST

  list_staff

  Team members with the services they offer and their working hours.

  read

  Lists the team members in your account with the services each one offers and their working days and hours. Working hours decide a team member's open times. Use staff_id from each item in the other tools.

  POST /api/v1/setmore/list_staff

  Input

  No parameters.

  Example response

  {
    "staff": [
      {
        "staff_id": "stf_3a90de",
        "name": "Anna",
        "services": [
          "Massage, 60 min",
          "Consultation, 30 min"
        ],
        "working_hours": "Mon-Fri 09:00-17:00"
      },
      {
        "staff_id": "stf_5b12c7",
        "name": "Ben",
        "services": [
          "Massage, 60 min"
        ],
        "working_hours": "Tue-Sat 10:00-18:00"
      }
    ]
  }

• POST

  find_customer

  Search customers by name, email or phone.

  read

  Searches your customer list and returns matches with contact details. Use customer_id from each item in get_customer, add_customer_note and create_appointment.

  POST /api/v1/setmore/find_customer

  Input

  Input: find_customer

  Parameter	Type	Description
  query required	string	Name, email or phone number.
  limit	integer	1 to 50. Default: 10.

  Example response

  {
    "customers": [
      {
        "customer_id": "cus_7c04a1",
        "name": "Sam Client",
        "email": "client@example.com",
        "phone": "+1 555 0100"
      }
    ]
  }

• POST

  get_customer

  Customer profile: contact details, your private notes and past and upcoming appointments.

  read

  Returns one customer with their contact details, your private notes and their past, present and future appointments, as in the Customers tab. Notes are for your reference and the customer does not see them.

  POST /api/v1/setmore/get_customer

  Input

  Input: get_customer

  Parameter	Type	Description
  customer_id required	string	Customer ID from find_customer.

  Example response

  {
    "customer_id": "cus_7c04a1",
    "name": "Sam Client",
    "email": "client@example.com",
    "phone": "+1 555 0100",
    "notes": "Prefers afternoon slots.",
    "appointments": [
      {
        "appointment_id": "apt_51d7e2b9",
        "service": "Massage, 60 min",
        "start": "2026-10-16T15:00:00-04:00"
      }
    ]
  }

• POST

  get_appointment_report

  Appointment history from Reports, filtered by date range, service, class or team member.

  read

  Returns the appointment history that Settings > Booking Page > Reports shows in the web app, with counts per team member for the filter you set. Setmore recommends ranges of no more than 3 months for best results. It reads only; nothing is exported to a file.

  POST /api/v1/setmore/get_appointment_report

  Input

  Input: get_appointment_report

  Parameter	Type	Description
  from required	date	Start date. Up to 3 months per call for best results.
  to required	date	End date.
  service_id	string	Only this service or class.
  staff_id	string	Only this team member.

  Example response

  {
    "from": "2026-09-01",
    "to": "2026-09-30",
    "service": "Massage, 60 min",
    "total_appointments": 42,
    "by_staff": [
      {
        "staff": "Anna",
        "appointments": 25
      },
      {
        "staff": "Ben",
        "appointments": 17
      }
    ]
  }

• POST

  create_appointment

  Book a service for a customer. Setmore emails the confirmation unless you turned it off.

  asks first write

  Books one service with a team member at a start time, for an existing customer or a new one. Setmore sends a booking confirmation email to the provider and the customer unless you turned it off in Settings > Notifications. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/setmore/create_appointment

  Input

  Input: create_appointment

  Parameter	Type	Description
  service_id required	string	Service from list_services.
  start required	datetime	ISO 8601 with time zone.
  customer_id	string	Existing customer from find_customer. Or pass customer.
  customer	object	New customer: name, email, phone. Add an email so the customer gets confirmations.
  staff_id	string	Team member from list_staff. Default: first one free.

  Example response

  {
    "appointment_id": "apt_51d7e2b9",
    "status": "booked",
    "service": "Massage, 60 min",
    "staff": "Anna",
    "start": "2026-10-16T15:00:00-04:00",
    "end": "2026-10-16T16:00:00-04:00",
    "customer_id": "cus_7c04a1",
    "confirmation_email": "sent"
  }

• POST

  reschedule_appointment

  Move an appointment to a new time or team member. The customer is emailed unless you turned it off.

  asks first write

  Changes the start time, the team member, or both for one appointment. Setmore emails the provider and the customer about the change unless rescheduled-appointment emails are off in Settings > Notifications. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/setmore/reschedule_appointment

  Input

  Input: reschedule_appointment

  Parameter	Type	Description
  appointment_id required	string	Appointment ID from list_appointments.
  start required	datetime	New start, ISO 8601 with time zone.
  staff_id	string	Assign a different team member.

  Example response

  {
    "appointment_id": "apt_51d7e2b9",
    "status": "rescheduled",
    "staff": "Anna",
    "start": "2026-10-20T15:00:00-04:00",
    "end": "2026-10-20T16:00:00-04:00",
    "customer_email": "sent"
  }

• POST

  cancel_appointment

  Delete an appointment from your calendar. The customer is emailed unless you turned it off.

  asks first write

  Deletes one appointment from the calendar, as Delete does in the app. Setmore notifies the provider and the customer by email unless canceled-appointment emails are off in Settings > Notifications. It cannot be undone with one call; book again with create_appointment. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/setmore/cancel_appointment

  Input

  Input: cancel_appointment

  Parameter	Type	Description
  appointment_id required	string	Appointment ID from list_appointments.

  Example response

  {
    "appointment_id": "apt_62e8f3ca",
    "status": "canceled",
    "customer_email": "sent"
  }

• POST

  set_appointment_label

  Track status with a label such as Confirmed or No-Show. Only you and your team see it.

  write

  Sets the label on one appointment, like the Label dropdown in the web app. Customers never see labels, and nothing is sent to anyone. It runs without asking first because one call sets the label back.

  POST /api/v1/setmore/set_appointment_label

  Input

  Input: set_appointment_label

  Parameter	Type	Description
  appointment_id required	string	Appointment ID from list_appointments.
  label required	string	Pending, Confirmed, Done, No-Show, Paid, Running Late or one of your custom labels.

  Example response

  {
    "appointment_id": "apt_51d7e2b9",
    "label": "No-Show",
    "previous_label": "Confirmed"
  }

• POST

  add_customer_note

  Add a private note to a customer profile. The customer does not see it.

  write

  Writes to the Notes tab of the customer profile, which is for your reference only. Nothing is sent to anyone, so it runs without asking first. A note the customer can see is an appointment comment, which this tool does not write.

  POST /api/v1/setmore/add_customer_note

  Input

  Input: add_customer_note

  Parameter	Type	Description
  customer_id required	string	Customer ID from find_customer.
  note required	string	Note text.

  Example response

  {
    "customer_id": "cus_7c04a1",
    "status": "saved",
    "note": "No-show on 16 Oct 2026."
  }

• POST

  block_time

  Add an Event to the calendar so customers cannot book that time.

  write

  Creates a Setmore Event with no guests. Customers cannot book that time on your Booking Page. Events suit blocks within a day; longer absences are Time Off under Settings > Your team, which this tool does not change. It adds no guests, so nobody is emailed and it runs without asking first; delete_event removes it.

  POST /api/v1/setmore/block_time

  Input

  Input: block_time

  Parameter	Type	Description
  start required	datetime	ISO 8601 with time zone.
  duration_minutes required	integer	Length of the block, within one day.
  staff_id	string	Whose calendar, from list_staff. Default: yours.
  notes	string	Shown on the event, for example "Lunch".

  Example response

  {
    "event_id": "evt_3d51a8",
    "status": "created",
    "staff": "Anna",
    "start": "2026-10-19T12:00:00-04:00",
    "end": "2026-10-19T13:00:00-04:00",
    "notes": "Lunch"
  }

• POST

  delete_event

  Delete an Event from the calendar and free the time.

  asks first write

  Deletes one Event, as Delete does in the app. If the event has guests, Setmore notifies them of the change. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/setmore/delete_event

  Input

  Input: delete_event

  Parameter	Type	Description
  event_id required	string	Event ID from block_time.

  Example response

  {
    "event_id": "evt_3d51a8",
    "status": "deleted"
  }

Each successful call uses credits for the work it takes; failed calls and timeouts cost nothing. A hard spend cap is on by default. Authenticate with the Authorization: Bearer header.