# Tripleseat

> Run your venue's events in Tripleseat: find, add, change and delete events, leads, contacts and accounts, find bookings, add notes and tasks, and start workflows when a lead, event, booking, contact or account comes in.

App · 24 actions. Web page: https://docs.lodol.com/docs/integrations/tripleseat

## Actions

### Add account

Add an account: the company, organisation or family holding events.

**Inputs**

- Name (`name`, text, required): The account's name, which must not already be used.
- Description (`description`, text): Notes about the account.
- Owner (`owned_by`, text): The Tripleseat user who owns it.
- Phone (`phone_number`, text): The account's main phone number.
- Website (`website`, text): The account's website address.

**Outputs**

- `account` (object): The account

**Example output**

```json
{
  "account": {
    "created_at": "11/01/2026 08:55 AM",
    "description": null,
    "id": 801,
    "name": "Smith family",
    "owned_by": 7,
    "phone_numbers": [],
    "site_id": 1,
    "updated_at": "11/01/2026 08:55 AM",
    "websites": []
  }
}
```

### Add contact

Add a contact (a person) to an account.

**Inputs**

- First name (`first_name`, text, required): The contact's first name.
- Last name (`last_name`, text, required): The contact's last name.
- Account ID (`account_id`, text, required): The account the contact belongs to.
- Email (`email`, text): Their email address.
- Phone (`phone_number`, text): Their phone number.
- Phone type (`phone_type`, text): What kind of phone number it is. One of: `Main`, `Work`, `Home`, `Mobile`, `Fax`.
- Job title (`title`, text): Their job title.
- Description (`description`, text): Notes about them.
- Owner (`owned_by`, text): The Tripleseat user who owns it.
- Agrees to emails (`email_opt_in`, true/false): Whether they agree to receive marketing emails.

**Outputs**

- `contact` (object): The contact

**Example output**

```json
{
  "contact": {
    "account_id": 801,
    "contact_type": null,
    "created_at": "11/01/2026 09:00 AM",
    "description": null,
    "email_addresses": [
      {
        "address": "sam@example.com",
        "id": 1
      }
    ],
    "email_opt_in": true,
    "first_name": "Sam",
    "id": 902,
    "last_name": "Smith",
    "owned_by": 7,
    "phone_numbers": [
      {
        "id": 2,
        "number": "555-0101",
        "phone_number_type": "Mobile"
      }
    ],
    "site_id": 1,
    "title": "Planner",
    "updated_at": "11/01/2026 09:00 AM"
  }
}
```

### Add event

Add an event for an account and contact at a location. Tripleseat makes a booking to hold it; its id is the event's booking_id.

**Inputs**

- Event name (`name`, text, required): What the event is called.
- Status (`status`, text, required): Where the event stands, from prospect to definite. One of: `PROSPECT`, `TENTATIVE`, `DEFINITE`, `CLOSED`, `LOST`.
- Location (`location_id`, text, required): The venue the event is at.
- Starts (`event_start`, date and time, required): When the event starts.
- Ends (`event_end`, date and time, required): When the event ends.
- Account ID (`account_id`, text, required): The account (company or person) holding the event.
- Contact ID (`contact_id`, text, required): The contact to deal with about the event.
- Room (`room_id`, text): The room the event is in.
- Guests (`guest_count`, number): How many guests are expected. At least 0.
- Description (`description`, text): Notes about the event.
- Owner (`owned_by`, text): The Tripleseat user who owns it.
- Event type (`event_type_id`, text): The kind of event.

**Outputs**

- `event` (object): The event

**Example output**

