# Acuity Scheduling

> Run your Acuity Scheduling bookings from workflows: find open times, book, reschedule and cancel appointments, manage clients and blocked time, and start a workflow when an appointment is booked, rescheduled or canceled.

App · 25 actions. Web page: https://docs.lodol.com/docs/integrations/acuity-scheduling

## Actions

### Add client

Add a client to the client list. Acuity refuses a client it already has.

**Inputs**

- First name (`first_name`, text, required): The client's first name.
- Last name (`last_name`, text, required): The client's last name.
- Email (`email`, text): The client's email address.
- Phone (`phone`, text): The client's phone number.
- Notes (`notes`, text): Notes kept on the client.

**Outputs**

- `client` (object): The client

**Example output**

```json
{
  "client": {
    "email": "",
    "first_name": "Bob",
    "last_name": "Burger",
    "notes": "",
    "phone": "555-555-5555"
  }
}
```

### Block off time

Block off time on a calendar, such as a holiday or a meeting, so nobody can book it.

**Inputs**

- Calendar (`calendar_id`, text, required): The calendar to block time on.
- Start (`start`, date and time, required): When the blocked time starts.
- End (`end`, date and time, required): When the blocked time ends.
- Notes (`notes`, text): Why it is blocked, shown on the calendar.

**Outputs**

- `block` (object): The blocked time

**Example output**

```json
{
  "block": {
    "calendar_id": "1",
    "description": "Wednesday 17 June 2015 3:00am - 4:00am",
    "end": "2015-06-17T04:00:00-07:00",
    "id": "174453240",
    "notes": "Test 1",
    "recurring": "",
    "start": "2015-06-17T03:00:00-07:00",
    "until": ""
  }
}
```

### Book appointment

Book an appointment for a client at an open time (use 'Get available times' to find one). Acuity emails the client a confirmation unless switched off.

**Inputs**

- Appointment type (`appointment_type_id`, text, required): The service or class. Pick one, or give its id.
- Date and time (`start_time`, date and time, required): When the appointment starts. A time from 'Get available times' can be used as it is.
- First name (`first_name`, text, required): The client's first name.
- Last name (`last_name`, text, required): The client's last name.
- Email (`email`, text): The client's email address. Required unless booking even if the time isn't open.
- Phone (`phone`, text): The client's phone number.
- Calendar (`calendar_id`, text): Whose calendar to book on. Leave empty for Acuity to pick one with the time open.
- Client's time zone (`time_zone`, text): The time zone the client sees times in, such as America/New_York. Defaults to the business's.
- Label (`label_id`, text): A label to mark the appointment with, such as Confirmed.
- Package or coupon code (`certificate`, text): A package, gift certificate or coupon code to apply.
- Intake form answers (`form_answers`, object): Answers to the appointment type's intake form questions. For a checkbox list, separate the choices with commas.
- Book even if the time isn't open (`book_anyway`, true/false): Book as the business, skipping Acuity's availability and booking rules. Needs a calendar. Default: `false`.
- Email the client (`send_confirmation`, true/false): Send Acuity's confirmation email and text message. Default: `true`.

**Outputs**

- `appointment` (object): The appointment

**Example output**

```json
{
  "appointment": {
    "amount_paid": 0.0,
    "answers": [
      {
        "answer": "yes",
        "form": "Example Intake Form",
        "question": "Is this your first visit?",
        "question_id": "1"
      },
      {
        "answer": "Ninja",
        "form": "Example Intake Form",
        "question": "What is your goal for this appointment?",
        "question_id": "2"
      }
    ],
    "appointment_type": "Regular Visit",
    "appointment_type_id": "1",
    "calendar": "My Calendar",
    "calendar_id": "27238",
    "certificate": "",
    "class_id": "",
    "confirmation_page": "https://acuityscheduling.com/schedule.php?owner=11145481&id[]=1220aa9f41091c50c0cc659385cfa1d0&action=appt",
    "created_on": "2013-07-02",
    "date": "June 17, 2013",
    "datetime": "2013-06-17T10:15:00-07:00",
    "duration_minutes": 60.0,
    "email": "bob.mctest@example.com",
    "end_datetime": "2013-06-17T11:15:00-07:00",
    "end_time": "11:15am",
    "first_name": "Bob",
    "id": "54321",
    "label": "Completed",
    "labels": [
      {
        "color": "pink",
        "id": "3",
        "name": "Completed"
      }
    ],
    "last_name": "McTest",
    "location": "",
    "no_show": false,
    "notes": "Notes",
    "paid": false,
    "phone": "",
    "price": 10.0,
    "time": "10:15am",
    "timezone": "America/New_York"
  }
}
```

