Skip to main content
POST
/
v1
/
events
/
{eventId}
/
sessions
Create a new session
curl --request POST \
  --url https://api.zuddl.com/v1/events/{eventId}/sessions \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "title": "Maximize Your Potential: Strategies for Success in a Digital World",
  "startDateTime": "2023-11-07T05:31:56Z",
  "endDateTime": "2023-11-07T05:31:56Z",
  "description": "<p>Join us for an engaging online session designed to equip you with practical tools and insights for thriving in today's fast-paced, technology-driven environment.</p>",
  "locationId": "d812a64f-8865-4289-9024-9a120792c3d8",
  "availableSpots": 100,
  "totalCapacity": 100,
  "externalRefId": "d812a64f8865428990249a120792c3d8",
  "parentSessionId": "d812a64f8865428990249a120792c3d8",
  "tags": [
    "tag1",
    "tag2"
  ]
}
EOF
{
  "kind": "<string>",
  "url": "<string>",
  "id": "d5e31ba5-2d1e-4918-bb60-dd1514b4b397",
  "title": "Maximize Your Potential: Strategies for Success in a Digital World",
  "description": "<p>Join us for an engaging online session designed to equip you with practical tools and insights for thriving in today's fast-paced, technology-driven environment.</p>",
  "startDateTime": "2025-03-14T05:55:00Z",
  "endDateTime": "2025-03-14T05:55:00Z",
  "location": [
    {
      "locationId": "d5e31ba5-2d1e-4918-bb60-dd1514b4b397",
      "locationName": "Session location",
      "link": "<string>"
    }
  ],
  "speakers": [
    {
      "speakerId": "d5e31ba5-2d1e-4918-bb60-dd1514b4b397",
      "url": "<string>"
    }
  ],
  "sponsors": [
    {
      "sponsorId": "d5e31ba5-2d1e-4918-bb60-dd1514b4b397",
      "url": "<string>"
    }
  ],
  "tags": [
    "tag1",
    "tag2"
  ],
  "files": [
    {
      "fileId": "d5e31ba5-2d1e-4918-bb60-dd1514b4b397",
      "fileName": "Presentation",
      "fileUrl": "https://phoenixlive.imgix.net/9807c938-413f-4a18-8f22-c3ac150f1e61"
    }
  ],
  "availableSpots": 100,
  "totalCapacity": 100,
  "remainingCapacity": 75,
  "externalRefId": "d812a64f8865428990249a120792c3d8",
  "parentSessionId": "d812a64f8865428990249a120792c3d8"
}

Authorizations

​
Authorization
string
header
required

Provide your API key secret in the Authorization header

Path Parameters

​
eventId
string
required

Unique identifier of the event

Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$

Body

application/json
​
title
string
required

Title of the session

Maximum string length: 500
Example:

"Maximize Your Potential: Strategies for Success in a Digital World"

​
startDateTime
string<date-time>
required

Start date time of the session

Minimum string length: 1
​
endDateTime
string<date-time>
required

End date time of the session.

Minimum string length: 1
​
description
string

Description of the session

Example:

"<p>Join us for an engaging online session designed to equip you with practical tools and insights for thriving in today's fast-paced, technology-driven environment.</p>"

​
locationId
string<uuid>

ID of the in-person location for the session

Example:

"d812a64f-8865-4289-9024-9a120792c3d8"

​
availableSpots
integer<int32>
deprecated

Deprecated: use totalCapacity instead. Available Spots for an In-person session.

Example:

100

​
totalCapacity
integer<int32>

Total capacity configured for the session. Applies to in-person and hybrid sessions; ignored for virtual sessions. Takes precedence over the deprecated availableSpots if both are provided.

Example:

100

​
externalRefId
string

A reference ID that you can use to map this session to your external systems or databases

Example:

"d812a64f8865428990249a120792c3d8"

​
parentSessionId
string

Parent session ID of the session

Example:

"d812a64f8865428990249a120792c3d8"

​
tags
string[]

Tags for the session

Tags for the session

Example:
["tag1", "tag2"]

Response

Session created successfully

​
kind
string
​
url
string<uri>
​
id
string<uuid>

Unique identifier of the session

Example:

"d5e31ba5-2d1e-4918-bb60-dd1514b4b397"

​
title
string

Name of the session

Example:

"Maximize Your Potential: Strategies for Success in a Digital World"

​
description
string

Description of the session

Example:

"<p>Join us for an engaging online session designed to equip you with practical tools and insights for thriving in today's fast-paced, technology-driven environment.</p>"

​
startDateTime
string<date-time>

Start date time of the session

Example:

"2025-03-14T05:55:00Z"

​
endDateTime
string<date-time>

End date time of the session

Example:

"2025-03-14T05:55:00Z"

​
location
object[]

Location details of the session

​
speakers
object[]

Speakers of the session

​
sponsors
object[]

Sponsors of the session

​
tags
string[]

Tags of the session

Tags of the session

Example:
["tag1", "tag2"]
​
files
object[]

Files of the session

​
availableSpots
integer<int32>
deprecated

Deprecated: use totalCapacity instead. Number of available spots for the session.

Example:

100

​
totalCapacity
integer<int32>

Total capacity configured for the session. Applies to in-person and hybrid sessions; null for virtual sessions.

Example:

100

​
remainingCapacity
integer<int32>

Number of spots still open for new registrations (totalCapacity minus already-registered users). Applies to in-person and hybrid sessions with a configured capacity; null otherwise.

Example:

75

​
externalRefId
string

A reference ID that you can use to map this session to your external systems or databases

Example:

"d812a64f8865428990249a120792c3d8"

​
parentSessionId
string

Parent session ID of the session

Example:

"d812a64f8865428990249a120792c3d8"