```json
{
  "event": {
    "account_id": 801,
    "amount_due": null,
    "booking_id": 3301,
    "contact_id": 902,
    "created_at": "11/01/2026 09:15 AM",
    "description": "Dinner and dancing.",
    "event_date": "11/20/2026",
    "event_end": "11/20/2026 11:00 PM",
    "event_end_iso8601": "2026-11-20T23:00:00-05:00",
    "event_start": "11/20/2026 06:00 PM",
    "event_start_iso8601": "2026-11-20T18:00:00-05:00",
    "event_timezone": "Eastern Time (US & Canada)",
    "event_type_id": 3,
    "grand_total": null,
    "guaranteed_guest_count": null,
    "guest_count": 120,
    "id": 4501,
    "location_id": 12,
    "name": "Smith wedding reception",
    "owned_by": 7,
    "room_ids": [
      55
    ],
    "status": "TENTATIVE",
    "updated_at": "11/02/2026 10:30 AM"
  }
}
```

### Add lead

Add a lead: someone asking about holding an event, as if they had filled in your lead form.

**Inputs**

- First name (`first_name`, text, required): The first name of the person asking.
- Last name (`last_name`, text, required): Their last name.
- Email (`email_address`, text): Their email address.
- Phone (`phone_number`, text): Their phone number.
- Company (`company`, text): The company they are with.
- Nature of event (`event_description`, text): What the event is, such as Birthday party or Business dinner.
- Event date (`event_date`, date): The day they want the event.
- Start time (`start_time`, time): When they want it to start.
- End time (`end_time`, time): When they want it to end.
- Guests (`guest_count`, number): How many guests they expect. At least 0.
- Additional information (`additional_information`, text): Anything else they said.
- Contact by (`contact_preference`, text): How they prefer to be contacted. One of: `Email`, `Phone`, `Text`.
- Location (`location_id`, text): The venue they asked about. Needed when the account has more than one.

**Outputs**

- `lead_id` (number): The new lead's id
- `success_message` (text): Tripleseat's thank-you message

**Example output**

```json
{
  "lead_id": 6001,
  "success_message": "Thank you!"
}
```

### Add note

Add an internal note to an event, lead, booking, contact or account.

**Inputs**

- Add it to (`record_type`, text, required): The kind of record. One of: `event`, `lead`, `booking`, `contact`, `account`.
- Record ID (`record_id`, text, required): The id of that event, lead, booking, contact or account.
- Note (`body`, text, required): What the note says.

**Outputs**

- `note` (object): The note, as Tripleseat returned it
- `record_id` (number): The record's id
- `record_type` (text): The kind of record

**Example output**

```json
{
  "note": {
    "body": "Called to confirm the menu.",
    "created_at": "2026-11-03T14:05:00-05:00",
    "created_by": 7,
    "id": 77,
    "updated_at": "2026-11-03T14:05:00-05:00"
  },
  "record_id": 4501,
  "record_type": "event"
}
```

### Add task

Give a Tripleseat user a to-do on an event, lead, booking, contact or account, with a due date and priority.

**Inputs**

- Add it to (`record_type`, text, required): The kind of record. One of: `event`, `lead`, `booking`, `contact`, `account`.
- Record ID (`record_id`, text, required): The id of that event, lead, booking, contact or account.
- Task (`body`, text, required): What needs doing.
- Assign to (`assignee_id`, text, required): The user who should do it.
- Due (`due_date`, date and time): When it is due.
- Priority (`priority`, text): How urgent it is. One of: `1` (Low), `2` (Medium), `3` (High).
- Task type (`task_type_id`, text): The kind of task, such as Call.

**Outputs**

- `task` (object): The task

**Example output**

```json
{
  "task": {
    "body": "Confirm the guest count.",
    "completed": false,
    "created_at": "2026-11-03T14:05:00Z",
    "due_date": "2026-11-10T15:00:00Z",
    "id": 88,
    "name": "Call",
    "taskable_id": 4501,
    "taskable_type": "Event"
  }
}
```

### Delete account

Delete an account.

**Inputs**

- Account ID (`account_id`, text, required): The account's id, from 'Find accounts' or an earlier step.

**Outputs**

- `account_id` (number): The account deleted
- `deleted` (true/false): True once it is deleted

**Example output**

```json
{
  "account_id": 801,
  "deleted": true
}
```

### Delete booking

Delete a booking.

**Inputs**

- Booking ID (`booking_id`, text, required): The booking's id, from 'Find bookings', an event's booking_id, or an earlier step.