### Cancel appointment

Cancel an appointment as the business, optionally marking it a no-show. A canceled appointment can't be restored.

**Inputs**

- Appointment ID (`appointment_id`, text, required): The appointment's id, from 'List appointments', 'Book appointment' or a trigger.
- Message to the client (`reason`, text): Sent with the cancellation email.
- No-show (`no_show`, true/false): Mark it as a no-show rather than a cancellation. Default: `false`.
- Email the client (`send_notification`, true/false): Send Acuity's email and text message about the change. Default: `true`.

**Outputs**

- `appointment` (object): The appointment

**Example output**

```json
{
  "appointment": {
    "amount_paid": 0.0,
    "answers": [
      {
        "answer": "yes",
        "form": "Example Intake Form",
        "question": "Is this your first visit?",
        "question_id": "1"
      },
      {
        "answer": "Ninja",
        "form": "Example Intake Form",
        "question": "What is your goal for this appointment?",
        "question_id": "2"
      }
    ],
    "appointment_type": "Regular Visit",
    "appointment_type_id": "1",
    "calendar": "My Calendar",
    "calendar_id": "1",
    "certificate": "",
    "class_id": "",
    "confirmation_page": "https://acuityscheduling.com/schedule.php?owner=11145481&id[]=1220aa9f41091c50c0cc659385cfa1d0&action=appt",
    "created_on": "2013-07-02",
    "date": "June 17, 2013",
    "datetime": "2013-06-17T10:15:00-07:00",
    "duration_minutes": 60.0,
    "email": "bob.mctest@example.com",
    "end_datetime": "2013-06-17T11:15:00-07:00",
    "end_time": "11:15am",
    "first_name": "Bob",
    "id": "1",
    "label": "Completed",
    "labels": [
      {
        "color": "pink",
        "id": "3",
        "name": "Completed"
      }
    ],
    "last_name": "McTest",
    "location": "",
    "no_show": false,
    "notes": "Notes",
    "paid": false,
    "phone": "",
    "price": 10.0,
    "time": "10:15am",
    "timezone": "America/New_York"
  }
}
```

### Check a time is open

Check whether a time can be booked for an appointment type, and if not, why. A time that isn't open is an answer, not an error.

**Inputs**

- Appointment type (`appointment_type_id`, text, required): The service or class. Pick one, or give its id.
- Date and time (`start_time`, date and time, required): The time to check.
- Calendar (`calendar_id`, text): Only this calendar. Leave empty for every calendar the appointment type is offered on.

**Outputs**

- `available` (true/false): Whether it can be booked
- `calendar_id` (text): The calendar checked
- `datetime` (text): The time checked
- `reason` (text): Why not, when it can't

**Example output**

```json
{
  "available": true,
  "calendar_id": "1",
  "datetime": "2017-11-15T16:00:00-0800",
  "reason": ""
}
```

### Check package or coupon code

Check whether a package, gift certificate or coupon code can be used for an appointment type, and if not, why.

**Inputs**

- Code (`code`, text, required): The package, gift certificate or coupon code.
- Appointment type (`appointment_type_id`, text, required): The service or class. Pick one, or give its id.
- Client email (`email`, text): Also check the code for this client, such as a coupon each client may use once.

