Chili Piper

App · 19 actions

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.

Actions

ActionWhat it does
Add people to teamAdd people to a team so meetings routed to it can go to them.
Book an open timeBook one of the times 'Find open times' returned, for a guest.
Book meetingBook a meeting with one person on one of their own meeting types, at a time they are free (see 'Find open times').
Book the routed meetingBook one of the open times 'Route a lead' returned, with the rep the router picked.
Cancel meetingCancel a meeting.
Find open timesFind the times that can be booked on a team scheduling link, or on one person's own meeting type.
Find usersFind people in your organization by name or email address.
Get meetingGet one meeting with its time, people, status and where it was booked from.
Get meeting linkGet the link that opens a meeting's activity page in Chili Piper, to share with the team.
Get userGet one person's profile: workspaces, licences, working hours and time zone.
Invite userAdd a new person to your Chili Piper organization, such as a new rep.
List meetingsList the meetings in a window of up to 7 days, with their time, host, guest and status.
List teamsList teams with their members, the people meetings are routed to.
List workspacesList your organization's workspaces.
Mark meeting as attendedRecord that the guest came, which also undoes a no-show mark.
Mark meeting as no-showRecord that the guest didn't come.
Remove people from teamRemove people from a team, such as someone going on leave, so no more meetings are routed to them through it.
Reschedule or reassign meetingMove a meeting to another time, hand it to another host, or both.
Route a leadRun 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.

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

Teamchili_team_idtextRequired
The team. Pick one, or give its ID from an earlier step.
Peoplechili_user_idslistRequired
The people to add or take off. Pick them, or give their IDs.

Outputs

