# Chili Piper

> Work with Chili Piper meetings and inbound routing: route leads, find open times and book, reschedule, reassign or cancel meetings, mark no-shows, and manage teams. Start a workflow when a meeting is booked, moved, canceled or marked no-show.

App · 19 actions. Web page: https://docs.lodol.com/docs/integrations/chili-piper

## Actions

### Add people to team

Add people to a team so meetings routed to it can go to them. People already in it are left as they are.

**Inputs**

- Team (`chili_team_id`, text, required): The team. Pick one, or give its ID from an earlier step.
- People (`chili_user_ids`, list, required): The people to add or take off. Pick them, or give their IDs.

**Outputs**

- `team` (object): The team, as it is now
- `user_ids` (list): The people asked for

**Example output**

```json
{
  "team": {
    "id": "5d6e7f80-1a2b-3c4d-5e6f-708192a3b4c5",
    "members": [
      "64ee0722-c7c6-4b48-bc89-356c99f1d25d"
    ],
    "name": "Inbound SDRs",
    "workspaceId": "abcd1234-5678-90ef-1234-567890abcdef"
  },
  "user_ids": [
    "64ee0722-c7c6-4b48-bc89-356c99f1d25d"
  ]
}
```

### Book an open time

Book one of the times 'Find open times' returned, for a guest. Calendar invites go out straight away.

**Inputs**

- Booking session (`session_id`, text, required): The 'session_id' from 'Find open times'.
- Start (`start_time`, date and time, required): One of the 'start_times' that step returned.
- Guest email (`guest_email`, text, required): The email address of the person the meeting is with.
- Guest time zone (`guest_time_zone`, text): The guest's time zone, such as America/New_York.
- Guest form answers (`form_answers`, object): Answers to the link's guest form, by field, such as PersonFirstName. 'Find open times' lists the fields.
- Other guests (`additional_guests`, list): Email addresses of anyone else to invite. Their calendars aren't checked.

**Outputs**

- `guest_email` (text): Who it is with
- `meeting_id` (text): The new meeting's ID, for the other meeting actions
- `start_time` (text): When it starts (ISO 8601)

**Example output**

```json
{
  "guest_email": "jo@example.com",
  "meeting_id": "7c4e8a1b-2f3d-4e5c-9b8a-1d2e3f456789",
  "start_time": "2026-11-10T15:00:00.000Z"
}
```

### Book meeting

Book a meeting with one person on one of their own meeting types, at a time they are free (see 'Find open times'). Calendar invites go out straight away.

**Inputs**

- Host (`host_user_id`, text, required): The person the meeting is with.
- Meeting type (`meeting_type_id`, text, required): One of the host's own meeting types, which sets its length and location.
- Start (`start_time`, date and time, required): When the meeting starts. The host must be free then.
- Guest email (`guest_email`, text, required): The email address of the person the meeting is with.
- Guest first name (`guest_first_name`, text): The guest's first name. Most meeting types ask for it.
- Guest last name (`guest_last_name`, text): The guest's last name. Most meeting types ask for it.
- Guest time zone (`guest_time_zone`, text): The guest's time zone, such as America/New_York.
- Other guests (`additional_guests`, list): Email addresses of anyone else to invite. Their calendars aren't checked.
- Notify the host (`notify_team`, true/false): Send Chili Piper's own 'meeting booked' email and Slack notes to the host. On unless turned off; the guest's invite goes out either way.

**Outputs**

- `guest_email` (text): Who it is with
- `meeting_id` (text): The new meeting's ID, for the other meeting actions
- `start_time` (text): When it starts (ISO 8601)

**Example output**

```json
{
  "guest_email": "jo@example.com",
  "meeting_id": "7c4e8a1b-2f3d-4e5c-9b8a-1d2e3f456789",
  "start_time": "2026-11-10T15:00:00.000Z"
}
```

### Book the routed meeting

Book one of the open times 'Route a lead' returned, with the rep the router picked. Calendar invites go out straight away.

**Inputs**

- Routing session (`session_id`, text, required): The 'session_id' from 'Route a lead'.
- Start (`start_time`, date and time, required): One of the 'start_times' that step returned.
- Other guests (`additional_guests`, list): Email addresses of anyone else to invite. Their calendars aren't checked.

**Outputs**

- `meeting_id` (text): The new meeting's ID
- `start_time` (text): When it starts (ISO 8601)

**Example output**

```json
{
  "meeting_id": "7c4e8a1b-2f3d-4e5c-9b8a-1d2e3f456789",
  "start_time": "2026-11-10T15:00:00.000Z"
}
```

### Cancel meeting