**Outputs**

- `certificate` (object): The code
- `reason` (text): Why not, when it can't
- `valid` (true/false): Whether it can be used

**Example output**

```json
{
  "certificate": {
    "appointment_type_ids": [
      "1"
    ],
    "code": "BFB0E13E",
    "email": "",
    "expiration": "",
    "id": "1",
    "kind": "appointments",
    "name": "5 Small Builds",
    "order_id": "",
    "product_id": "1",
    "remaining_minutes": 0.0
  },
  "reason": "",
  "valid": true
}
```

### Delete blocked time

Remove blocked-off time, so the time can be booked again.

**Inputs**

- Blocked time ID (`block_id`, text, required): The blocked time's id, from 'List blocked times' or 'Block off time'.

**Outputs**

- `block_id` (text): The blocked time deleted
- `deleted` (true/false): Always true once deleted

**Example output**

```json
{
  "block_id": "174453240",
  "deleted": true
}
```

### Delete client

Delete a client from the client list, found by first and last name.

**Inputs**

- First name (`first_name`, text, required): The client's first name, exactly as in Acuity.
- Last name (`last_name`, text, required): The client's last name, exactly as in Acuity.
- Phone (`phone`, text): The client's phone number, to tell apart two clients with the same name.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `first_name` (text): The client's first name
- `last_name` (text): The client's last name

**Example output**

```json
{
  "deleted": true,
  "first_name": "Bob",
  "last_name": "McTest"
}
```

### Get account

Get the Acuity account: business name, email, time zone, currency, plan and scheduling page.

**Inputs**: None.

**Outputs**

- `account` (object): The account

**Example output**

```json
{
  "account": {
    "currency": "USD",
    "description": "",
    "email": "example@acuityscheduling.com",
    "id": "1",
    "name": "Example",
    "plan": "Professional",
    "scheduling_page": "https://example.acuityscheduling.com/",
    "time_format": "ampm",
    "timezone": "America/New_York"
  }
}
```

### Get appointment

Get one appointment with its client, time, calendar, price, label and intake form answers.

**Inputs**

- Appointment ID (`appointment_id`, text, required): The appointment's id, from 'List appointments', 'Book appointment' or a trigger.

**Outputs**

- `appointment` (object): The appointment

**Example output**

```json
{
  "appointment": {
    "amount_paid": 0.0,
    "answers": [
      {
        "answer": "yes",
        "form": "Example Intake Form",
        "question": "Is this your first visit?",
        "question_id": "1"
      },
      {
        "answer": "Ninja",
        "form": "Example Intake Form",
        "question": "What is your goal for this appointment?",
        "question_id": "2"
      }
    ],
    "appointment_type": "Regular Visit",
    "appointment_type_id": "1",
    "calendar": "My Calendar",
    "calendar_id": "27238",
    "certificate": "",
    "class_id": "",
    "confirmation_page": "https://acuityscheduling.com/schedule.php?owner=11145481&id[]=1220aa9f41091c50c0cc659385cfa1d0&action=appt",
    "created_on": "2013-07-02",
    "date": "June 17, 2013",
    "datetime": "2013-06-17T10:15:00-07:00",
    "duration_minutes": 60.0,
    "email": "bob.mctest@example.com",
    "end_datetime": "2013-06-17T11:15:00-07:00",
    "end_time": "11:15am",
    "first_name": "Bob",
    "id": "54321",
    "label": "Completed",
    "labels": [
      {
        "color": "pink",
        "id": "3",
        "name": "Completed"
      }
    ],
    "last_name": "McTest",
    "location": "",
    "no_show": false,
    "notes": "Notes",
    "paid": false,
    "phone": "",
    "price": 10.0,
    "time": "10:15am",
    "timezone": "America/New_York"
  }
}
```

### Get available dates

List the days in a month that have open times for an appointment type, as clients see them.

**Inputs**