**Outputs**

- `booking_id` (number): The booking deleted
- `deleted` (true/false): True once it is deleted

**Example output**

```json
{
  "booking_id": 3301,
  "deleted": true
}
```

### Delete contact

Delete a contact.

**Inputs**

- Contact ID (`contact_id`, text, required): The contact's id, from 'Find contacts' or an earlier step.

**Outputs**

- `contact_id` (number): The contact deleted
- `deleted` (true/false): True once it is deleted

**Example output**

```json
{
  "contact_id": 902,
  "deleted": true
}
```

### Delete event

Delete an event.

**Inputs**

- Event ID (`event_id`, text, required): The event's id, from 'Find events' or an earlier step.

**Outputs**

- `deleted` (true/false): True once it is deleted
- `event_id` (number): The event deleted

**Example output**

```json
{
  "deleted": true,
  "event_id": 4501
}
```

### Delete lead

Delete a lead.

**Inputs**

- Lead ID (`lead_id`, text, required): The lead's id, from 'Find leads' or an earlier step.

**Outputs**

- `deleted` (true/false): True once it is deleted
- `lead_id` (number): The lead deleted

**Example output**

```json
{
  "deleted": true,
  "lead_id": 6001
}
```

### Find accounts

Find accounts (the companies or people holding events) by name or when they last changed.

**Inputs**

- Search for (`query`, text): Words to look for in the account's name.
- Changed on or after (`updated_since`, date): Only records changed on or after this day.
- Sort by (`order`, text): What to sort the accounts by. One of: `created_at` (When it was added), `updated_at` (When it was last changed), `name`.
- Order (`sort_direction`, text): Which end of the order comes first. One of: `desc` (Newest or last first), `asc` (Oldest or first first).
- Page (`page`, number): Which page of 50 to get, from 1. Defaults to the first. At least 1.

**Outputs**

- `accounts` (list): The accounts
- `count` (number): How many came back on this page
- `has_more` (true/false): Whether there is another page after this one
- `page` (number): The page number, from 1
- `total_pages` (number): How many pages there are

**Example output**

```json
{
  "accounts": [
    {
      "created_at": "11/01/2026 08:55 AM",
      "description": null,
      "id": 801,
      "name": "Smith family",
      "owned_by": 7,
      "phone_numbers": [],
      "site_id": 1,
      "updated_at": "11/01/2026 08:55 AM",
      "websites": []
    }
  ],
  "count": 1,
  "has_more": false,
  "page": 1,
  "total_pages": 1
}
```

### Find bookings

Find bookings (the containers that hold one or more events) by name, status, location, dates or when they last changed.

**Inputs**

- Search for (`query`, text): Words to look for in the name.
- Status (`status`, text): Only records with this status. One of: `PROSPECT`, `TENTATIVE`, `DEFINITE`, `CLOSED`, `LOST`.
- Location (`location_id`, text): Only records at this location.
- Starting on or after (`starts_from`, date): Only bookings starting on or after this day.
- Ending on or before (`ends_until`, date): Only bookings ending on or before this day.
- Changed on or after (`updated_since`, date): Only records changed on or after this day.
- Sort by (`order`, text): What to sort the bookings by. One of: `created_at` (When it was added), `updated_at` (When it was last changed), `name`.
- Order (`sort_direction`, text): Which end of the order comes first. One of: `desc` (Newest or last first), `asc` (Oldest or first first).
- Page (`page`, number): Which page of 50 to get, from 1. Defaults to the first. At least 1.

**Outputs**

- `bookings` (list): The bookings
- `count` (number): How many came back on this page
- `has_more` (true/false): Whether there is another page after this one
- `page` (number): The page number, from 1
- `total_pages` (number): How many pages there are

**Example output**