Cancel a meeting. Chili Piper tells the people invited. It can't be undone.

**Inputs**

- Meeting ID (`meeting_id`, text, required): The meeting's ID, from a Chili Piper trigger, 'List meetings' or a booking step.

**Outputs**

- `meeting` (object): The meeting, as it is now
- `meeting_id` (text): The meeting's ID

**Example output**

```json
{
  "meeting": {
    "attendees": [],
    "booked_at": "2026-11-06T12:00:00Z",
    "guest_email": "jo@example.com",
    "hostEmail": "alex@example.com",
    "hostName": "Alex Johnson",
    "host_id": "64ee0722-c7c6-4b48-bc89-356c99f1d25d",
    "meetingStatus": "Canceled",
    "meeting_id": "7c4e8a1b-2f3d-4e5c-9b8a-1d2e3f456789",
    "sourceUrl": "https://example.com/demo",
    "start_time": "2026-11-10T15:00:00Z",
    "status": "Canceled",
    "workspaceId": "abcd1234-5678-90ef-1234-567890abcdef"
  },
  "meeting_id": "7c4e8a1b-2f3d-4e5c-9b8a-1d2e3f456789"
}
```

### Find open times

Find the times that can be booked on a team scheduling link, or on one person's own meeting type. Books nothing: book one with 'Book an open time' (or 'Book meeting' for a person's own type).

**Inputs**

- Team scheduling link (`scheduling_link`, text): A round robin, group or ownership link. Leave empty to use a host and their meeting type instead.
- Host (`host_user_id`, text): Without a team link: the person to meet.
- Meeting type (`meeting_type_id`, text): Without a team link: one of the host's own meeting types. With a link that offers several: which one.
- From (`start_from`, date and time): Look for times from this moment. Defaults to now.
- Days to look ahead (`days`, number): How many days of times to find, 1 to 31. Defaults to 7. From 1 to 31.
- Guest email (`guest_email`, text): The guest's email. Needed for an ownership link, to find their owner in the CRM.
- Guest time zone (`guest_time_zone`, text): The guest's time zone, such as America/New_York.

**Outputs**

- `count` (number): How many came back
- `duration` (text): How long the meeting would be
- `failures` (object): People whose calendars couldn't be read, and why
- `form_fields` (list): The guest form's fields, for 'Guest form answers'
- `session_id` (text): The booking session, for the booking step. It expires after a while.
- `slots` (list): Each time, with who is free then
- `start_times` (list): The times that can be booked (ISO 8601)

**Example output**

```json
{
  "count": 1,
  "duration": "30 minutes",
  "failures": {},
  "form_fields": [],
  "session_id": "rt_01HXAMPLE",
  "slots": [
    {
      "attendees": [],
      "startTime": "2026-11-10T15:00:00Z"
    }
  ],
  "start_times": [
    "2026-11-10T15:00:00Z"
  ]
}
```

### Find users

Find people in your organization by name or email address.

**Inputs**

- Search (`query`, text, required): A name or email address, or part of one.
- Page (`page`, number): Which page of users to get, starting at 0. Use the 'next_page' an earlier run gave to get the next one. At least 0.
- Page size (`page_size`, number): How many users per page, 1 to 50. Defaults to 50. From 1 to 50.

**Outputs**

