# Zoho Backstage

> Event management. Create and update events, add speakers and sessions, register attendees, and read orders, tickets and attendees.

App · Events · 20 actions. Web page: https://docs.lodol.com/docs/integrations/zoho-backstage

## Actions

### Add a speaker

Add a speaker to an event. They start as invited. The Free plan allows 3 speakers per event.

**Inputs**

- Event (`event_id`, text, required): The event. Pick one, or enter an event id from 'List events' or 'Create an event'.
- Email (`email`, text, required): The speaker's email address.
- First name (`first_name`, text, required): The speaker's first name.
- Last name (`last_name`, text): Optional.
- Company (`company`, text): Optional.
- Job title (`designation`, text): Optional.
- Biography (`description`, text): Optional. A short biography.
- Country (`country`, text): Optional. A two-letter country code, such as US.
- Phone (`telephone`, text): Optional.
- Skills (`skills`, list): Optional. The speaker's skills, such as Sales, Marketing.
- Featured (`featured`, true/false): Optional. Feature the speaker on the event site.
- LinkedIn (`linkedin`, text): Optional. Their LinkedIn profile address.
- X (Twitter) (`twitter`, text): Optional. Their X (Twitter) profile address.
- Facebook (`facebook`, text): Optional. Their Facebook profile address.
- Instagram (`instagram`, text): Optional. Their Instagram profile address.
- Portal (`portal_id`, text): Optional. The Backstage portal to use. Leave blank for your default portal.

**Outputs**: A speaker at the event.

- `added_on` (text): When they were added.
- `alternate_telephone` (text): Another phone number.
- `company` (text): Their company.
- `country` (text): Their two-letter country code.
- `description` (text): Their biography.
- `designation` (text): Their job title.
- `email` (text): Their email address.
- `facebook` (text): Their Facebook profile.
- `featured` (true/false): Whether they are featured.
- `first_name` (text): Their first name.
- `id` (text): The speaker's id.
- `instagram` (text): Their Instagram profile.
- `joined_on` (text): When they joined.
- `last_name` (text): Their last name.
- `linkedin` (text): Their LinkedIn profile.
- `medium` (text): Their Medium profile.
- `skills` (text): Their skills, comma-separated.
- `status` (number): 0 invited, 1 joined.
- `status_string` (text): The status as text.
- `telegram` (text): Their Telegram profile.
- `telephone` (text): Their phone number.
- `twitter` (text): Their X (Twitter) profile.

**Example output**

```json
{
  "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_id`, text, required): The event. Pick one, or enter an event id from 'List events' or 'Create an event'.
- Title (`title`, text, required): The session's title.
- Track (`track_id`, text, required): The track it belongs to, from 'List tracks'.
- Starts (`start_time`, date and time, required): When it starts. It must fall within the event.
- Duration (minutes) (`duration`, number): Optional. How long it lasts, in minutes. From 1 to 1440.
- Session type (`session_type`, text): Optional. Such as KEYNOTE, PRESENTATION or BREAK. Defaults to KEYNOTE. Default: `KEYNOTE`.
- Day (`day`, number): Optional. Which day of the event, counting from 1. At least 1. Default: `1`.
- Speakers (`speaker_emails`, list): Optional. The email addresses of the event's speakers who present it.
- Featured (`featured`, true/false): Optional. Feature the session.
- Hidden (`hidden`, true/false): Optional. Hide it from attendees.
- Time to be announced (`time_to_be_announced`, true/false): Optional. Show the time as to be announced.
- Venue to be announced (`venue_to_be_announced`, true/false): Optional. Show the venue as to be announced.
- Portal (`portal_id`, text): Optional. The Backstage portal to use. Leave blank for your default portal.

**Outputs**: A session on the event's agenda.