```json
{
  "bookings": [
    {
      "account_id": 801,
      "contact_id": 902,
      "created_at": "11/01/2026 09:15 AM",
      "end_date": "2026-11-20",
      "id": 3301,
      "location_id": 12,
      "name": "Smith wedding",
      "site_id": 1,
      "start_date": "2026-11-20",
      "status": "TENTATIVE",
      "updated_at": "11/02/2026 10:30 AM"
    }
  ],
  "count": 1,
  "has_more": false,
  "page": 1,
  "total_pages": 1
}
```

### Find contacts

Find contacts by name, account or when they last changed.

**Inputs**

- Search for (`query`, text): Words to look for in the contact's name.
- Account ID (`account_id`, text): Only contacts of this account.
- Changed on or after (`updated_since`, date): Only records changed on or after this day.
- Sort by (`order`, text): What to sort the contacts by. One of: `created_at` (When it was added), `updated_at` (When it was last changed), `first_name` (First name), `last_name` (Last name).
- Order (`sort_direction`, text): Which end of the order comes first. One of: `desc` (Newest or last first), `asc` (Oldest or first first).
- Page (`page`, number): Which page of 50 to get, from 1. Defaults to the first. At least 1.

**Outputs**

- `contacts` (list): The contacts
- `count` (number): How many came back on this page
- `has_more` (true/false): Whether there is another page after this one
- `page` (number): The page number, from 1
- `total_pages` (number): How many pages there are

**Example output**

```json
{
  "contacts": [
    {
      "account_id": 801,
      "contact_type": null,
      "created_at": "11/01/2026 09:00 AM",
      "description": null,
      "email_addresses": [
        {
          "address": "sam@example.com",
          "id": 1
        }
      ],
      "email_opt_in": true,
      "first_name": "Sam",
      "id": 902,
      "last_name": "Smith",
      "owned_by": 7,
      "phone_numbers": [
        {
          "id": 2,
          "number": "555-0101",
          "phone_number_type": "Mobile"
        }
      ],
      "site_id": 1,
      "title": "Planner",
      "updated_at": "11/01/2026 09:00 AM"
    }
  ],
  "count": 1,
  "has_more": false,
  "page": 1,
  "total_pages": 1
}
```

### Find events

Find events by name, status, location, start date or when they last changed.

**Inputs**

- Search for (`query`, text): Words to look for in the name.
- Status (`status`, text): Only records with this status. One of: `PROSPECT`, `TENTATIVE`, `DEFINITE`, `CLOSED`, `LOST`.
- Location (`location_id`, text): Only records at this location.
- Starting on or after (`starts_from`, date): Only events starting on or after this day.
- Starting on or before (`starts_until`, date): Only events starting on or before this day.
- Changed on or after (`updated_since`, date): Only records changed on or after this day.
- Sort by (`order`, text): What to sort the events by. One of: `created_at` (When it was added), `updated_at` (When it was last changed), `name`, `event_start` (When it starts).
- Order (`sort_direction`, text): Which end of the order comes first. One of: `desc` (Newest or last first), `asc` (Oldest or first first).
- Include deleted (`include_deleted`, true/false): Also include deleted events.
- Page (`page`, number): Which page of 50 to get, from 1. Defaults to the first. At least 1.

**Outputs**

- `count` (number): How many came back on this page
- `events` (list): The events
- `has_more` (true/false): Whether there is another page after this one
- `page` (number): The page number, from 1
- `total_pages` (number): How many pages there are

**Example output**

```json
{
  "count": 1,
  "events": [
    {
      "account_id": 801,
      "amount_due": null,
      "booking_id": 3301,
      "contact_id": 902,
      "created_at": "11/01/2026 09:15 AM",
      "description": "Dinner and dancing.",
      "event_date": "11/20/2026",
      "event_end": "11/20/2026 11:00 PM",
      "event_end_iso8601": "2026-11-20T23:00:00-05:00",
      "event_start": "11/20/2026 06:00 PM",
      "event_start_iso8601": "2026-11-20T18:00:00-05:00",
      "event_timezone": "Eastern Time (US & Canada)",
      "event_type_id": 3,
      "grand_total": null,
      "guaranteed_guest_count": null,
      "guest_count": 120,
      "id": 4501,
      "location_id": 12,
      "name": "Smith wedding reception",
      "owned_by": 7,
      "room_ids": [
        55
      ],
      "status": "TENTATIVE",
      "updated_at": "11/02/2026 10:30 AM"
    }
  ],
  "has_more": false,
  "page": 1,
  "total_pages": 1
}
```