- `count` (number): How many came back
- `has_more` (true/false): Whether there is another page
- `next_page` (number): The page to ask for next, or empty on the last page
- `page` (number): The page this is, from 0
- `total` (number): How many there are in all
- `users` (list): The people found

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "next_page": null,
  "page": 0,
  "total": 1,
  "users": [
    {
      "email": "alex@example.com",
      "id": "64ee0722-c7c6-4b48-bc89-356c99f1d25d",
      "isSuperAdmin": false,
      "licenses": {},
      "name": "Alex Johnson",
      "personalWorkspaceId": "9f0e1d2c-3b4a-5968-7766-554433221100",
      "slug": "alex-johnson",
      "timezone": "America/New_York",
      "workspaces": [
        "abcd1234-5678-90ef-1234-567890abcdef"
      ]
    }
  ]
}
```

### Get meeting

Get one meeting with its time, people, status and where it was booked from.

**Inputs**

- Meeting ID (`meeting_id`, text, required): The meeting's ID, from a Chili Piper trigger, 'List meetings' or a booking step.

**Outputs**

- `meeting` (object): The meeting

**Example output**

```json
{
  "meeting": {
    "attendees": [],
    "booked_at": "2026-11-06T12:00:00Z",
    "guest_email": "jo@example.com",
    "hostEmail": "alex@example.com",
    "hostName": "Alex Johnson",
    "host_id": "64ee0722-c7c6-4b48-bc89-356c99f1d25d",
    "meetingStatus": "Active",
    "meeting_id": "7c4e8a1b-2f3d-4e5c-9b8a-1d2e3f456789",
    "sourceUrl": "https://example.com/demo",
    "start_time": "2026-11-10T15:00:00Z",
    "status": "Active",
    "workspaceId": "abcd1234-5678-90ef-1234-567890abcdef"
  }
}
```

### Get meeting link

Get the link that opens a meeting's activity page in Chili Piper, to share with the team.

**Inputs**

- Meeting ID (`meeting_id`, text, required): The meeting's ID, from a Chili Piper trigger, 'List meetings' or a booking step.

**Outputs**

- `meeting_id` (text): The meeting's ID
- `url` (text): The link to the meeting in Chili Piper

**Example output**

```json
{
  "meeting_id": "7c4e8a1b-2f3d-4e5c-9b8a-1d2e3f456789",
  "url": "https://acme.chilipiper.com/fire/admin/workspaces/abcd1234/reporting/meetings-activity/7c4e8a1b"
}
```

### Get user

Get one person's profile: workspaces, licences, working hours and time zone.

**Inputs**

- User (`chili_user_id`, text, required): The person. Pick one, or give their ID from an earlier step.

**Outputs**

- `user` (object): The user

**Example output**

```json
{
  "user": {
    "email": "alex@example.com",
    "id": "64ee0722-c7c6-4b48-bc89-356c99f1d25d",
    "isSuperAdmin": false,
    "licenses": {},
    "name": "Alex Johnson",
    "personalWorkspaceId": "9f0e1d2c-3b4a-5968-7766-554433221100",
    "slug": "alex-johnson",
    "timezone": "America/New_York",
    "workspaces": [
      "abcd1234-5678-90ef-1234-567890abcdef"
    ]
  }
}
```

### Invite user

Add a new person to your Chili Piper organization, such as a new rep. Uses a seat. No email goes out unless you ask for one.

**Inputs**

- Email (`email`, text, required): Their work email address. It must be new to Chili Piper.
- Name (`name`, text): Their full name.
- Role (`role`, text): User or Admin. Defaults to User. One of: `User`, `Admin`.
- Licences (`licenses`, list): The Chili Piper products they can use. One or more of: `ChiliCalOrg` (ChiliCal), `Concierge`, `ConciergeLive` (Concierge Live), `Distro`, `Handoff`, `Chat`.
- Workspaces (`workspace_ids`, list): Only these workspaces. Leave empty for all of them.
- Email the invitation now (`send_invite`, true/false): Send them Chili Piper's invitation email straight away.

**Outputs**

- `email` (text): Their email address
- `invited` (true/false): Whether the invitation email was sent
- `user_id` (text): The new person's ID

**Example output**

```json
{
  "email": "sam@example.com",
  "invited": false,
  "user_id": "3f2e1d0c-9b8a-7766-5544-332211009988"
}
```

### List meetings

List the meetings in a window of up to 7 days, with their time, host, guest and status. Gets one page; run it again with the next page to see more.

**Inputs**

- From (`start`, date and time): Meetings that start at or after this. Defaults to now.
- Until (`end`, date and time): Meetings that start before this, at most 7 days after 'From'. Defaults to 7 days after it.
- Workspaces (`workspace_ids`, list): Only these workspaces. Leave empty for all of them.
- Status (`statuses`, list): Only meetings with these statuses. Leave empty for all. One or more of: `Active` (Booked (upcoming, or past and not yet marked)), `Completed` (Completed (the guest attended)), `NoShow` (No-show), `Canceled`.
- Hosts (`host_ids`, list): Only meetings these people host. Leave empty for all.
- Guest email (`guest_email`, text): Only meetings with this guest.
- Page (`page`, number): Which page of meetings to get, starting at 0. Use the 'next_page' an earlier run gave to get the next one. At least 0.
- Page size (`page_size`, number): How many meetings per page, 1 to 50. Defaults to 50. From 1 to 50.

**Outputs**

- `count` (number): How many came back
- `has_more` (true/false): Whether there is another page
- `meetings` (list): The meetings
- `next_page` (number): The page to ask for next, or empty on the last page
- `page` (number): The page this is, from 0
- `total` (number): How many there are in all

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "meetings": [
    {
      "attendees": [],
      "booked_at": "2026-11-06T12:00:00Z",
      "guest_email": "jo@example.com",
      "hostEmail": "alex@example.com",
      "hostName": "Alex Johnson",
      "host_id": "64ee0722-c7c6-4b48-bc89-356c99f1d25d",
      "meetingStatus": "Active",
      "meeting_id": "7c4e8a1b-2f3d-4e5c-9b8a-1d2e3f456789",
      "sourceUrl": "https://example.com/demo",
      "start_time": "2026-11-10T15:00:00Z",
      "status": "Active",
      "workspaceId": "abcd1234-5678-90ef-1234-567890abcdef"
    }
  ],
  "next_page": null,
  "page": 0,
  "total": 1
}
```