- `agenda` (text): The agenda it belongs to.
- `created_by` (object): A Backstage user.
- `created_time` (text): When it was created.
- `description` (text): Its description.
- `duration` (number): How long it lasts, in minutes.
- `featured` (true/false): Whether it is featured.
- `hidden` (true/false): Whether it is hidden from attendees.
- `id` (text): The session's id.
- `language` (text): Its language code.
- `last_modified_by` (object): A Backstage user.
- `last_modified_time` (text): When it was last changed.
- `session_type` (text): Its type, e.g. KEYNOTE.
- `speaker_to_be_announced` (true/false): Whether its speaker is still to be announced.
- `speakers` (list): Its speakers.
- `start_time` (text): When it starts, in UTC.
- `title` (text): The session's title.
- `track` (text): The id of its track.
- `venue` (text): The hall it takes place in.
- `venue_to_be_announced` (true/false): Whether its venue is still to be announced.

**Example output**

```json
{
  "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 (`name`, text, required): The event's name.
- Time zone (`timezone`, text, required): 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_time`, date and time, required): When the event starts.
- Ends (`end_time`, date and time, required): When the event ends. The Free plan allows one event day.
- Event type (`event_type`, text): Optional. In person, online or hybrid. One of: `venue` (In person (venue)), `online`, `hybrid`.
- Language (`language`, text): Optional. The event's language code, such as en.
- Summary (`summary`, text): Optional. A short summary.
- Description (`description`, text): Optional. The full description; HTML is allowed.
- Category (`category`, text): Optional. The event's category, such as Sales.
- Portal (`portal_id`, text): Optional. The Backstage portal to use. Leave blank for your default portal.

**Outputs**: A Zoho Backstage event.

- `category` (text): The event's category.
- `created_by` (object): A Backstage user.
- `created_time` (text): When it was created.
- `description` (text): The event's description (HTML).
- `end_time` (text): When it ends, in UTC.
- `event_type` (number): 2 venue, 3 online, 4 hybrid.
- `event_type_string` (text): The event type as text.
- `id` (text): The event's id.
- `language` (text): The event's language code, e.g. en.
- `last_modified_by` (object): A Backstage user.
- `last_modified_time` (text): When it was last changed.
- `name` (text): The event's name.
- `space` (object): The event's space.
- `start_time` (text): When it starts, in UTC, e.g. 2026-11-04T09:00:00Z.
- `status` (number): 0 unpublished, 1 published, 2 running, 3 completed, 4 canceled.
- `status_string` (text): The status as text, e.g. unpublished.
- `summary` (text): A short summary.
- `tags` (list): The event's tags.
- `thumbnail_url` (text): The event's thumbnail image.
- `timezone` (text): The event's IANA time zone, e.g. America/New_York.
- `venue` (object): Where the event takes place.
- `website_url` (text): The event website's address.

**Example output**

```json
{
  "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_id`, text, required): The event. Pick one, or enter an event id from 'List events' or 'Create an event'.
- Ticket class (`ticket_class_id`, text, required): The ticket class, from 'List ticket classes'.
- Purchaser first name (`purchaser_first_name`, text, required): The buyer's first name.
- Purchaser last name (`purchaser_last_name`, text): Optional.
- Purchaser email (`purchaser_email`, text, required): The buyer's email address.
- Purchaser company (`purchaser_company`, text): Optional.
- Purchaser mobile (`purchaser_mobile_no`, text): Optional.
- Attendee first name (`attendee_first_name`, text): Optional. Defaults to the purchaser's.
- Attendee last name (`attendee_last_name`, text): Optional. Defaults to the purchaser's.
- Attendee email (`attendee_email`, text): Optional. Defaults to the purchaser's.
- Billing address line 1 (`billing_address_line_1`, text): Optional. The billing address is sent only when given.
- Billing address line 2 (`billing_address_line_2`, text): Optional.
- Billing city (`billing_city`, text): Optional.
- Billing state (`billing_state`, text): Optional.
- Billing country (`billing_country`, text): Optional.
- Billing postal code (`billing_zip_code`, text): Optional.
- Portal (`portal_id`, text): Optional. The Backstage portal to use. Leave blank for your default portal.

**Outputs**: An order for tickets.