- Appointment type (`appointment_type_id`, text, required): The service or class. Pick one, or give its id.
- Month (`month`, date): Pick any day in the month. Defaults to this month.
- Calendar (`calendar_id`, text): Only this calendar. Leave empty for every calendar the appointment type is offered on.
- Time zone (`time_zone`, text): Show times in this time zone. Defaults to the business's.

**Outputs**

- `count` (number): How many are returned
- `dates` (list): Days with open times
- `month` (text): The month (YYYY-MM)

**Example output**

```json
{
  "count": 2,
  "dates": [
    "2016-02-04",
    "2016-02-05"
  ],
  "month": "2016-02"
}
```

### Get available times

List the open start times on a day for an appointment type. Each can be booked with 'Book appointment' as it is.

**Inputs**

- Appointment type (`appointment_type_id`, text, required): The service or class. Pick one, or give its id.
- Date (`day`, date, required): The day to look at.
- Calendar (`calendar_id`, text): Only this calendar. Leave empty for every calendar the appointment type is offered on.
- Time zone (`time_zone`, text): Show times in this time zone. Defaults to the business's.

**Outputs**

- `count` (number): How many are returned
- `date` (text): The day (YYYY-MM-DD)
- `times` (list): Open start times

**Example output**

```json
{
  "count": 2,
  "date": "2016-02-04",
  "times": [
    "2016-02-04T13:00:00-0800",
    "2016-02-04T14:00:00-0800"
  ]
}
```

### List appointment payments

List the payments taken for an appointment, with the amount, date and payment processor.

**Inputs**

- Appointment ID (`appointment_id`, text, required): The appointment's id, from 'List appointments', 'Book appointment' or a trigger.

**Outputs**

- `count` (number): How many are returned
- `payments` (list): The payments
- `total` (number): The payments added up

**Example output**

```json
{
  "count": 1,
  "payments": [
    {
      "amount": 300.0,
      "created": "2016-01-22T09:27:51-08:00",
      "processor": "stripe",
      "transaction_id": "pi_123456abcdef"
    }
  ],
  "total": 300.0
}
```

### List appointment types

List the services and classes people can book, with length, price and the calendars each is offered on.

**Inputs**: None.

**Outputs**

- `appointment_types` (list): The appointment types
- `count` (number): How many are returned

**Example output**

```json
{
  "appointment_types": [
    {
      "active": true,
      "calendar_ids": [
        "1"
      ],
      "category": "Parties",
      "class_size": 0.0,
      "color": "#E3DE7D",
      "description": "",
      "duration_minutes": 150.0,
      "id": "5",
      "kind": "service",
      "name": "Lego Party",
      "price": 200.0,
      "private": false
    }
  ],
  "count": 1
}
```

### List appointments

Find appointments by date, calendar, appointment type or client, latest first. Canceled ones are left out unless asked for.

**Inputs**

- From (`min_date`, date): Only those on or after this day.
- To (`max_date`, date): Only those on or before this day.
- Calendar (`calendar_id`, text): Only this calendar.
- Appointment type (`appointment_type_id`, text): Only this service or class.
- Status (`status`, text): Scheduled appointments, canceled ones, or both. One of: `scheduled` (Scheduled (default)), `canceled`, `all` (Scheduled and canceled). Default: `scheduled`.
- Client email (`email`, text): Only this client's appointments, by email address.
- Client first name (`first_name`, text): Only clients with this first name.
- Client last name (`last_name`, text): Only clients with this last name.
- Client phone (`phone`, text): Only clients with this phone number.
- Order (`order`, text): Latest appointment first, or earliest first. One of: `latest` (Latest first (default)), `earliest` (Earliest first). Default: `latest`.
- Most to return (`limit`, number): How many to return at most, 1 to 1000. Defaults to 100. From 1 to 1000.

**Outputs**

- `appointments` (list): The matching appointments
- `count` (number): How many are returned

**Example output**