### List teams

List teams with their members, the people meetings are routed to.

**Inputs**

- Workspaces (`workspace_ids`, list): Only these workspaces. Leave empty for all of them.
- Name contains (`name`, text): Only teams whose name contains this.
- With members (`member_ids`, list): Only teams with any of these people in them.
- Page (`page`, number): Which page of teams to get, starting at 0. Use the 'next_page' an earlier run gave to get the next one. At least 0.
- Page size (`page_size`, number): How many teams per page, 1 to 50. Defaults to 50. From 1 to 50.

**Outputs**

- `count` (number): How many came back
- `has_more` (true/false): Whether there is another page
- `next_page` (number): The page to ask for next, or empty on the last page
- `page` (number): The page this is, from 0
- `teams` (list): The teams
- `total` (number): How many there are in all

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "next_page": null,
  "page": 0,
  "teams": [
    {
      "id": "5d6e7f80-1a2b-3c4d-5e6f-708192a3b4c5",
      "members": [
        "64ee0722-c7c6-4b48-bc89-356c99f1d25d"
      ],
      "name": "Inbound SDRs",
      "workspaceId": "abcd1234-5678-90ef-1234-567890abcdef"
    }
  ],
  "total": 1
}
```

### List workspaces

List your organization's workspaces.

**Inputs**

- Name contains (`name`, text): Only workspaces whose name contains this.
- Page (`page`, number): Which page of workspaces to get, starting at 0. Use the 'next_page' an earlier run gave to get the next one. At least 0.
- Page size (`page_size`, number): How many workspaces per page, 1 to 50. Defaults to 50. From 1 to 50.

**Outputs**

- `count` (number): How many came back
- `has_more` (true/false): Whether there is another page
- `next_page` (number): The page to ask for next, or empty on the last page
- `page` (number): The page this is, from 0
- `total` (number): How many there are in all
- `workspaces` (list): The workspaces

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "next_page": null,
  "page": 0,
  "total": 1,
  "workspaces": [
    {
      "emoji": "",
      "id": "abcd1234-5678-90ef-1234-567890abcdef",
      "name": "Sales"
    }
  ]
}
```

### Mark meeting as attended

Record that the guest came, which also undoes a no-show mark. Chili Piper updates the CRM.

**Inputs**

- Meeting ID (`meeting_id`, text, required): The meeting's ID, from a Chili Piper trigger, 'List meetings' or a booking step.

**Outputs**

- `meeting` (object): The meeting, as it is now
- `meeting_id` (text): The meeting's ID

**Example output**

```json
{
  "meeting": {
    "attendees": [],
    "booked_at": "2026-11-06T12:00:00Z",
    "guest_email": "jo@example.com",
    "hostEmail": "alex@example.com",
    "hostName": "Alex Johnson",
    "host_id": "64ee0722-c7c6-4b48-bc89-356c99f1d25d",
    "meetingStatus": "Active",
    "meeting_id": "7c4e8a1b-2f3d-4e5c-9b8a-1d2e3f456789",
    "sourceUrl": "https://example.com/demo",
    "start_time": "2026-11-10T15:00:00Z",
    "status": "Completed",
    "workspaceId": "abcd1234-5678-90ef-1234-567890abcdef"
  },
  "meeting_id": "7c4e8a1b-2f3d-4e5c-9b8a-1d2e3f456789"
}
```

### Mark meeting as no-show

Record that the guest didn't come. Chili Piper updates the CRM and runs its own no-show follow-ups.

**Inputs**

- Meeting ID (`meeting_id`, text, required): The meeting's ID, from a Chili Piper trigger, 'List meetings' or a booking step.

**Outputs**

- `meeting` (object): The meeting, as it is now
- `meeting_id` (text): The meeting's ID

**Example output**