- `billing_address` (object): The billing address.
- `contact` (object): The purchaser.
- `cost` (object): What the order costs.
- `created_time` (text): When it was placed.
- `id` (text): The order's id.
- `last_modified_time` (text): When it was last changed.
- `order_by` (text): The purchaser's email address.
- `origin_string` (text): The order's origin as text.
- `payment_option_name` (text): The payment option's name.
- `payment_status` (number): 1 paid, 2 unpaid.
- `payment_status_string` (text): The payment status as text.
- `payment_type` (number): How it was paid for.
- `payment_type_string` (text): The payment type as text.
- `source` (number): Where the order came from.
- `source_string` (text): The source as text, e.g. api.
- `status` (number): 0 placed, 1 cancelled, 3 paid to the organizer.
- `status_string` (text): The status as text.
- `tickets` (list): The order's tickets.

**Example output**

```json
{
  "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_id`, text, required): The event. Pick one, or enter an event id from 'List events' or 'Create an event'.
- Portal (`portal_id`, text): Optional. The Backstage portal to use. Leave blank for your default portal.

**Outputs**: The outcome of deleting an event.

- `deleted` (true/false): Always true: a refusal raises an error instead.
- `event_id` (text): The deleted event's id.
- `message` (text): Zoho's confirmation, without its HTML.

**Example output**

```json
{
  "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_id`, text, required): The event. Pick one, or enter an event id from 'List events' or 'Create an event'.
- Session ID (`session_id`, text, required): The session's id, from 'List sessions' or 'Create a session'.
- Portal (`portal_id`, text): Optional. The Backstage portal to use. Leave blank for your default portal.

**Outputs**: A session on the event's agenda.

- `agenda` (text): The agenda it belongs to.
- `created_by` (object): A Backstage user.
- `created_time` (text): When it was created.
- `description` (text): Its description.
- `duration` (number): How long it lasts, in minutes.
- `featured` (true/false): Whether it is featured.
- `hidden` (true/false): Whether it is hidden from attendees.
- `id` (text): The session's id.
- `language` (text): Its language code.
- `last_modified_by` (object): A Backstage user.
- `last_modified_time` (text): When it was last changed.
- `session_type` (text): Its type, e.g. KEYNOTE.
- `speaker_to_be_announced` (true/false): Whether its speaker is still to be announced.
- `speakers` (list): Its speakers.
- `start_time` (text): When it starts, in UTC.
- `title` (text): The session's title.
- `track` (text): The id of its track.
- `venue` (text): The hall it takes place in.
- `venue_to_be_announced` (true/false): Whether its venue is still to be announced.

**Example output**

```json
{
  "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_id`, text, required): The event. Pick one, or enter an event id from 'List events' or 'Create an event'.
- Speaker ID (`speaker_id`, text, required): The speaker's id, from 'List speakers' or 'Add a speaker'.
- Portal (`portal_id`, text): Optional. The Backstage portal to use. Leave blank for your default portal.

**Outputs**: A speaker at the event.

- `added_on` (text): When they were added.
- `alternate_telephone` (text): Another phone number.
- `company` (text): Their company.
- `country` (text): Their two-letter country code.
- `description` (text): Their biography.
- `designation` (text): Their job title.
- `email` (text): Their email address.
- `facebook` (text): Their Facebook profile.
- `featured` (true/false): Whether they are featured.
- `first_name` (text): Their first name.
- `id` (text): The speaker's id.
- `instagram` (text): Their Instagram profile.
- `joined_on` (text): When they joined.
- `last_name` (text): Their last name.
- `linkedin` (text): Their LinkedIn profile.
- `medium` (text): Their Medium profile.
- `skills` (text): Their skills, comma-separated.
- `status` (number): 0 invited, 1 joined.
- `status_string` (text): The status as text.
- `telegram` (text): Their Telegram profile.
- `telephone` (text): Their phone number.
- `twitter` (text): Their X (Twitter) profile.

**Example output**

```json
{
  "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_id`, text, required): The event. Pick one, or enter an event id from 'List events' or 'Create an event'.