```json
{
  "appointments": [
    {
      "amount_paid": 0.0,
      "answers": [
        {
          "answer": "yes",
          "form": "Example Intake Form",
          "question": "Is this your first visit?",
          "question_id": "1"
        },
        {
          "answer": "Ninja",
          "form": "Example Intake Form",
          "question": "What is your goal for this appointment?",
          "question_id": "2"
        }
      ],
      "appointment_type": "Regular Visit",
      "appointment_type_id": "1",
      "calendar": "My Calendar",
      "calendar_id": "27238",
      "certificate": "",
      "class_id": "",
      "confirmation_page": "https://acuityscheduling.com/schedule.php?owner=11145481&id[]=1220aa9f41091c50c0cc659385cfa1d0&action=appt",
      "created_on": "2013-07-02",
      "date": "June 17, 2013",
      "datetime": "2013-06-17T10:15:00-07:00",
      "duration_minutes": 60.0,
      "email": "bob.mctest@example.com",
      "end_datetime": "2013-06-17T11:15:00-07:00",
      "end_time": "11:15am",
      "first_name": "Bob",
      "id": "54321",
      "label": "Completed",
      "labels": [
        {
          "color": "pink",
          "id": "3",
          "name": "Completed"
        }
      ],
      "last_name": "McTest",
      "location": "",
      "no_show": false,
      "notes": "Notes",
      "paid": false,
      "phone": "",
      "price": 10.0,
      "time": "10:15am",
      "timezone": "America/New_York"
    }
  ],
  "count": 1
}
```

### List blocked times

List the time blocked off on calendars, so nobody can book it.

**Inputs**

- From (`min_date`, date): Only those on or after this day.
- To (`max_date`, date): Only those on or before this day.
- Calendar (`calendar_id`, text): Only this calendar.
- Most to return (`limit`, number): How many to return at most, 1 to 1000. Defaults to 100. From 1 to 1000.

**Outputs**

- `blocks` (list): The blocked times
- `count` (number): How many are returned

**Example output**

```json
{
  "blocks": [
    {
      "calendar_id": "1",
      "description": "Wednesday  1 July 2015 11:00am - 12:00pm",
      "end": "2015-07-01T12:00:00-07:00",
      "id": "1",
      "notes": "Blocked time.",
      "recurring": "",
      "start": "2015-07-01T11:00:00-07:00",
      "until": ""
    }
  ],
  "count": 1
}
```

### List calendars

List the calendars appointments are booked on: the people, rooms or resources of the business.

**Inputs**: None.

**Outputs**

- `calendars` (list): The calendars
- `count` (number): How many are returned

**Example output**

```json
{
  "calendars": [
    {
      "description": "",
      "email": "joecontractor@example.com",
      "id": "4321",
      "location": "",
      "name": "Joe",
      "reply_to": "joecontractor@example.com",
      "timezone": "America/New_York"
    }
  ],
  "count": 1
}
```

### List class times

List the class times in a month that still have places, with how many are left.

**Inputs**

- Month (`month`, date): Pick any day in the month. Defaults to this month.
- Appointment type (`appointment_type_id`, text): Only this service or class.
- Calendar (`calendar_id`, text): Only this calendar.
- Time zone (`time_zone`, text): Show times in this time zone. Defaults to the business's.

**Outputs**

- `classes` (list): The class times
- `count` (number): How many are returned
- `month` (text): The month (YYYY-MM)

**Example output**

```json
{
  "classes": [
    {
      "appointment_type_id": "8",
      "calendar": "More Calendar",
      "calendar_id": "2",
      "duration_minutes": 30.0,
      "id": "1",
      "name": "Become a Better Builder",
      "series": false,
      "slots": 8.0,
      "slots_available": 8.0,
      "time": "2016-02-10T18:00:00-08:00"
    }
  ],
  "count": 1,
  "month": "2016-02"
}
```

### List clients

Find clients by name or phone number, or list them all.

**Inputs**

- Search (`search`, text): A first name, last name or phone number to look for.

**Outputs**