### Find leads

Find leads (event enquiries) by name or the day they came in.

**Inputs**

- Search for (`query`, text): Words to look for in the lead's name.
- Came in after (`created_after`, date): Only leads that came in after this day.
- Came in before (`created_before`, date): Only leads that came in before this day.
- Sort by (`order`, text): What to sort the leads by. One of: `created_at` (When it was added), `updated_at` (When it was last changed), `first_name` (First name), `last_name` (Last name), `company`.
- Order (`sort_direction`, text): Which end of the order comes first. One of: `desc` (Newest or last first), `asc` (Oldest or first first).
- Page (`page`, number): Which page of 50 to get, from 1. Defaults to the first. At least 1.

**Outputs**

- `count` (number): How many came back on this page
- `has_more` (true/false): Whether there is another page after this one
- `leads` (list): The leads
- `page` (number): The page number, from 1
- `total_pages` (number): How many pages there are

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "leads": [
    {
      "additional_information": "Gluten-free menu, please.",
      "company": "Acme",
      "contact_preference": "Email",
      "converted_at": null,
      "created_at": "11/03/2026 02:00 PM",
      "email_address": "jo@example.com",
      "email_opt_in": true,
      "end_time": "09:00 PM",
      "event_date": "2026-12-05",
      "event_description": "Birthday party",
      "first_name": "Jo",
      "guest_count": 30,
      "id": 6001,
      "last_name": "Bloggs",
      "location": {
        "id": 12,
        "name": "Downtown"
      },
      "owned_by": 7,
      "phone_number": "555-0100",
      "start_time": "06:00 PM",
      "turned_down_at": null,
      "updated_at": "11/03/2026 02:00 PM"
    }
  ],
  "page": 1,
  "total_pages": 1
}
```

### Get event

Get one event's details.

**Inputs**

- Event ID (`event_id`, text, required): The event's id, from 'Find events' or an earlier step.
- Include money (`show_financial`, true/false): Also include prices, taxes, payments and balances.

**Outputs**

- `event` (object): The event

**Example output**

```json
{
  "event": {
    "account_id": 801,
    "amount_due": null,
    "booking_id": 3301,
    "contact_id": 902,
    "created_at": "11/01/2026 09:15 AM",
    "description": "Dinner and dancing.",
    "event_date": "11/20/2026",
    "event_end": "11/20/2026 11:00 PM",
    "event_end_iso8601": "2026-11-20T23:00:00-05:00",
    "event_start": "11/20/2026 06:00 PM",
    "event_start_iso8601": "2026-11-20T18:00:00-05:00",
    "event_timezone": "Eastern Time (US & Canada)",
    "event_type_id": 3,
    "grand_total": null,
    "guaranteed_guest_count": null,
    "guest_count": 120,
    "id": 4501,
    "location_id": 12,
    "name": "Smith wedding reception",
    "owned_by": 7,
    "room_ids": [
      55
    ],
    "status": "TENTATIVE",
    "updated_at": "11/02/2026 10:30 AM"
  }
}
```

### Get lead

Get one lead's details.

**Inputs**

- Lead ID (`lead_id`, text, required): The lead's id, from 'Find leads' or an earlier step.

**Outputs**

- `lead` (object): The lead

**Example output**

```json
{
  "lead": {
    "additional_information": "Gluten-free menu, please.",
    "company": "Acme",
    "contact_preference": "Email",
    "converted_at": null,
    "created_at": "11/03/2026 02:00 PM",
    "email_address": "jo@example.com",
    "email_opt_in": true,
    "end_time": "09:00 PM",
    "event_date": "2026-12-05",
    "event_description": "Birthday party",
    "first_name": "Jo",
    "guest_count": 30,
    "id": 6001,
    "last_name": "Bloggs",
    "location": {
      "id": 12,
      "name": "Downtown"
    },
    "owned_by": 7,
    "phone_number": "555-0100",
    "start_time": "06:00 PM",
    "turned_down_at": null,
    "updated_at": "11/03/2026 02:00 PM"
  }
}
```

### List rooms

List the rooms guests can book, in every location or one.

**Inputs**

- Location (`location_id`, text): Only rooms at this location.
- Page (`page`, number): Which page of 50 to get, from 1. Defaults to the first. At least 1.

**Outputs**

- `count` (number): How many came back on this page
- `has_more` (true/false): Whether there is another page after this one
- `page` (number): The page number, from 1
- `rooms` (list): The rooms
- `total_pages` (number): How many pages there are

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "page": 1,
  "rooms": [
    {
      "capacity": 200,
      "description": null,
      "id": 55,
      "listed": true,
      "location_id": 12,
      "name": "Grand Ballroom",
      "room_type": "Normal",
      "site_id": 1
    }
  ],
  "total_pages": 1
}
```