- Attendee ID (`attendee_id`, text, required): The attendee's id, from 'List attendees'.
- Portal (`portal_id`, text): Optional. The Backstage portal to use. Leave blank for your default portal.

**Outputs**: An attendee of the event.

- `affiliate_name` (text): The affiliate the ticket came through.
- `contact` (object): The attendee's details.
- `created_time` (text): When it was created.
- `event_id` (text): The event's id.
- `id` (text): The attendee's id.
- `last_modified_time` (text): When it was last changed.
- `order_id` (text): The id of the order that bought the ticket.
- `portal` (text): The portal's id.
- `promo_code` (text): The promo code used.
- `purchased_by` (text): Who bought the ticket.
- `status` (number): 0 not attending, 1 attending.
- `status_string` (text): The status as text.
- `ticket_class_id` (text): The ticket class's id.
- `ticket_id` (text): The ticket's id.
- `ticket_name` (text): The ticket class's name.

**Example output**

```json
{
  "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_id`, text, required): The event. Pick one, or enter an event id from 'List events' or 'Create an event'.
- Portal (`portal_id`, text): Optional. The Backstage portal to use. Leave blank for your default portal.

**Outputs**: A Zoho Backstage event.

- `category` (text): The event's category.
- `created_by` (object): A Backstage user.
- `created_time` (text): When it was created.
- `description` (text): The event's description (HTML).
- `end_time` (text): When it ends, in UTC.
- `event_type` (number): 2 venue, 3 online, 4 hybrid.
- `event_type_string` (text): The event type as text.
- `id` (text): The event's id.
- `language` (text): The event's language code, e.g. en.
- `last_modified_by` (object): A Backstage user.
- `last_modified_time` (text): When it was last changed.
- `name` (text): The event's name.
- `space` (object): The event's space.
- `start_time` (text): When it starts, in UTC, e.g. 2026-11-04T09:00:00Z.
- `status` (number): 0 unpublished, 1 published, 2 running, 3 completed, 4 canceled.
- `status_string` (text): The status as text, e.g. unpublished.
- `summary` (text): A short summary.
- `tags` (list): The event's tags.
- `thumbnail_url` (text): The event's thumbnail image.
- `timezone` (text): The event's IANA time zone, e.g. America/New_York.
- `venue` (object): Where the event takes place.
- `website_url` (text): The event website's address.

**Example output**

```json
{
  "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_id`, text, required): The event. Pick one, or enter an event id from 'List events' or 'Create an event'.
- Order ID (`order_id`, text, required): The order's id, from 'List orders' or 'Create an order'.
- Portal (`portal_id`, text): Optional. The Backstage portal to use. Leave blank for your default portal.

**Outputs**: An order for tickets.

- `billing_address` (object): The billing address.
- `contact` (object): The purchaser.
- `cost` (object): What the order costs.
- `created_time` (text): When it was placed.
- `id` (text): The order's id.
- `last_modified_time` (text): When it was last changed.
- `order_by` (text): The purchaser's email address.
- `origin_string` (text): The order's origin as text.
- `payment_option_name` (text): The payment option's name.
- `payment_status` (number): 1 paid, 2 unpaid.
- `payment_status_string` (text): The payment status as text.
- `payment_type` (number): How it was paid for.
- `payment_type_string` (text): The payment type as text.
- `source` (number): Where the order came from.
- `source_string` (text): The source as text, e.g. api.
- `status` (number): 0 placed, 1 cancelled, 3 paid to the organizer.
- `status_string` (text): The status as text.
- `tickets` (list): The order's tickets.

**Example output**

```json
{
  "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_id`, text, required): The event. Pick one, or enter an event id from 'List events' or 'Create an event'.
- Ticket ID (`ticket_id`, text): Optional. Only the attendee holding this ticket.
- Page (`page`, number): Optional. Which page of results to return, starting at 1. At least 1.
- Page size (`per_page`, number): Optional. How many to return per page, 1 to 200. Zoho's default is 200. From 1 to 200.
- Portal (`portal_id`, text): Optional. The Backstage portal to use. Leave blank for your default portal.

**Outputs**

