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"
]
}
EOFimport requests
url = "https://api.zuddl.com/v1/events/{eventId}/sessions"
payload = {
"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"]
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
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']
})
};
fetch('https://api.zuddl.com/v1/events/{eventId}/sessions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.zuddl.com/v1/events/{eventId}/sessions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'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'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.zuddl.com/v1/events/{eventId}/sessions"
payload := strings.NewReader("{\n \"title\": \"Maximize Your Potential: Strategies for Success in a Digital World\",\n \"startDateTime\": \"2023-11-07T05:31:56Z\",\n \"endDateTime\": \"2023-11-07T05:31:56Z\",\n \"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>\",\n \"locationId\": \"d812a64f-8865-4289-9024-9a120792c3d8\",\n \"availableSpots\": 100,\n \"totalCapacity\": 100,\n \"externalRefId\": \"d812a64f8865428990249a120792c3d8\",\n \"parentSessionId\": \"d812a64f8865428990249a120792c3d8\",\n \"tags\": [\n \"tag1\",\n \"tag2\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.zuddl.com/v1/events/{eventId}/sessions")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"title\": \"Maximize Your Potential: Strategies for Success in a Digital World\",\n \"startDateTime\": \"2023-11-07T05:31:56Z\",\n \"endDateTime\": \"2023-11-07T05:31:56Z\",\n \"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>\",\n \"locationId\": \"d812a64f-8865-4289-9024-9a120792c3d8\",\n \"availableSpots\": 100,\n \"totalCapacity\": 100,\n \"externalRefId\": \"d812a64f8865428990249a120792c3d8\",\n \"parentSessionId\": \"d812a64f8865428990249a120792c3d8\",\n \"tags\": [\n \"tag1\",\n \"tag2\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.zuddl.com/v1/events/{eventId}/sessions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"title\": \"Maximize Your Potential: Strategies for Success in a Digital World\",\n \"startDateTime\": \"2023-11-07T05:31:56Z\",\n \"endDateTime\": \"2023-11-07T05:31:56Z\",\n \"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>\",\n \"locationId\": \"d812a64f-8865-4289-9024-9a120792c3d8\",\n \"availableSpots\": 100,\n \"totalCapacity\": 100,\n \"externalRefId\": \"d812a64f8865428990249a120792c3d8\",\n \"parentSessionId\": \"d812a64f8865428990249a120792c3d8\",\n \"tags\": [\n \"tag1\",\n \"tag2\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"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",
"type": "STAGE",
"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"
}{
"timestamp": "2023-11-07T05:31:56Z",
"message": "<string>",
"description": "<string>",
"code": "<string>",
"params": {},
"errors": {}
}{
"timestamp": "2023-11-07T05:31:56Z",
"message": "<string>",
"description": "<string>",
"code": "<string>",
"params": {},
"errors": {}
}{
"timestamp": "2023-11-07T05:31:56Z",
"message": "<string>",
"description": "<string>",
"code": "<string>",
"params": {},
"errors": {}
}Sessions
Create a new session
Use this endpoint to create a new session for a specific event type in your Zuddl organization.
Required API key scopes: WRITE
This API can only be called with an access key that was generated for Backend usage.
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"
]
}
EOFimport requests
url = "https://api.zuddl.com/v1/events/{eventId}/sessions"
payload = {
"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"]
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
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']
})
};
fetch('https://api.zuddl.com/v1/events/{eventId}/sessions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.zuddl.com/v1/events/{eventId}/sessions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'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'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.zuddl.com/v1/events/{eventId}/sessions"
payload := strings.NewReader("{\n \"title\": \"Maximize Your Potential: Strategies for Success in a Digital World\",\n \"startDateTime\": \"2023-11-07T05:31:56Z\",\n \"endDateTime\": \"2023-11-07T05:31:56Z\",\n \"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>\",\n \"locationId\": \"d812a64f-8865-4289-9024-9a120792c3d8\",\n \"availableSpots\": 100,\n \"totalCapacity\": 100,\n \"externalRefId\": \"d812a64f8865428990249a120792c3d8\",\n \"parentSessionId\": \"d812a64f8865428990249a120792c3d8\",\n \"tags\": [\n \"tag1\",\n \"tag2\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.zuddl.com/v1/events/{eventId}/sessions")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"title\": \"Maximize Your Potential: Strategies for Success in a Digital World\",\n \"startDateTime\": \"2023-11-07T05:31:56Z\",\n \"endDateTime\": \"2023-11-07T05:31:56Z\",\n \"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>\",\n \"locationId\": \"d812a64f-8865-4289-9024-9a120792c3d8\",\n \"availableSpots\": 100,\n \"totalCapacity\": 100,\n \"externalRefId\": \"d812a64f8865428990249a120792c3d8\",\n \"parentSessionId\": \"d812a64f8865428990249a120792c3d8\",\n \"tags\": [\n \"tag1\",\n \"tag2\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.zuddl.com/v1/events/{eventId}/sessions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"title\": \"Maximize Your Potential: Strategies for Success in a Digital World\",\n \"startDateTime\": \"2023-11-07T05:31:56Z\",\n \"endDateTime\": \"2023-11-07T05:31:56Z\",\n \"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>\",\n \"locationId\": \"d812a64f-8865-4289-9024-9a120792c3d8\",\n \"availableSpots\": 100,\n \"totalCapacity\": 100,\n \"externalRefId\": \"d812a64f8865428990249a120792c3d8\",\n \"parentSessionId\": \"d812a64f8865428990249a120792c3d8\",\n \"tags\": [\n \"tag1\",\n \"tag2\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"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",
"type": "STAGE",
"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"
}{
"timestamp": "2023-11-07T05:31:56Z",
"message": "<string>",
"description": "<string>",
"code": "<string>",
"params": {},
"errors": {}
}{
"timestamp": "2023-11-07T05:31:56Z",
"message": "<string>",
"description": "<string>",
"code": "<string>",
"params": {},
"errors": {}
}{
"timestamp": "2023-11-07T05:31:56Z",
"message": "<string>",
"description": "<string>",
"code": "<string>",
"params": {},
"errors": {}
}Authorizations
Provide your API key secret in the Authorization header
Path Parameters
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 of the session
Maximum string length:
500Example:
"Maximize Your Potential: Strategies for Success in a Digital World"
Start date time of the session
Minimum string length:
1End date time of the session.
Minimum string length:
1Description 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>"
ID of the in-person location for the session
Example:
"d812a64f-8865-4289-9024-9a120792c3d8"
Deprecated: use totalCapacity instead. Available Spots for an In-person session.
Example:
100
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
A reference ID that you can use to map this session to your external systems or databases
Example:
"d812a64f8865428990249a120792c3d8"
Parent session ID of the session
Example:
"d812a64f8865428990249a120792c3d8"
Tags for the session
Tags for the session
Example:
["tag1", "tag2"]
Response
Session created successfully
Unique identifier of the session
Example:
"d5e31ba5-2d1e-4918-bb60-dd1514b4b397"
Name of the session
Example:
"Maximize Your Potential: Strategies for Success in a Digital World"
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>"
Start date time of the session
Example:
"2025-03-14T05:55:00Z"
End date time of the session
Example:
"2025-03-14T05:55:00Z"
Location details of the session
Show child attributes
Show child attributes
Speakers of the session
Show child attributes
Show child attributes
Sponsors of the session
Show child attributes
Show child attributes
Tags of the session
Tags of the session
Example:
["tag1", "tag2"]
Files of the session
Show child attributes
Show child attributes
Deprecated: use totalCapacity instead. Number of available spots for the session.
Example:
100
Total capacity configured for the session. Applies to in-person and hybrid sessions; null for virtual sessions.
Example:
100
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
A reference ID that you can use to map this session to your external systems or databases
Example:
"d812a64f8865428990249a120792c3d8"
Parent session ID of the session
Example:
"d812a64f8865428990249a120792c3d8"
Was this page helpful?
⌘I