### List sites

List the Tripleseat sites you can reach, with their event types, lead sources and task types.

**Inputs**: None.

**Outputs**

- `count` (number): How many sites
- `sites` (list): The sites

**Example output**

```json
{
  "count": 1,
  "sites": [
    {
      "contact_types": [
        {
          "id": 6,
          "name": "Planner"
        }
      ],
      "currency_code": "USD",
      "customer_id": 100,
      "event_types": [
        {
          "id": 3,
          "name": "Wedding"
        }
      ],
      "id": 1,
      "lead_sources": [
        {
          "id": 4,
          "name": "Website"
        }
      ],
      "name": "Downtown Group",
      "task_types": [
        {
          "id": 5,
          "name": "Call"
        }
      ],
      "timezone": "Eastern Time (US & Canada)"
    }
  ]
}
```

### Update account

Change an account's name, description or owner. Fields left blank stay as they are.

**Inputs**

- Account ID (`account_id`, text, required): The account's id, from 'Find accounts' or an earlier step.
- Name (`name`, text): The account's new name.
- Description (`description`, text): Notes about the account.
- Owner (`owned_by`, text): The Tripleseat user who owns it.

**Outputs**

- `account` (object): The account

**Example output**

```json
{
  "account": {
    "created_at": "11/01/2026 08:55 AM",
    "description": null,
    "id": 801,
    "name": "Smith family",
    "owned_by": 7,
    "phone_numbers": [],
    "site_id": 1,
    "updated_at": "11/01/2026 08:55 AM",
    "websites": []
  }
}
```

### Update contact

Change a contact's name, title, description, owner or email choice. Fields left blank stay as they are.

**Inputs**

- Contact ID (`contact_id`, text, required): The contact's id, from 'Find contacts' or an earlier step.
- First name (`first_name`, text): Their new first name.
- Last name (`last_name`, text): Their new last name.
- Job title (`title`, text): Their job title.
- Description (`description`, text): Notes about them.
- Owner (`owned_by`, text): The Tripleseat user who owns it.
- Agrees to emails (`email_opt_in`, true/false): Whether they agree to receive marketing emails.

**Outputs**

- `contact` (object): The contact

**Example output**

```json
{
  "contact": {
    "account_id": 801,
    "contact_type": null,
    "created_at": "11/01/2026 09:00 AM",
    "description": null,
    "email_addresses": [
      {
        "address": "sam@example.com",
        "id": 1
      }
    ],
    "email_opt_in": true,
    "first_name": "Sam",
    "id": 902,
    "last_name": "Smith",
    "owned_by": 7,
    "phone_numbers": [
      {
        "id": 2,
        "number": "555-0101",
        "phone_number_type": "Mobile"
      }
    ],
    "site_id": 1,
    "title": "Planner",
    "updated_at": "11/01/2026 09:00 AM"
  }
}
```

### Update event

Change an event's details. Fields left blank stay as they are.

**Inputs**