- `attendees` (list): The attendees.
- `count` (number): How many attendees are in this answer.
- `has_more` (true/false): Whether another page is available.
- `page` (number): This page's number, when Zoho pages the list.
- `per_page` (number): The page size, when Zoho pages the list.
- `total_count` (number): How many attendees there are in all, when Zoho says.

**Example output**

```json
{
  "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_id`, text, required): The event. Pick one, or enter an event id from 'List events' or 'Create an event'.
- Portal (`portal_id`, text): Optional. The Backstage portal to use. Leave blank for your default portal.

**Outputs**

- `count` (number): How many event members are in this answer.
- `has_more` (true/false): Whether another page is available.
- `members` (list): The event members.
- `page` (number): This page's number, when Zoho pages the list.
- `per_page` (number): The page size, when Zoho pages the list.
- `total_count` (number): How many event members there are in all, when Zoho says.

**Example output**

```json
{
  "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 (`status`, text): Optional. Only events in this state. One of: `all`, `running`, `live` (Live (published)), `drafts`, `completed`, `canceled`, `trash`.
- Sort by (`sort_by`, text): Optional. Which date to sort by. One of: `start_date` (Start date), `created_time` (Created time), `last_modified_time` (Last modified time).
- Order (`sort_order`, text): Optional. Ascending or descending. One of: `asc` (Oldest first), `desc` (Newest first).
- Page (`page`, number): Optional. Which page of results to return, starting at 1. At least 1.
- Page size (`per_page`, number): Optional. How many to return per page, 1 to 200. Zoho's default is 200. From 1 to 200.
- Portal (`portal_id`, text): Optional. The Backstage portal to use. Leave blank for your default portal.

**Outputs**

- `count` (number): How many events are in this answer.
- `events` (list): The events.
- `has_more` (true/false): Whether another page is available.
- `page` (number): This page's number, when Zoho pages the list.
- `per_page` (number): The page size, when Zoho pages the list.
- `total_count` (number): How many events there are in all, when Zoho says.

**Example output**

```json
{
  "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_id`, text, required): The event. Pick one, or enter an event id from 'List events' or 'Create an event'.
- Status (`status`, text): Optional. Only placed or only cancelled orders. One of: `all`, `placed`, `cancelled`.
- Order (`sort_order`, text): Optional. Ascending or descending. One of: `asc` (Oldest first), `desc` (Newest first).
- Page (`page`, number): Optional. Which page of results to return, starting at 1. At least 1.
- Page size (`per_page`, number): Optional. How many to return per page, 1 to 200. Zoho's default is 200. From 1 to 200.
- Portal (`portal_id`, text): Optional. The Backstage portal to use. Leave blank for your default portal.

**Outputs**

- `count` (number): How many orders are in this answer.
- `has_more` (true/false): Whether another page is available.
- `orders` (list): The orders.
- `page` (number): This page's number, when Zoho pages the list.
- `per_page` (number): The page size, when Zoho pages the list.
- `total_count` (number): How many orders there are in all, when Zoho says.

**Example output**

```json
{
  "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**

- `count` (number): How many portals are in this answer.
- `has_more` (true/false): Whether another page is available.
- `page` (number): This page's number, when Zoho pages the list.
- `per_page` (number): The page size, when Zoho pages the list.
- `portals` (list): The portals.
- `total_count` (number): How many portals there are in all, when Zoho says.

**Example output**

```json
{
  "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_id`, text, required): The event. Pick one, or enter an event id from 'List events' or 'Create an event'.
- Day (`day`, number): Optional. Only this day of the event, counting from 1. At least 1.
- Portal (`portal_id`, text): Optional. The Backstage portal to use. Leave blank for your default portal.

**Outputs**

- `count` (number): How many sessions are in this answer.
- `has_more` (true/false): Whether another page is available.
- `page` (number): This page's number, when Zoho pages the list.
- `per_page` (number): The page size, when Zoho pages the list.
- `sessions` (list): The sessions.
- `total_count` (number): How many sessions there are in all, when Zoho says.

**Example output**

```json
{
  "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_id`, text, required): The event. Pick one, or enter an event id from 'List events' or 'Create an event'.
- Portal (`portal_id`, text): Optional. The Backstage portal to use. Leave blank for your default portal.

**Outputs**

- `count` (number): How many speakers are in this answer.
- `has_more` (true/false): Whether another page is available.
- `page` (number): This page's number, when Zoho pages the list.
- `per_page` (number): The page size, when Zoho pages the list.
- `speakers` (list): The speakers.
- `total_count` (number): How many speakers there are in all, when Zoho says.

**Example output**

```json
{
  "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_id`, text, required): The event. Pick one, or enter an event id from 'List events' or 'Create an event'.