```json
{
  "meeting": {
    "attendees": [],
    "booked_at": "2026-11-06T12:00:00Z",
    "guest_email": "jo@example.com",
    "hostEmail": "alex@example.com",
    "hostName": "Alex Johnson",
    "host_id": "64ee0722-c7c6-4b48-bc89-356c99f1d25d",
    "meetingStatus": "Active",
    "meeting_id": "7c4e8a1b-2f3d-4e5c-9b8a-1d2e3f456789",
    "sourceUrl": "https://example.com/demo",
    "start_time": "2026-11-10T15:00:00Z",
    "status": "NoShow",
    "workspaceId": "abcd1234-5678-90ef-1234-567890abcdef"
  },
  "meeting_id": "7c4e8a1b-2f3d-4e5c-9b8a-1d2e3f456789"
}
```

### Remove people from team

Remove people from a team, such as someone going on leave, so no more meetings are routed to them through it. Their other teams are unchanged.

**Inputs**

- Team (`chili_team_id`, text, required): The team. Pick one, or give its ID from an earlier step.
- People (`chili_user_ids`, list, required): The people to add or take off. Pick them, or give their IDs.

**Outputs**

- `team` (object): The team, as it is now
- `user_ids` (list): The people asked for

**Example output**

```json
{
  "team": {
    "id": "5d6e7f80-1a2b-3c4d-5e6f-708192a3b4c5",
    "members": [],
    "name": "Inbound SDRs",
    "workspaceId": "abcd1234-5678-90ef-1234-567890abcdef"
  },
  "user_ids": [
    "64ee0722-c7c6-4b48-bc89-356c99f1d25d"
  ]
}
```

### Reschedule or reassign meeting

Move a meeting to another time, hand it to another host, or both. Chili Piper checks the new time is free and updates the invites; anything not given stays as it is.

**Inputs**

- Meeting ID (`meeting_id`, text, required): The meeting's ID, from a Chili Piper trigger, 'List meetings' or a booking step.
- New start (`start_time`, date and time): The new time. Leave empty to keep it.
- New host (`host_user_id`, text): Who should host it instead. Leave empty to keep the host.

**Outputs**

- `changed` (list): What was changed: startTime, hostId
- `meeting` (object): The meeting, as it is now
- `meeting_id` (text): The meeting's ID

**Example output**

```json
{
  "changed": [
    "startTime"
  ],
  "meeting": {
    "attendees": [],
    "booked_at": "2026-11-06T12:00:00Z",
    "guest_email": "jo@example.com",
    "hostEmail": "alex@example.com",
    "hostName": "Alex Johnson",
    "host_id": "64ee0722-c7c6-4b48-bc89-356c99f1d25d",
    "meetingStatus": "Active",
    "meeting_id": "7c4e8a1b-2f3d-4e5c-9b8a-1d2e3f456789",
    "sourceUrl": "https://example.com/demo",
    "start_time": "2026-11-10T15:00:00Z",
    "status": "Active",
    "workspaceId": "abcd1234-5678-90ef-1234-567890abcdef"
  },
  "meeting_id": "7c4e8a1b-2f3d-4e5c-9b8a-1d2e3f456789"
}
```

### Route a lead

Run a lead through a Concierge router, as if they had filled in your form: its rules pick the rep, and you get a link the lead can book with. Ask for open times to book one straight away.

**Inputs**

- Router (`router_slug`, text, required): The Concierge router. Pick one, or type its slug.
- Lead details (`form`, object, required): The lead's answers, by the field names your router uses, such as PersonEmail and PersonFirstName.
- Where the lead came from (`trigger`, text): Which of the router's starting points to use. One of: `ThirdPartyForm` (A form on your website), `InAppButton` (A button in your product), `RouterLink` (A router link), `ChiliForm` (A Chili Piper form).
- Guest time zone (`guest_time_zone`, text): The guest's time zone, such as America/New_York.
- Page (`source_url`, text): The web page the lead came from, for your reports.
- Open times for the next (`days`, number): Also return open times for this many days (1 to 31), to book with 'Book the routed meeting'. Leave empty for just the booking link. From 1 to 31.

**Outputs**

- `assignments` (list): Who the lead was routed to
- `booking_url` (text): The link the lead can book with
- `distribution_ids` (list): The distributions used
- `scheduling_allowed` (true/false): Whether the route lets the lead book
- `session_id` (text): The booking session, for the booking step. It expires after a while.
- `slots` (list): Each time, with who is free then
- `start_times` (list): The times that can be booked (ISO 8601)

**Example output**

```json
{
  "assignments": [],
  "booking_url": "https://acme.chilipiper.com/concierge-router/link/rt_01HXAMPLE",
  "distribution_ids": [],
  "scheduling_allowed": true,
  "session_id": "rt_01HXAMPLE",
  "slots": [
    {
      "attendees": [],
      "startTime": "2026-11-10T15:00:00Z"
    }
  ],
  "start_times": [
    "2026-11-10T15:00:00Z"
  ]
}
```
