Create a track

The "Create a Track" API allows users to create a new track within a specific event in their Zoho Backstage portal. Tracks are used to categorize and organize sessions inside an agenda. They help structure event schedules by grouping sessions under specific themes, topics, industries, skill levels, or audience segments.

To successfully create a track, you must provide the portal_id and event_id in the path parameters and include the required request payload.

Header

Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

OAuth Scope

zohobackstage.agenda.CREATE

Path Parameters

• portal_id (Long Integer)
  The unique identifier of the portal under which the event exists. This ensures that the track is created within the correct Zoho Backstage portal environment. For example, "portal_id": "19593237" specifies the portal with ID 19593237.

• event_id (Long Integer)
  The unique identifier of the event in which the track will be created. Tracks are always associated with a specific event. For example, "event_id": "2000000116588" specifies the event with ID 2000000116588.

Response Structure and Field Explanations

• track_id (Long Integer)
  The unique system-generated identifier assigned to the newly created track. This identifier uniquely represents the track within the specified event and is required for performing further operations such as updating, deleting, or associating sessions with the track. For example, "track_id": "20000000222001" represents the unique identifier of the created track.

• index (Integer)
  The position index of the track within the event’s track list. This value determines the display order of tracks when multiple tracks exist. The index typically starts from 0 and increases sequentially based on the organizer’s configuration. For example, "index": 4 indicates that the track is positioned at index 4 in the track list.

• language (String)
  The language code associated with the track. This value represents the language in which the track name and related configurations are defined. It typically follows a two-character ISO language code format. For example, "language": "en" indicates that the track is configured in English.

• name (String)
  The display name assigned to the track by the event organizer. This name is used in the event’s agenda structure and may be displayed on the event website or mobile application to help attendees identify sessions grouped under this track. For example, "name": "Track 5" represents the title assigned to the track.