Zoho Backstage
App · Events · 20 actions
Event management. Create and update events, add speakers and sessions, register attendees, and read orders, tickets and attendees.
Actions
| Action | What it does |
|---|---|
| Add a speaker | Add a speaker to an event. |
| Create a session | Add a session to an event's agenda. |
| Create an event | Create an event. |
| Create an order | Register someone for an event: an order for one ticket of the chosen class. |
| Delete an event | Delete an event, with its speakers, agenda, tickets and orders. |
| Get a session | Get a session's details and speakers. |
| Get a speaker | Get a speaker's profile. |
| Get an attendee | Get an attendee's ticket, order and contact details. |
| Get an event | Get an event's details, dates and venue. |
| Get an order | Get an order's purchaser, tickets and cost. |
| List attendees | List an event's attendees, optionally for one ticket. |
| List event members | List the people on an event's organizing team and their roles. |
| List events | List the portal's events, optionally filtered by status. |
| List orders | List an event's ticket orders. |
| List portals | List the Backstage portals this connection reaches. |
| List sessions | List the sessions on an event's agenda, optionally for one day. |
| List speakers | List an event's speakers. |
| List ticket classes | List an event's ticket classes, with prices and how many are sold. |
| List tracks | List the tracks of an event's agenda. |
| Update an event | Change an event's name, time zone, dates or details. |
Add a speaker
Add a speaker to an event. They start as invited. The Free plan allows 3 speakers per event.
Inputs
- Event
event_idtextRequired - The event. Pick one, or enter an event id from 'List events' or 'Create an event'.
- Email
emailtextRequired - The speaker's email address.
- First name
first_nametextRequired - The speaker's first name.
- Last name
last_nametext - Optional.
- Company
companytext - Optional.
- Job title
designationtext - Optional.
- Biography
descriptiontext - Optional. A short biography.
- Country
countrytext - Optional. A two-letter country code, such as US.
- Phone
telephonetext - Optional.
- Skills
skillslist - Optional. The speaker's skills, such as Sales, Marketing.
- Featured
featuredtrue/false - Optional. Feature the speaker on the event site.
- LinkedIn
linkedintext - Optional. Their LinkedIn profile address.
- X (Twitter)
twittertext - Optional. Their X (Twitter) profile address.
- Facebook
facebooktext - Optional. Their Facebook profile address.
- Instagram
instagramtext - Optional. Their Instagram profile address.
- Portal
portal_idtext - Optional. The Backstage portal to use. Leave blank for your default portal.
Outputs
A speaker at the event.
added_ontext- When they were added.
alternate_telephonetext- Another phone number.
companytext- Their company.
countrytext- Their two-letter country code.
descriptiontext- Their biography.
designationtext- Their job title.
emailtext- Their email address.
facebooktext- Their Facebook profile.
featuredtrue/false- Whether they are featured.
first_nametext- Their first name.
idtext- The speaker's id.
instagramtext- Their Instagram profile.
joined_ontext- When they joined.
last_nametext- Their last name.
linkedintext- Their LinkedIn profile.
mediumtext- Their Medium profile.
skillstext- Their skills, comma-separated.
statusnumber- 0 invited, 1 joined.
status_stringtext- The status as text.
telegramtext- Their Telegram profile.
telephonetext- Their phone number.
twittertext- Their X (Twitter) profile.
Example output
{
"company": "Acme",
"country": "US",
"designation": "CTO",
"email": "speaker@example.com",
"featured": false,
"first_name": "Sam",
"id": "2263000000013001",
"last_name": "Speaker",
"status": 0,
"status_string": "invited"
}Create a session
Add a session to an event's agenda. The Free plan allows 3 sessions per event, each at most 45 minutes.
Inputs
- Event
event_idtextRequired - The event. Pick one, or enter an event id from 'List events' or 'Create an event'.
- Title
titletextRequired - The session's title.
- Track
track_idtextRequired - The track it belongs to, from 'List tracks'.
- Starts
start_timedate and timeRequired - When it starts. It must fall within the event.
- Duration (minutes)
durationnumber - Optional. How long it lasts, in minutes.From 1 to 1440.
- Session type
session_typetext - Optional. Such as KEYNOTE, PRESENTATION or BREAK. Defaults to KEYNOTE.Default:
KEYNOTE. - Day
daynumber - Optional. Which day of the event, counting from 1.At least 1. Default:
1. - Speakers
speaker_emailslist - Optional. The email addresses of the event's speakers who present it.
- Featured
featuredtrue/false - Optional. Feature the session.
- Hidden
hiddentrue/false - Optional. Hide it from attendees.
- Time to be announced
time_to_be_announcedtrue/false - Optional. Show the time as to be announced.
- Venue to be announced
venue_to_be_announcedtrue/false - Optional. Show the venue as to be announced.
- Portal
portal_idtext - Optional. The Backstage portal to use. Leave blank for your default portal.
Outputs
A session on the event's agenda.
agendatext- The agenda it belongs to.
created_byobject- A Backstage user.
created_timetext- When it was created.
descriptiontext- Its description.
durationnumber- How long it lasts, in minutes.
featuredtrue/false- Whether it is featured.
hiddentrue/false- Whether it is hidden from attendees.
idtext- The session's id.
languagetext- Its language code.
last_modified_byobject- A Backstage user.
last_modified_timetext- When it was last changed.
session_typetext- Its type, e.g. KEYNOTE.
speaker_to_be_announcedtrue/false- Whether its speaker is still to be announced.
speakerslist- Its speakers.
start_timetext- When it starts, in UTC.
titletext- The session's title.
tracktext- The id of its track.
venuetext- The hall it takes place in.
venue_to_be_announcedtrue/false- Whether its venue is still to be announced.
Example output
{
"duration": 30,
"featured": false,
"hidden": false,
"id": "2263000000014001",
"session_type": "KEYNOTE",
"speakers": [
{
"company": "Acme",
"country": "US",
"designation": "CTO",
"email": "speaker@example.com",
"featured": false,
"first_name": "Sam",
"id": "2263000000013001",
"last_name": "Speaker",
"status": 0,
"status_string": "invited"
}
],
"start_time": "2026-11-04T15:00:00Z",
"title": "Opening keynote",
"track": "2263000000011021"
}Create an event
Create an event. It starts unpublished.
Inputs
- Name
nametextRequired - The event's name.
- Time zone
timezonetextRequired - The event's time zone.One of:
Africa/Abidjan,Africa/Accra,Africa/Addis_Ababa,Africa/Algiers,Africa/Asmara,Africa/Asmera,Africa/Bamako,Africa/Bangui,Africa/Banjul,Africa/Bissau, and 544 more. Default:UTC. - Starts
start_timedate and timeRequired - When the event starts.
- Ends
end_timedate and timeRequired - When the event ends. The Free plan allows one event day.
- Event type
event_typetext - Optional. In person, online or hybrid.One of:
venue(In person (venue)),online,hybrid. - Language
languagetext - Optional. The event's language code, such as en.
- Summary
summarytext - Optional. A short summary.
- Description
descriptiontext - Optional. The full description; HTML is allowed.
- Category
categorytext - Optional. The event's category, such as Sales.
- Portal
portal_idtext - Optional. The Backstage portal to use. Leave blank for your default portal.
Outputs
A Zoho Backstage event.
categorytext- The event's category.
created_byobject- A Backstage user.
created_timetext- When it was created.
descriptiontext- The event's description (HTML).
end_timetext- When it ends, in UTC.
event_typenumber- 2 venue, 3 online, 4 hybrid.
event_type_stringtext- The event type as text.
idtext- The event's id.
languagetext- The event's language code, e.g. en.
last_modified_byobject- A Backstage user.
last_modified_timetext- When it was last changed.
nametext- The event's name.
spaceobject- The event's space.
start_timetext- When it starts, in UTC, e.g. 2026-11-04T09:00:00Z.
statusnumber- 0 unpublished, 1 published, 2 running, 3 completed, 4 canceled.
status_stringtext- The status as text, e.g. unpublished.
summarytext- A short summary.
tagslist- The event's tags.
thumbnail_urltext- The event's thumbnail image.
timezonetext- The event's IANA time zone, e.g. America/New_York.
venueobject- Where the event takes place.
website_urltext- The event website's address.
Example output
{
"category": "Sales",
"created_by": {
"company": "Acme",
"designation": "Organizer",
"email": "owner@example.com",
"first_name": "Ola",
"id": "2263000000002003"
},
"created_time": "2026-10-01T09:00:00Z",
"description": "<p>Our yearly summit.</p>",
"end_time": "2026-11-04T22:00:00Z",
"event_type": 3,
"event_type_string": "online",
"id": "2263000000011005",
"language": "en",
"last_modified_by": {
"company": "Acme",
"designation": "Organizer",
"email": "owner@example.com",
"first_name": "Ola",
"id": "2263000000002003"
},
"last_modified_time": "2026-10-01T09:00:00Z",
"name": "Customer Summit",
"space": {
"id": "2263000000011001"
},
"start_time": "2026-11-04T14:00:00Z",
"status": 0,
"status_string": "unpublished",
"summary": "Our yearly summit.",
"tags": [],
"timezone": "America/New_York",
"website_url": "https://example.zohobackstage.com/CustomerSummit"
}Create an order
Register someone for an event: an order for one ticket of the chosen class. The attendee is the purchaser unless named.
Inputs
- Event
event_idtextRequired - The event. Pick one, or enter an event id from 'List events' or 'Create an event'.
- Ticket class
ticket_class_idtextRequired - The ticket class, from 'List ticket classes'.
- Purchaser first name
purchaser_first_nametextRequired - The buyer's first name.
- Purchaser last name
purchaser_last_nametext - Optional.
- Purchaser email
purchaser_emailtextRequired - The buyer's email address.
- Purchaser company
purchaser_companytext - Optional.
- Purchaser mobile
purchaser_mobile_notext - Optional.
- Attendee first name
attendee_first_nametext - Optional. Defaults to the purchaser's.
- Attendee last name
attendee_last_nametext - Optional. Defaults to the purchaser's.
- Attendee email
attendee_emailtext - Optional. Defaults to the purchaser's.
- Billing address line 1
billing_address_line_1text - Optional. The billing address is sent only when given.
- Billing address line 2
billing_address_line_2text - Optional.
- Billing city
billing_citytext - Optional.
- Billing state
billing_statetext - Optional.
- Billing country
billing_countrytext - Optional.
- Billing postal code
billing_zip_codetext - Optional.
- Portal
portal_idtext - Optional. The Backstage portal to use. Leave blank for your default portal.
Outputs
An order for tickets.
billing_addressobject- The billing address.
contactobject- The purchaser.
costobject- What the order costs.
created_timetext- When it was placed.
idtext- The order's id.
last_modified_timetext- When it was last changed.
order_bytext- The purchaser's email address.
origin_stringtext- The order's origin as text.
payment_option_nametext- The payment option's name.
payment_statusnumber- 1 paid, 2 unpaid.
payment_status_stringtext- The payment status as text.
payment_typenumber- How it was paid for.
payment_type_stringtext- The payment type as text.
sourcenumber- Where the order came from.
source_stringtext- The source as text, e.g. api.
statusnumber- 0 placed, 1 cancelled, 3 paid to the organizer.
status_stringtext- The status as text.
ticketslist- The order's tickets.
Example output
{
"contact": {
"purchaser_email": "buyer@example.com",
"purchaser_first_name": "Bea",
"purchaser_last_name": "Buyer"
},
"cost": {
"sub_total": 0,
"total": 0
},
"created_time": "2026-10-02T10:00:00Z",
"id": "2263000000015001",
"order_by": "buyer@example.com",
"payment_status": 1,
"payment_status_string": "paid",
"source_string": "api",
"status": 0,
"status_string": "placed",
"tickets": [
{
"contact": {
"email": "buyer@example.com",
"first_name": "Bea",
"last_name": "Buyer"
},
"id": "2263000000015011",
"ticket_class_id": "2263000000011031",
"ticket_name": "General admission",
"total": 0
}
]
}Delete an event
Delete an event, with its speakers, agenda, tickets and orders.
Inputs
- Event
event_idtextRequired - The event. Pick one, or enter an event id from 'List events' or 'Create an event'.
- Portal
portal_idtext - Optional. The Backstage portal to use. Leave blank for your default portal.
Outputs
The outcome of deleting an event.
deletedtrue/false- Always true: a refusal raises an error instead.
event_idtext- The deleted event's id.
messagetext- Zoho's confirmation, without its HTML.
Example output
{
"deleted": true,
"event_id": "2263000000011005",
"message": "Your Customer Summit event has been deleted"
}Get a session
Get a session's details and speakers.
Inputs
- Event
event_idtextRequired - The event. Pick one, or enter an event id from 'List events' or 'Create an event'.
- Session ID
session_idtextRequired - The session's id, from 'List sessions' or 'Create a session'.
- Portal
portal_idtext - Optional. The Backstage portal to use. Leave blank for your default portal.
Outputs
A session on the event's agenda.
agendatext- The agenda it belongs to.
created_byobject- A Backstage user.
created_timetext- When it was created.
descriptiontext- Its description.
durationnumber- How long it lasts, in minutes.
featuredtrue/false- Whether it is featured.
hiddentrue/false- Whether it is hidden from attendees.
idtext- The session's id.
languagetext- Its language code.
last_modified_byobject- A Backstage user.
last_modified_timetext- When it was last changed.
session_typetext- Its type, e.g. KEYNOTE.
speaker_to_be_announcedtrue/false- Whether its speaker is still to be announced.
speakerslist- Its speakers.
start_timetext- When it starts, in UTC.
titletext- The session's title.
tracktext- The id of its track.
venuetext- The hall it takes place in.
venue_to_be_announcedtrue/false- Whether its venue is still to be announced.
Example output
{
"duration": 30,
"featured": false,
"hidden": false,
"id": "2263000000014001",
"session_type": "KEYNOTE",
"speakers": [
{
"company": "Acme",
"country": "US",
"designation": "CTO",
"email": "speaker@example.com",
"featured": false,
"first_name": "Sam",
"id": "2263000000013001",
"last_name": "Speaker",
"status": 0,
"status_string": "invited"
}
],
"start_time": "2026-11-04T15:00:00Z",
"title": "Opening keynote",
"track": "2263000000011021"
}Get a speaker
Get a speaker's profile.
Inputs
- Event
event_idtextRequired - The event. Pick one, or enter an event id from 'List events' or 'Create an event'.
- Speaker ID
speaker_idtextRequired - The speaker's id, from 'List speakers' or 'Add a speaker'.
- Portal
portal_idtext - Optional. The Backstage portal to use. Leave blank for your default portal.
Outputs
A speaker at the event.
added_ontext- When they were added.
alternate_telephonetext- Another phone number.
companytext- Their company.
countrytext- Their two-letter country code.
descriptiontext- Their biography.
designationtext- Their job title.
emailtext- Their email address.
facebooktext- Their Facebook profile.
featuredtrue/false- Whether they are featured.
first_nametext- Their first name.
idtext- The speaker's id.
instagramtext- Their Instagram profile.
joined_ontext- When they joined.
last_nametext- Their last name.
linkedintext- Their LinkedIn profile.
mediumtext- Their Medium profile.
skillstext- Their skills, comma-separated.
statusnumber- 0 invited, 1 joined.
status_stringtext- The status as text.
telegramtext- Their Telegram profile.
telephonetext- Their phone number.
twittertext- Their X (Twitter) profile.
Example output
{
"company": "Acme",
"country": "US",
"designation": "CTO",
"email": "speaker@example.com",
"featured": false,
"first_name": "Sam",
"id": "2263000000013001",
"last_name": "Speaker",
"status": 0,
"status_string": "invited"
}Get an attendee
Get an attendee's ticket, order and contact details.
Inputs
- Event
event_idtextRequired - The event. Pick one, or enter an event id from 'List events' or 'Create an event'.
- Attendee ID
attendee_idtextRequired - The attendee's id, from 'List attendees'.
- Portal
portal_idtext - Optional. The Backstage portal to use. Leave blank for your default portal.
Outputs
An attendee of the event.
affiliate_nametext- The affiliate the ticket came through.
contactobject- The attendee's details.
created_timetext- When it was created.
event_idtext- The event's id.
idtext- The attendee's id.
last_modified_timetext- When it was last changed.
order_idtext- The id of the order that bought the ticket.
portaltext- The portal's id.
promo_codetext- The promo code used.
purchased_bytext- Who bought the ticket.
statusnumber- 0 not attending, 1 attending.
status_stringtext- The status as text.
ticket_class_idtext- The ticket class's id.
ticket_idtext- The ticket's id.
ticket_nametext- The ticket class's name.
Example output
{
"contact": {
"email": "buyer@example.com",
"first_name": "Bea",
"last_name": "Buyer"
},
"event_id": "2263000000011005",
"id": "2263000000016001",
"order_id": "2263000000015001",
"portal": "2263000000002001",
"status": 1,
"status_string": "attending",
"ticket_class_id": "2263000000011031",
"ticket_id": "2263000000015011",
"ticket_name": "General admission"
}Get an event
Get an event's details, dates and venue.
Inputs
- Event
event_idtextRequired - The event. Pick one, or enter an event id from 'List events' or 'Create an event'.
- Portal
portal_idtext - Optional. The Backstage portal to use. Leave blank for your default portal.
Outputs
A Zoho Backstage event.
categorytext- The event's category.
created_byobject- A Backstage user.
created_timetext- When it was created.
descriptiontext- The event's description (HTML).
end_timetext- When it ends, in UTC.
event_typenumber- 2 venue, 3 online, 4 hybrid.
event_type_stringtext- The event type as text.
idtext- The event's id.
languagetext- The event's language code, e.g. en.
last_modified_byobject- A Backstage user.
last_modified_timetext- When it was last changed.
nametext- The event's name.
spaceobject- The event's space.
start_timetext- When it starts, in UTC, e.g. 2026-11-04T09:00:00Z.
statusnumber- 0 unpublished, 1 published, 2 running, 3 completed, 4 canceled.
status_stringtext- The status as text, e.g. unpublished.
summarytext- A short summary.
tagslist- The event's tags.
thumbnail_urltext- The event's thumbnail image.
timezonetext- The event's IANA time zone, e.g. America/New_York.
venueobject- Where the event takes place.
website_urltext- The event website's address.
Example output
{
"category": "Sales",
"created_by": {
"company": "Acme",
"designation": "Organizer",
"email": "owner@example.com",
"first_name": "Ola",
"id": "2263000000002003"
},
"created_time": "2026-10-01T09:00:00Z",
"description": "<p>Our yearly summit.</p>",
"end_time": "2026-11-04T22:00:00Z",
"event_type": 3,
"event_type_string": "online",
"id": "2263000000011005",
"language": "en",
"last_modified_by": {
"company": "Acme",
"designation": "Organizer",
"email": "owner@example.com",
"first_name": "Ola",
"id": "2263000000002003"
},
"last_modified_time": "2026-10-01T09:00:00Z",
"name": "Customer Summit",
"space": {
"id": "2263000000011001"
},
"start_time": "2026-11-04T14:00:00Z",
"status": 0,
"status_string": "unpublished",
"summary": "Our yearly summit.",
"tags": [],
"timezone": "America/New_York",
"website_url": "https://example.zohobackstage.com/CustomerSummit"
}Get an order
Get an order's purchaser, tickets and cost.
Inputs
- Event
event_idtextRequired - The event. Pick one, or enter an event id from 'List events' or 'Create an event'.
- Order ID
order_idtextRequired - The order's id, from 'List orders' or 'Create an order'.
- Portal
portal_idtext - Optional. The Backstage portal to use. Leave blank for your default portal.
Outputs
An order for tickets.
billing_addressobject- The billing address.
contactobject- The purchaser.
costobject- What the order costs.
created_timetext- When it was placed.
idtext- The order's id.
last_modified_timetext- When it was last changed.
order_bytext- The purchaser's email address.
origin_stringtext- The order's origin as text.
payment_option_nametext- The payment option's name.
payment_statusnumber- 1 paid, 2 unpaid.
payment_status_stringtext- The payment status as text.
payment_typenumber- How it was paid for.
payment_type_stringtext- The payment type as text.
sourcenumber- Where the order came from.
source_stringtext- The source as text, e.g. api.
statusnumber- 0 placed, 1 cancelled, 3 paid to the organizer.
status_stringtext- The status as text.
ticketslist- The order's tickets.
Example output
{
"contact": {
"purchaser_email": "buyer@example.com",
"purchaser_first_name": "Bea",
"purchaser_last_name": "Buyer"
},
"cost": {
"sub_total": 0,
"total": 0
},
"created_time": "2026-10-02T10:00:00Z",
"id": "2263000000015001",
"order_by": "buyer@example.com",
"payment_status": 1,
"payment_status_string": "paid",
"source_string": "api",
"status": 0,
"status_string": "placed",
"tickets": [
{
"contact": {
"email": "buyer@example.com",
"first_name": "Bea",
"last_name": "Buyer"
},
"id": "2263000000015011",
"ticket_class_id": "2263000000011031",
"ticket_name": "General admission",
"total": 0
}
]
}List attendees
List an event's attendees, optionally for one ticket.
Inputs
- Event
event_idtextRequired - The event. Pick one, or enter an event id from 'List events' or 'Create an event'.
- Ticket ID
ticket_idtext - Optional. Only the attendee holding this ticket.
- Page
pagenumber - Optional. Which page of results to return, starting at 1.At least 1.
- Page size
per_pagenumber - Optional. How many to return per page, 1 to 200. Zoho's default is 200.From 1 to 200.
- Portal
portal_idtext - Optional. The Backstage portal to use. Leave blank for your default portal.
Outputs
attendeeslist- The attendees.
countnumber- How many attendees are in this answer.
has_moretrue/false- Whether another page is available.
pagenumber- This page's number, when Zoho pages the list.
per_pagenumber- The page size, when Zoho pages the list.
total_countnumber- How many attendees there are in all, when Zoho says.
Example output
{
"attendees": [
{
"contact": {
"email": "buyer@example.com",
"first_name": "Bea",
"last_name": "Buyer"
},
"event_id": "2263000000011005",
"id": "2263000000016001",
"order_id": "2263000000015001",
"portal": "2263000000002001",
"status": 1,
"status_string": "attending",
"ticket_class_id": "2263000000011031",
"ticket_id": "2263000000015011",
"ticket_name": "General admission"
}
],
"count": 1,
"has_more": false,
"page": 1,
"per_page": 200,
"total_count": 1
}List event members
List the people on an event's organizing team and their roles.
Inputs
- Event
event_idtextRequired - The event. Pick one, or enter an event id from 'List events' or 'Create an event'.
- Portal
portal_idtext - Optional. The Backstage portal to use. Leave blank for your default portal.
Outputs
countnumber- How many event members are in this answer.
has_moretrue/false- Whether another page is available.
memberslist- The event members.
pagenumber- This page's number, when Zoho pages the list.
per_pagenumber- The page size, when Zoho pages the list.
total_countnumber- How many event members there are in all, when Zoho says.
Example output
{
"count": 1,
"has_more": false,
"members": [
{
"email": "owner@example.com",
"first_name": "Ola",
"id": "2263000000002003",
"last_name": "Owner",
"role": "Event Owner",
"status": 1,
"status_string": "joined"
}
],
"page": 1,
"per_page": 200,
"total_count": 1
}List events
List the portal's events, optionally filtered by status.
Inputs
- Status
statustext - Optional. Only events in this state.One of:
all,running,live(Live (published)),drafts,completed,canceled,trash. - Sort by
sort_bytext - Optional. Which date to sort by.One of:
start_date(Start date),created_time(Created time),last_modified_time(Last modified time). - Order
sort_ordertext - Optional. Ascending or descending.One of:
asc(Oldest first),desc(Newest first). - Page
pagenumber - Optional. Which page of results to return, starting at 1.At least 1.
- Page size
per_pagenumber - Optional. How many to return per page, 1 to 200. Zoho's default is 200.From 1 to 200.
- Portal
portal_idtext - Optional. The Backstage portal to use. Leave blank for your default portal.
Outputs
countnumber- How many events are in this answer.
eventslist- The events.
has_moretrue/false- Whether another page is available.
pagenumber- This page's number, when Zoho pages the list.
per_pagenumber- The page size, when Zoho pages the list.
total_countnumber- How many events there are in all, when Zoho says.
Example output
{
"count": 1,
"events": [
{
"category": "Sales",
"created_by": {
"company": "Acme",
"designation": "Organizer",
"email": "owner@example.com",
"first_name": "Ola",
"id": "2263000000002003"
},
"created_time": "2026-10-01T09:00:00Z",
"description": "<p>Our yearly summit.</p>",
"end_time": "2026-11-04T22:00:00Z",
"event_type": 3,
"event_type_string": "online",
"id": "2263000000011005",
"language": "en",
"last_modified_by": {
"company": "Acme",
"designation": "Organizer",
"email": "owner@example.com",
"first_name": "Ola",
"id": "2263000000002003"
},
"last_modified_time": "2026-10-01T09:00:00Z",
"name": "Customer Summit",
"space": {
"id": "2263000000011001"
},
"start_time": "2026-11-04T14:00:00Z",
"status": 0,
"status_string": "unpublished",
"summary": "Our yearly summit.",
"tags": [],
"timezone": "America/New_York",
"website_url": "https://example.zohobackstage.com/CustomerSummit"
}
],
"has_more": false,
"page": 1,
"per_page": 200,
"total_count": 1
}List orders
List an event's ticket orders.
Inputs
- Event
event_idtextRequired - The event. Pick one, or enter an event id from 'List events' or 'Create an event'.
- Status
statustext - Optional. Only placed or only cancelled orders.One of:
all,placed,cancelled. - Order
sort_ordertext - Optional. Ascending or descending.One of:
asc(Oldest first),desc(Newest first). - Page
pagenumber - Optional. Which page of results to return, starting at 1.At least 1.
- Page size
per_pagenumber - Optional. How many to return per page, 1 to 200. Zoho's default is 200.From 1 to 200.
- Portal
portal_idtext - Optional. The Backstage portal to use. Leave blank for your default portal.
Outputs
countnumber- How many orders are in this answer.
has_moretrue/false- Whether another page is available.
orderslist- The orders.
pagenumber- This page's number, when Zoho pages the list.
per_pagenumber- The page size, when Zoho pages the list.
total_countnumber- How many orders there are in all, when Zoho says.
Example output
{
"count": 1,
"has_more": false,
"orders": [
{
"contact": {
"purchaser_email": "buyer@example.com",
"purchaser_first_name": "Bea",
"purchaser_last_name": "Buyer"
},
"cost": {
"sub_total": 0,
"total": 0
},
"created_time": "2026-10-02T10:00:00Z",
"id": "2263000000015001",
"order_by": "buyer@example.com",
"payment_status": 1,
"payment_status_string": "paid",
"source_string": "api",
"status": 0,
"status_string": "placed",
"tickets": [
{
"contact": {
"email": "buyer@example.com",
"first_name": "Bea",
"last_name": "Buyer"
},
"id": "2263000000015011",
"ticket_class_id": "2263000000011031",
"ticket_name": "General admission",
"total": 0
}
]
}
],
"page": 1,
"per_page": 200,
"total_count": 1
}List portals
List the Backstage portals this connection reaches.
Inputs
None.
Outputs
countnumber- How many portals are in this answer.
has_moretrue/false- Whether another page is available.
pagenumber- This page's number, when Zoho pages the list.
per_pagenumber- The page size, when Zoho pages the list.
portalslist- The portals.
total_countnumber- How many portals there are in all, when Zoho says.
Example output
{
"count": 1,
"has_more": false,
"page": 1,
"per_page": 200,
"portals": [
{
"domain": "acme",
"id": "2263000000002001",
"is_default": true,
"name": "Acme Events",
"owner_email": "owner@example.com",
"owner_name": "Ola Owner"
}
],
"total_count": 1
}List sessions
List the sessions on an event's agenda, optionally for one day.
Inputs
- Event
event_idtextRequired - The event. Pick one, or enter an event id from 'List events' or 'Create an event'.
- Day
daynumber - Optional. Only this day of the event, counting from 1.At least 1.
- Portal
portal_idtext - Optional. The Backstage portal to use. Leave blank for your default portal.
Outputs
countnumber- How many sessions are in this answer.
has_moretrue/false- Whether another page is available.
pagenumber- This page's number, when Zoho pages the list.
per_pagenumber- The page size, when Zoho pages the list.
sessionslist- The sessions.
total_countnumber- How many sessions there are in all, when Zoho says.
Example output
{
"count": 1,
"has_more": false,
"page": 1,
"per_page": 200,
"sessions": [
{
"duration": 30,
"featured": false,
"hidden": false,
"id": "2263000000014001",
"session_type": "KEYNOTE",
"speakers": [
{
"company": "Acme",
"country": "US",
"designation": "CTO",
"email": "speaker@example.com",
"featured": false,
"first_name": "Sam",
"id": "2263000000013001",
"last_name": "Speaker",
"status": 0,
"status_string": "invited"
}
],
"start_time": "2026-11-04T15:00:00Z",
"title": "Opening keynote",
"track": "2263000000011021"
}
],
"total_count": 1
}List speakers
List an event's speakers.
Inputs
- Event
event_idtextRequired - The event. Pick one, or enter an event id from 'List events' or 'Create an event'.
- Portal
portal_idtext - Optional. The Backstage portal to use. Leave blank for your default portal.
Outputs
countnumber- How many speakers are in this answer.
has_moretrue/false- Whether another page is available.
pagenumber- This page's number, when Zoho pages the list.
per_pagenumber- The page size, when Zoho pages the list.
speakerslist- The speakers.
total_countnumber- How many speakers there are in all, when Zoho says.
Example output
{
"count": 1,
"has_more": false,
"page": 1,
"per_page": 200,
"speakers": [
{
"company": "Acme",
"country": "US",
"designation": "CTO",
"email": "speaker@example.com",
"featured": false,
"first_name": "Sam",
"id": "2263000000013001",
"last_name": "Speaker",
"status": 0,
"status_string": "invited"
}
],
"total_count": 1
}List ticket classes
List an event's ticket classes, with prices and how many are sold.
Inputs
- Event
event_idtextRequired - The event. Pick one, or enter an event id from 'List events' or 'Create an event'.
- Page
pagenumber - Optional. Which page of results to return, starting at 1.At least 1.
- Page size
per_pagenumber - Optional. How many to return per page, 1 to 200. Zoho's default is 200.From 1 to 200.
- Portal
portal_idtext - Optional. The Backstage portal to use. Leave blank for your default portal.
Outputs
countnumber- How many ticket classes are in this answer.
has_moretrue/false- Whether another page is available.
pagenumber- This page's number, when Zoho pages the list.
per_pagenumber- The page size, when Zoho pages the list.
ticket_classeslist- The ticket classes.
total_countnumber- How many ticket classes there are in all, when Zoho says.
Example output
{
"count": 1,
"has_more": false,
"page": 1,
"per_page": 200,
"ticket_classes": [
{
"amount": 0,
"currency_code": "USD",
"id": "2263000000011031",
"name": "General admission",
"quantity": 100,
"sold": 1,
"status": 0,
"status_string": "active"
}
],
"total_count": 1
}List tracks
List the tracks of an event's agenda. A session belongs to one.
Inputs
- Event
event_idtextRequired - The event. Pick one, or enter an event id from 'List events' or 'Create an event'.
- Portal
portal_idtext - Optional. The Backstage portal to use. Leave blank for your default portal.
Outputs
countnumber- How many tracks are in this answer.
has_moretrue/false- Whether another page is available.
pagenumber- This page's number, when Zoho pages the list.
per_pagenumber- The page size, when Zoho pages the list.
total_countnumber- How many tracks there are in all, when Zoho says.
trackslist- The tracks.
Example output
{
"count": 1,
"has_more": false,
"page": 1,
"per_page": 200,
"total_count": 1,
"tracks": [
{
"index": 1,
"language": "en",
"name": "Main track",
"track_id": "2263000000011021"
}
]
}Update an event
Change an event's name, time zone, dates or details. Fields left blank keep their current values.
Inputs
- Event
event_idtextRequired - The event. Pick one, or enter an event id from 'List events' or 'Create an event'.
- Name
nametext - The event's name. Leave blank to keep the current one.
- Time zone
timezonetext - The event's time zone. Leave blank to keep the current one.One of:
Africa/Abidjan,Africa/Accra,Africa/Addis_Ababa,Africa/Algiers,Africa/Asmara,Africa/Asmera,Africa/Bamako,Africa/Bangui,Africa/Banjul,Africa/Bissau, and 544 more. - Starts
start_timedate and time - When the event starts. Leave blank to keep the current one.
- Ends
end_timedate and time - When the event ends. The Free plan allows one event day. Leave blank to keep the current one.
- Language
languagetext - Optional. The event's language code, such as en. Leave blank to keep the current one.
- Summary
summarytext - Optional. A short summary. Leave blank to keep the current one.
- Description
descriptiontext - Optional. The full description; HTML is allowed. Leave blank to keep the current one.
- Category
categorytext - Optional. The event's category, such as Sales. Leave blank to keep the current one.
- Portal
portal_idtext - Optional. The Backstage portal to use. Leave blank for your default portal.
Outputs
A Zoho Backstage event.
categorytext- The event's category.
created_byobject- A Backstage user.
created_timetext- When it was created.
descriptiontext- The event's description (HTML).
end_timetext- When it ends, in UTC.
event_typenumber- 2 venue, 3 online, 4 hybrid.
event_type_stringtext- The event type as text.
idtext- The event's id.
languagetext- The event's language code, e.g. en.
last_modified_byobject- A Backstage user.
last_modified_timetext- When it was last changed.
nametext- The event's name.
spaceobject- The event's space.
start_timetext- When it starts, in UTC, e.g. 2026-11-04T09:00:00Z.
statusnumber- 0 unpublished, 1 published, 2 running, 3 completed, 4 canceled.
status_stringtext- The status as text, e.g. unpublished.
summarytext- A short summary.
tagslist- The event's tags.
thumbnail_urltext- The event's thumbnail image.
timezonetext- The event's IANA time zone, e.g. America/New_York.
venueobject- Where the event takes place.
website_urltext- The event website's address.
Example output
{
"category": "Sales",
"created_by": {
"company": "Acme",
"designation": "Organizer",
"email": "owner@example.com",
"first_name": "Ola",
"id": "2263000000002003"
},
"created_time": "2026-10-01T09:00:00Z",
"description": "<p>Our yearly summit.</p>",
"end_time": "2026-11-04T22:00:00Z",
"event_type": 3,
"event_type_string": "online",
"id": "2263000000011005",
"language": "en",
"last_modified_by": {
"company": "Acme",
"designation": "Organizer",
"email": "owner@example.com",
"first_name": "Ola",
"id": "2263000000002003"
},
"last_modified_time": "2026-10-01T09:00:00Z",
"name": "Customer Summit",
"space": {
"id": "2263000000011001"
},
"start_time": "2026-11-04T14:00:00Z",
"status": 0,
"status_string": "unpublished",
"summary": "Our yearly summit.",
"tags": [],
"timezone": "America/New_York",
"website_url": "https://example.zohobackstage.com/CustomerSummit"
}