- Page (`page`, number): Optional. Which page of results to return, starting at 1. At least 1.
- Page size (`per_page`, number): Optional. How many to return per page, 1 to 200. Zoho's default is 200. From 1 to 200.
- Portal (`portal_id`, text): Optional. The Backstage portal to use. Leave blank for your default portal.

**Outputs**

- `count` (number): How many ticket classes are in this answer.
- `has_more` (true/false): Whether another page is available.
- `page` (number): This page's number, when Zoho pages the list.
- `per_page` (number): The page size, when Zoho pages the list.
- `ticket_classes` (list): The ticket classes.
- `total_count` (number): How many ticket classes there are in all, when Zoho says.

**Example output**

```json
{
  "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_id`, text, required): The event. Pick one, or enter an event id from 'List events' or 'Create an event'.
- Portal (`portal_id`, text): Optional. The Backstage portal to use. Leave blank for your default portal.

**Outputs**

- `count` (number): How many tracks are in this answer.
- `has_more` (true/false): Whether another page is available.
- `page` (number): This page's number, when Zoho pages the list.
- `per_page` (number): The page size, when Zoho pages the list.
- `total_count` (number): How many tracks there are in all, when Zoho says.
- `tracks` (list): The tracks.

**Example output**

```json
{
  "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_id`, text, required): The event. Pick one, or enter an event id from 'List events' or 'Create an event'.
- Name (`name`, text): The event's name. Leave blank to keep the current one.
- Time zone (`timezone`, text): 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_time`, date and time): When the event starts. Leave blank to keep the current one.
- Ends (`end_time`, date and time): When the event ends. The Free plan allows one event day. Leave blank to keep the current one.
- Language (`language`, text): Optional. The event's language code, such as en. Leave blank to keep the current one.
- Summary (`summary`, text): Optional. A short summary. Leave blank to keep the current one.
- Description (`description`, text): Optional. The full description; HTML is allowed. Leave blank to keep the current one.
- Category (`category`, text): Optional. The event's category, such as Sales. Leave blank to keep the current one.
- Portal (`portal_id`, text): Optional. The Backstage portal to use. Leave blank for your default portal.

**Outputs**: A Zoho Backstage event.

- `category` (text): The event's category.
- `created_by` (object): A Backstage user.
- `created_time` (text): When it was created.
- `description` (text): The event's description (HTML).
- `end_time` (text): When it ends, in UTC.
- `event_type` (number): 2 venue, 3 online, 4 hybrid.
- `event_type_string` (text): The event type as text.
- `id` (text): The event's id.
- `language` (text): The event's language code, e.g. en.
- `last_modified_by` (object): A Backstage user.
- `last_modified_time` (text): When it was last changed.
- `name` (text): The event's name.
- `space` (object): The event's space.
- `start_time` (text): When it starts, in UTC, e.g. 2026-11-04T09:00:00Z.
- `status` (number): 0 unpublished, 1 published, 2 running, 3 completed, 4 canceled.
- `status_string` (text): The status as text, e.g. unpublished.
- `summary` (text): A short summary.
- `tags` (list): The event's tags.
- `thumbnail_url` (text): The event's thumbnail image.
- `timezone` (text): The event's IANA time zone, e.g. America/New_York.
- `venue` (object): Where the event takes place.
- `website_url` (text): The event website's address.

**Example output**

```json
{
  "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"
}
```