- `clients` (list): The matching clients
- `count` (number): How many are returned

**Example output**

```json
{
  "clients": [
    {
      "email": "",
      "first_name": "Bob",
      "last_name": "McTest",
      "notes": "",
      "phone": ""
    }
  ],
  "count": 1
}
```

### List intake forms

List the intake forms with their questions, each question's id and type, and the appointment types that ask them.

**Inputs**: None.

**Outputs**

- `count` (number): How many are returned
- `forms` (list): The intake forms

**Example output**

```json
{
  "count": 1,
  "forms": [
    {
      "appointment_type_ids": [
        "1",
        "2"
      ],
      "description": "This form has got it all!",
      "hidden": false,
      "id": "3",
      "name": "Kitchen Sink",
      "questions": [
        {
          "id": "7",
          "name": "What is your text?",
          "options": [],
          "required": false,
          "type": "textbox"
        },
        {
          "id": "9",
          "name": "Which are your drop downs?",
          "options": [
            "First",
            "Second",
            "Third"
          ],
          "required": false,
          "type": "dropdown"
        },
        {
          "id": "15",
          "name": "Required?",
          "options": [],
          "required": true,
          "type": "textbox"
        }
      ]
    }
  ]
}
```

### List labels

List the labels appointments can be marked with.

**Inputs**: None.

**Outputs**

- `count` (number): How many are returned
- `labels` (list): The labels

**Example output**

```json
{
  "count": 1,
  "labels": [
    {
      "color": "yellow",
      "id": "1",
      "name": "Confirmed"
    }
  ]
}
```

### List orders

List orders from the online store (packages, gift certificates, subscriptions and products), newest first.

**Inputs**

- Most to return (`limit`, number): How many to return at most, 1 to 1000. Defaults to 100. From 1 to 1000.

**Outputs**

- `count` (number): How many are returned
- `orders` (list): The orders

**Example output**

```json
{
  "count": 1,
  "orders": [
    {
      "email": "test@example.com",
      "first_name": "Testy",
      "id": "1234",
      "last_name": "McTest",
      "notes": "Some notes from the client",
      "phone": "1234567890",
      "products": "Massage Gift Certificate, Relaxing Candle",
      "status": "paid",
      "time": "2014-09-23 14:22",
      "total": 55.0
    }
  ]
}
```

### Reschedule appointment

Move an appointment to another time, or another calendar, or both. The new time must be open unless booking anyway.

**Inputs**

- Appointment ID (`appointment_id`, text, required): The appointment's id, from 'List appointments', 'Book appointment' or a trigger.
- New date and time (`start_time`, date and time, required): When the appointment starts now. A time from 'Get available times' can be used as it is.
- Calendar (`calendar_id`, text): Move it to this calendar. Leave empty to keep its calendar.
- Client's time zone (`time_zone`, text): The time zone the client sees times in, such as America/New_York. Defaults to the business's.
- Book even if the time isn't open (`book_anyway`, true/false): Book as the business, skipping Acuity's availability and booking rules. Needs a calendar. Default: `false`.
- Email the client (`send_notification`, true/false): Send Acuity's email and text message about the change. Default: `true`.

**Outputs**

- `appointment` (object): The appointment

**Example output**

