Create Session

post

https://api.swoogo.com/api/v1/sessions/create

Creates a new session within an event. Returns the full session record on success.

Required fields: event_id, name, and date. Optionally set start_time, end_time, capacity, location_id, track_id, timezone, and description. If timezone is not provided, the session inherits the event's timezone.

Sessions are created with session_status=live by default. Use selection_control to set whether the session is optional or automatically included in registrations.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Form Data

integer

Unique identifier for the session.

event_id

integer

required

ID of the event associated with this session.

name

string

required

Title or name of the session.

admin_short_name

string

Admin-specific short name for internal usage.

badge_name

string

Display name on attendee badges.

description

string

Detailed description of the session.

date

The date when the session will take place.

start_time

string

Start time of the session.

end_time

string

End time of the session.

use_event_timezone

integer

Whether the event's default timezone is applied to the session.

timezone

string

Timezone for the session. For a list of TZ check TZ Identifier column in this page.

capacity

integer

Maximum number of attendees allowed.

location_id

integer

Identifier for the location.

track_id

integer

Identifier for the session's track.

webinar_url

uri

URL for the webinar if the session is virtual.

sold_out_message

string

Custom message displayed when the session is sold out.

secure_id

string

Secure identifier for the session.

session_status

string

enum

Current status of the session.

Allowed:

locked_when_saved

integer

enum

Whether the session is locked after being saved.

Allowed:

selection_control

string

enum

Specifies whether the session is optional or included by default, setting the value 'session_included'.

Allowed:

selected_by_default

integer

enum

Indicates if the session is selected by default for attendees.

Allowed:

prevent_session_conflicts

integer

enum

Whether when selecting this session should prevent conflicts with other sessions.

Allowed:

custom_fields

object

Custom fields associated with the session.

Responses

201Create Object

401Authentication failed. The bearer token is missing, expired, or invalid. Obtain a new token via POST /oauth2/token.

403The authenticated user does not have permission to access this resource. This can occur if the resource belongs to a different account or the API credentials lack the required scope.

404The specified resource does not exist or has been deleted. Verify the ID is correct and that the resource belongs to an event your credentials have access to.

500An unexpected server error occurred. If this persists, contact Swoogo support with the request details and timestamp.