teamobject
The team, as it is now
user_idslist
The people asked for
Example output
{
  "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 sessionsession_idtextRequired
The 'session_id' from 'Find open times'.
Startstart_timedate and timeRequired
One of the 'start_times' that step returned.
Guest emailguest_emailtextRequired
The email address of the person the meeting is with.
Guest time zoneguest_time_zonetext
The guest's time zone, such as America/New_York.
Guest form answersform_answersobject
Answers to the link's guest form, by field, such as PersonFirstName. 'Find open times' lists the fields.
Other guestsadditional_guestslist
Email addresses of anyone else to invite. Their calendars aren't checked.

Outputs

guest_emailtext
Who it is with
meeting_idtext
The new meeting's ID, for the other meeting actions
start_timetext
When it starts (ISO 8601)
Example output
{
  "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

Hosthost_user_idtextRequired
The person the meeting is with.
Meeting typemeeting_type_idtextRequired
One of the host's own meeting types, which sets its length and location.
Startstart_timedate and timeRequired
When the meeting starts. The host must be free then.
Guest emailguest_emailtextRequired
The email address of the person the meeting is with.
Guest first nameguest_first_nametext
The guest's first name. Most meeting types ask for it.
Guest last nameguest_last_nametext
The guest's last name. Most meeting types ask for it.
Guest time zoneguest_time_zonetext
The guest's time zone, such as America/New_York.
Other guestsadditional_guestslist
Email addresses of anyone else to invite. Their calendars aren't checked.
Notify the hostnotify_teamtrue/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_emailtext
Who it is with
meeting_idtext
The new meeting's ID, for the other meeting actions
start_timetext
When it starts (ISO 8601)
Example output
{
  "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 sessionsession_idtextRequired
The 'session_id' from 'Route a lead'.
Startstart_timedate and timeRequired
One of the 'start_times' that step returned.
Other guestsadditional_guestslist
Email addresses of anyone else to invite. Their calendars aren't checked.

Outputs

meeting_idtext
The new meeting's ID
start_timetext
When it starts (ISO 8601)
Example output
{
  "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 IDmeeting_idtextRequired
The meeting's ID, from a Chili Piper trigger, 'List meetings' or a booking step.

Outputs

meetingobject
The meeting, as it is now
meeting_idtext
The meeting's ID
Example output
{
  "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 linkscheduling_linktext
A round robin, group or ownership link. Leave empty to use a host and their meeting type instead.
Hosthost_user_idtext
Without a team link: the person to meet.
Meeting typemeeting_type_idtext
Without a team link: one of the host's own meeting types. With a link that offers several: which one.
Fromstart_fromdate and time
Look for times from this moment. Defaults to now.
Days to look aheaddaysnumber
How many days of times to find, 1 to 31. Defaults to 7.From 1 to 31.
Guest emailguest_emailtext
The guest's email. Needed for an ownership link, to find their owner in the CRM.
Guest time zoneguest_time_zonetext
The guest's time zone, such as America/New_York.

Outputs

countnumber
How many came back
durationtext
How long the meeting would be
failuresobject
People whose calendars couldn't be read, and why
form_fieldslist
The guest form's fields, for 'Guest form answers'
session_idtext
The booking session, for the booking step. It expires after a while.
slotslist
Each time, with who is free then
start_timeslist
The times that can be booked (ISO 8601)
Example output
{
  "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

SearchquerytextRequired
A name or email address, or part of one.
Pagepagenumber
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 sizepage_sizenumber
How many users per page, 1 to 50. Defaults to 50.From 1 to 50.

Outputs

countnumber
How many came back
has_moretrue/false
Whether there is another page
next_pagenumber
The page to ask for next, or empty on the last page
pagenumber
The page this is, from 0
totalnumber
How many there are in all
userslist
The people found
Example output
{
  "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 IDmeeting_idtextRequired
The meeting's ID, from a Chili Piper trigger, 'List meetings' or a booking step.

Outputs

meetingobject
The meeting
Example output
{
  "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 the link that opens a meeting's activity page in Chili Piper, to share with the team.

Inputs

Meeting IDmeeting_idtextRequired
The meeting's ID, from a Chili Piper trigger, 'List meetings' or a booking step.

Outputs

meeting_idtext
The meeting's ID
urltext
The link to the meeting in Chili Piper
Example output
{
  "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

Userchili_user_idtextRequired
The person. Pick one, or give their ID from an earlier step.

Outputs

userobject
The user
Example output
{
  "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

EmailemailtextRequired
Their work email address. It must be new to Chili Piper.
Namenametext
Their full name.
Roleroletext
User or Admin. Defaults to User.One of: User, Admin.
Licenceslicenseslist
The Chili Piper products they can use.One or more of: ChiliCalOrg (ChiliCal), Concierge, ConciergeLive (Concierge Live), Distro, Handoff, Chat.
Workspacesworkspace_idslist
Only these workspaces. Leave empty for all of them.
Email the invitation nowsend_invitetrue/false
Send them Chili Piper's invitation email straight away.

Outputs

emailtext
Their email address
invitedtrue/false
Whether the invitation email was sent
user_idtext
The new person's ID
Example output
{
  "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

Fromstartdate and time
Meetings that start at or after this. Defaults to now.
Untilenddate and time
Meetings that start before this, at most 7 days after 'From'. Defaults to 7 days after it.
Workspacesworkspace_idslist
Only these workspaces. Leave empty for all of them.
Statusstatuseslist
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.
Hostshost_idslist
Only meetings these people host. Leave empty for all.
Guest emailguest_emailtext
Only meetings with this guest.
Pagepagenumber
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 sizepage_sizenumber
How many meetings per page, 1 to 50. Defaults to 50.From 1 to 50.

Outputs

countnumber
How many came back
has_moretrue/false
Whether there is another page
meetingslist
The meetings
next_pagenumber
The page to ask for next, or empty on the last page
pagenumber
The page this is, from 0
totalnumber
How many there are in all
Example output
{
  "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

Workspacesworkspace_idslist
Only these workspaces. Leave empty for all of them.
Name containsnametext
Only teams whose name contains this.
With membersmember_idslist
Only teams with any of these people in them.
Pagepagenumber
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 sizepage_sizenumber
How many teams per page, 1 to 50. Defaults to 50.From 1 to 50.

Outputs

countnumber
How many came back
has_moretrue/false
Whether there is another page
next_pagenumber
The page to ask for next, or empty on the last page
pagenumber
The page this is, from 0
teamslist
The teams
totalnumber
How many there are in all
Example output
{
  "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 containsnametext
Only workspaces whose name contains this.
Pagepagenumber
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 sizepage_sizenumber
How many workspaces per page, 1 to 50. Defaults to 50.From 1 to 50.

Outputs

countnumber
How many came back
has_moretrue/false
Whether there is another page
next_pagenumber
The page to ask for next, or empty on the last page
pagenumber
The page this is, from 0
totalnumber
How many there are in all
workspaceslist
The workspaces
Example output
{
  "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 IDmeeting_idtextRequired
The meeting's ID, from a Chili Piper trigger, 'List meetings' or a booking step.

Outputs

meetingobject
The meeting, as it is now
meeting_idtext
The meeting's ID
Example output
{
  "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 IDmeeting_idtextRequired
The meeting's ID, from a Chili Piper trigger, 'List meetings' or a booking step.

Outputs

meetingobject
The meeting, as it is now
meeting_idtext
The meeting's ID
Example output
{
  "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

Teamchili_team_idtextRequired
The team. Pick one, or give its ID from an earlier step.
Peoplechili_user_idslistRequired
The people to add or take off. Pick them, or give their IDs.

Outputs

teamobject
The team, as it is now
user_idslist
The people asked for
Example output
{
  "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 IDmeeting_idtextRequired
The meeting's ID, from a Chili Piper trigger, 'List meetings' or a booking step.
New startstart_timedate and time
The new time. Leave empty to keep it.
New hosthost_user_idtext
Who should host it instead. Leave empty to keep the host.

Outputs

changedlist
What was changed: startTime, hostId
meetingobject
The meeting, as it is now
meeting_idtext
The meeting's ID
Example output
{
  "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

Routerrouter_slugtextRequired
The Concierge router. Pick one, or type its slug.
Lead detailsformobjectRequired
The lead's answers, by the field names your router uses, such as PersonEmail and PersonFirstName.
Where the lead came fromtriggertext
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 zoneguest_time_zonetext
The guest's time zone, such as America/New_York.
Pagesource_urltext
The web page the lead came from, for your reports.
Open times for the nextdaysnumber
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

assignmentslist
Who the lead was routed to
booking_urltext
The link the lead can book with
distribution_idslist
The distributions used
scheduling_allowedtrue/false
Whether the route lets the lead book
session_idtext
The booking session, for the booking step. It expires after a while.
slotslist
Each time, with who is free then
start_timeslist
The times that can be booked (ISO 8601)
Example output
{
  "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"
  ]
}

On this page