```json
{
  "appointment": {
    "amount_paid": 0.0,
    "answers": [
      {
        "answer": "yes",
        "form": "Example Intake Form",
        "question": "Is this your first visit?",
        "question_id": "1"
      },
      {
        "answer": "Ninja",
        "form": "Example Intake Form",
        "question": "What is your goal for this appointment?",
        "question_id": "2"
      }
    ],
    "appointment_type": "Regular Visit",
    "appointment_type_id": "1",
    "calendar": "My Calendar",
    "calendar_id": "27238",
    "certificate": "",
    "class_id": "",
    "confirmation_page": "https://acuityscheduling.com/schedule.php?owner=11145481&id[]=1220aa9f41091c50c0cc659385cfa1d0&action=appt",
    "created_on": "2013-07-02",
    "date": "June 17, 2013",
    "datetime": "2013-06-17T10:15:00-07:00",
    "duration_minutes": 60.0,
    "email": "bob.mctest@example.com",
    "end_datetime": "2013-06-17T11:15:00-07:00",
    "end_time": "11:15am",
    "first_name": "Bob",
    "id": "54321",
    "label": "Completed",
    "labels": [
      {
        "color": "pink",
        "id": "3",
        "name": "Completed"
      }
    ],
    "last_name": "McTest",
    "location": "",
    "no_show": false,
    "notes": "Notes",
    "paid": false,
    "phone": "",
    "price": 10.0,
    "time": "10:15am",
    "timezone": "America/New_York"
  }
}
```

### Update appointment

Change an appointment's client details, notes, label, code or intake form answers. Only the fields given change.

**Inputs**

- Appointment ID (`appointment_id`, text, required): The appointment's id, from 'List appointments', 'Book appointment' or a trigger.
- First name (`first_name`, text): A new first name for the client.
- Last name (`last_name`, text): A new last name for the client.
- Email (`email`, text): A new email address for the client.
- Phone (`phone`, text): The client's phone number.
- Notes (`notes`, text): Notes kept on the appointment. Replaces any notes it has.
- Label (`label_id`, text): A label to mark the appointment with, such as Confirmed.
- Package or coupon code (`certificate`, text): A package, gift certificate or coupon code to apply.
- Intake form answers (`form_answers`, object): Answers to the appointment type's intake form questions. For a checkbox list, separate the choices with commas.

**Outputs**

- `appointment` (object): The appointment

**Example output**

```json
{
  "appointment": {
    "amount_paid": 0.0,
    "answers": [
      {
        "answer": "yes",
        "form": "Example Intake Form",
        "question": "Is this your first visit?",
        "question_id": "1"
      },
      {
        "answer": "Ninja",
        "form": "Example Intake Form",
        "question": "What is your goal for this appointment?",
        "question_id": "2"
      }
    ],
    "appointment_type": "Regular Visit",
    "appointment_type_id": "1",
    "calendar": "My Calendar",
    "calendar_id": "27238",
    "certificate": "",
    "class_id": "",
    "confirmation_page": "https://acuityscheduling.com/schedule.php?owner=11145481&id[]=1220aa9f41091c50c0cc659385cfa1d0&action=appt",
    "created_on": "2013-07-02",
    "date": "June 17, 2013",
    "datetime": "2013-06-17T10:15:00-07:00",
    "duration_minutes": 60.0,
    "email": "bob.mctest@example.com",
    "end_datetime": "2013-06-17T11:15:00-07:00",
    "end_time": "11:15am",
    "first_name": "Bob",
    "id": "54321",
    "label": "Completed",
    "labels": [
      {
        "color": "pink",
        "id": "3",
        "name": "Completed"
      }
    ],
    "last_name": "McTest",
    "location": "",
    "no_show": false,
    "notes": "Notes",
    "paid": false,
    "phone": "",
    "price": 10.0,
    "time": "10:15am",
    "timezone": "America/New_York"
  }
}
```

### Update client

Change a client found by first and last name. Fields left empty keep their values.

**Inputs**

- First name (`first_name`, text, required): The client's first name, exactly as in Acuity.
- Last name (`last_name`, text, required): The client's last name, exactly as in Acuity.
- New first name (`new_first_name`, text): A new first name.
- New last name (`new_last_name`, text): A new last name.
- Email (`email`, text): A new email address.
- Phone (`phone`, text): A new phone number.
- Notes (`notes`, text): Notes kept on the client. Replaces any notes they have.

**Outputs**

- `client` (object): The client

**Example output**

```json
{
  "client": {
    "email": "",
    "first_name": "Bob",
    "last_name": "Burger",
    "notes": "",
    "phone": "555-555-5555"
  }
}
```