- Event ID (`event_id`, text, required): The event's id, from 'Find events' or an earlier step.
- Event name (`name`, text): What the event is called. Leave blank to keep it.
- Status (`status`, text): Where the event stands, from prospect to definite. Leave blank to keep it. One of: `PROSPECT`, `TENTATIVE`, `DEFINITE`, `CLOSED`, `LOST`.
- Location (`location_id`, text): The venue the event is at. Leave blank to keep it.
- Starts (`event_start`, date and time): When the event starts. Leave blank to keep it.
- Ends (`event_end`, date and time): When the event ends. Leave blank to keep it.
- Account ID (`account_id`, text): The account (company or person) holding the event. Leave blank to keep it.
- Contact ID (`contact_id`, text): The contact to deal with about the event. Leave blank to keep it.
- Room (`room_id`, text): The room the event is in. Leave blank to keep its rooms.
- Guests (`guest_count`, number): How many guests are expected. At least 0.
- Description (`description`, text): Notes about the event.
- Owner (`owned_by`, text): The Tripleseat user who owns it.
- Event type (`event_type_id`, text): The kind of event.

**Outputs**

- `event` (object): The event

**Example output**

```json
{
  "event": {
    "account_id": 801,
    "amount_due": null,
    "booking_id": 3301,
    "contact_id": 902,
    "created_at": "11/01/2026 09:15 AM",
    "description": "Dinner and dancing.",
    "event_date": "11/20/2026",
    "event_end": "11/20/2026 11:00 PM",
    "event_end_iso8601": "2026-11-20T23:00:00-05:00",
    "event_start": "11/20/2026 06:00 PM",
    "event_start_iso8601": "2026-11-20T18:00:00-05:00",
    "event_timezone": "Eastern Time (US & Canada)",
    "event_type_id": 3,
    "grand_total": null,
    "guaranteed_guest_count": null,
    "guest_count": 120,
    "id": 4501,
    "location_id": 12,
    "name": "Smith wedding reception",
    "owned_by": 7,
    "room_ids": [
      55
    ],
    "status": "TENTATIVE",
    "updated_at": "11/02/2026 10:30 AM"
  }
}
```

### Update lead

Change a lead's details or owner. Fields left blank stay as they are.

**Inputs**

- Lead ID (`lead_id`, text, required): The lead's id, from 'Find leads' or an earlier step.
- First name (`first_name`, text): The first name of the person asking.
- Last name (`last_name`, text): Their last name.
- Email (`email_address`, text): Their email address.
- Phone (`phone_number`, text): Their phone number.
- Company (`company`, text): The company they are with.
- Nature of event (`event_description`, text): What the event is, such as Birthday party or Business dinner.
- Event date (`event_date`, date): The day they want the event.
- Start time (`start_time`, time): When they want it to start.
- End time (`end_time`, time): When they want it to end.
- Guests (`guest_count`, number): How many guests they expect. At least 0.
- Additional information (`additional_information`, text): Anything else they said.
- Contact by (`contact_preference`, text): How they prefer to be contacted. One of: `Email`, `Phone`, `Text`.
- Location (`location_id`, text): The venue they asked about. Needed when the account has more than one.
- Owner (`owned_by`, text): The Tripleseat user who owns it.

**Outputs**

- `lead` (object): The lead

**Example output**

```json
{
  "lead": {
    "additional_information": "Gluten-free menu, please.",
    "company": "Acme",
    "contact_preference": "Email",
    "converted_at": null,
    "created_at": "11/03/2026 02:00 PM",
    "email_address": "jo@example.com",
    "email_opt_in": true,
    "end_time": "09:00 PM",
    "event_date": "2026-12-05",
    "event_description": "Birthday party",
    "first_name": "Jo",
    "guest_count": 30,
    "id": 6001,
    "last_name": "Bloggs",
    "location": {
      "id": 12,
      "name": "Downtown"
    },
    "owned_by": 7,
    "phone_number": "555-0100",
    "start_time": "06:00 PM",
    "turned_down_at": null,
    "updated_at": "11/03/2026 02:00 PM"
  }
}
```
