Create Event
curl --request POST \
--url https://setup.zuddl.com/api/mcp/tools/v1_create_event \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"request": {
"description": "<string>",
"endDateTime": "2023-11-07T05:31:56Z",
"startDateTime": "2023-11-07T05:31:56Z",
"teamId": "<string>",
"title": "<string>",
"tz": "<string>",
"brandKitId": "<string>",
"languageCodes": [
"<string>"
],
"salesforceCampaignId": "<string>",
"tagNames": [
"<string>"
]
}
}
'import requests
url = "https://setup.zuddl.com/api/mcp/tools/v1_create_event"
payload = { "request": {
"description": "<string>",
"endDateTime": "2023-11-07T05:31:56Z",
"startDateTime": "2023-11-07T05:31:56Z",
"teamId": "<string>",
"title": "<string>",
"tz": "<string>",
"brandKitId": "<string>",
"languageCodes": ["<string>"],
"salesforceCampaignId": "<string>",
"tagNames": ["<string>"]
} }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
request: {
description: '<string>',
endDateTime: '2023-11-07T05:31:56Z',
startDateTime: '2023-11-07T05:31:56Z',
teamId: '<string>',
title: '<string>',
tz: '<string>',
brandKitId: '<string>',
languageCodes: ['<string>'],
salesforceCampaignId: '<string>',
tagNames: ['<string>']
}
})
};
fetch('https://setup.zuddl.com/api/mcp/tools/v1_create_event', 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://setup.zuddl.com/api/mcp/tools/v1_create_event",
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([
'request' => [
'description' => '<string>',
'endDateTime' => '2023-11-07T05:31:56Z',
'startDateTime' => '2023-11-07T05:31:56Z',
'teamId' => '<string>',
'title' => '<string>',
'tz' => '<string>',
'brandKitId' => '<string>',
'languageCodes' => [
'<string>'
],
'salesforceCampaignId' => '<string>',
'tagNames' => [
'<string>'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"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://setup.zuddl.com/api/mcp/tools/v1_create_event"
payload := strings.NewReader("{\n \"request\": {\n \"description\": \"<string>\",\n \"endDateTime\": \"2023-11-07T05:31:56Z\",\n \"startDateTime\": \"2023-11-07T05:31:56Z\",\n \"teamId\": \"<string>\",\n \"title\": \"<string>\",\n \"tz\": \"<string>\",\n \"brandKitId\": \"<string>\",\n \"languageCodes\": [\n \"<string>\"\n ],\n \"salesforceCampaignId\": \"<string>\",\n \"tagNames\": [\n \"<string>\"\n ]\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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://setup.zuddl.com/api/mcp/tools/v1_create_event")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"request\": {\n \"description\": \"<string>\",\n \"endDateTime\": \"2023-11-07T05:31:56Z\",\n \"startDateTime\": \"2023-11-07T05:31:56Z\",\n \"teamId\": \"<string>\",\n \"title\": \"<string>\",\n \"tz\": \"<string>\",\n \"brandKitId\": \"<string>\",\n \"languageCodes\": [\n \"<string>\"\n ],\n \"salesforceCampaignId\": \"<string>\",\n \"tagNames\": [\n \"<string>\"\n ]\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://setup.zuddl.com/api/mcp/tools/v1_create_event")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"request\": {\n \"description\": \"<string>\",\n \"endDateTime\": \"2023-11-07T05:31:56Z\",\n \"startDateTime\": \"2023-11-07T05:31:56Z\",\n \"teamId\": \"<string>\",\n \"title\": \"<string>\",\n \"tz\": \"<string>\",\n \"brandKitId\": \"<string>\",\n \"languageCodes\": [\n \"<string>\"\n ],\n \"salesforceCampaignId\": \"<string>\",\n \"tagNames\": [\n \"<string>\"\n ]\n }\n}"
response = http.request(request)
puts response.read_bodyEvents
Create Event
Tool name: v1_create_event · Behaviour: ✏️ Write
Create an event in the user’s Zuddl organization. Handles conferences, virtual events, webinars, field events and third-party events — set eventType, and for a conference or virtual event also set eventFormat. CONFIRM WITH THE USER BEFORE CALLING THIS. Creating an event is not reversible from here. Restate what you are about to create — title, type and format, start and end with the timezone, and the team — name anything you chose rather than were told, and get an explicit yes. Do not call this in the same turn the user first mentions the event, and never to “see what happens”. title and description must come from the user: ask for them and use their words rather than inventing something plausible. The timezone you may suggest when the conversation gives you a real basis, but say so and let them correct it. Call v1_list_teams first, every time, and take teamId from what it returns — never from memory or an earlier session. brandKitId comes from v1_list_brand_kits the same way. Tags and languages are given by name and resolved for you, and an unknown or ambiguous name comes back with the available options rather than a guess — nothing is created in that case. A NEEDS_INPUT response lists EVERY missing or inapplicable field for that event type at once, and nothing has been created — ask the user for all of them in one message, then call again. Read any DEFAULT values in resolvedPlan back to the user afterwards, and mention any warnings: a brand kit can fail to link without failing the create.
Same as Public API: Create an event (POST /v1/events)
Create Event
curl --request POST \
--url https://setup.zuddl.com/api/mcp/tools/v1_create_event \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"request": {
"description": "<string>",
"endDateTime": "2023-11-07T05:31:56Z",
"startDateTime": "2023-11-07T05:31:56Z",
"teamId": "<string>",
"title": "<string>",
"tz": "<string>",
"brandKitId": "<string>",
"languageCodes": [
"<string>"
],
"salesforceCampaignId": "<string>",
"tagNames": [
"<string>"
]
}
}
'import requests
url = "https://setup.zuddl.com/api/mcp/tools/v1_create_event"
payload = { "request": {
"description": "<string>",
"endDateTime": "2023-11-07T05:31:56Z",
"startDateTime": "2023-11-07T05:31:56Z",
"teamId": "<string>",
"title": "<string>",
"tz": "<string>",
"brandKitId": "<string>",
"languageCodes": ["<string>"],
"salesforceCampaignId": "<string>",
"tagNames": ["<string>"]
} }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
request: {
description: '<string>',
endDateTime: '2023-11-07T05:31:56Z',
startDateTime: '2023-11-07T05:31:56Z',
teamId: '<string>',
title: '<string>',
tz: '<string>',
brandKitId: '<string>',
languageCodes: ['<string>'],
salesforceCampaignId: '<string>',
tagNames: ['<string>']
}
})
};
fetch('https://setup.zuddl.com/api/mcp/tools/v1_create_event', 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://setup.zuddl.com/api/mcp/tools/v1_create_event",
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([
'request' => [
'description' => '<string>',
'endDateTime' => '2023-11-07T05:31:56Z',
'startDateTime' => '2023-11-07T05:31:56Z',
'teamId' => '<string>',
'title' => '<string>',
'tz' => '<string>',
'brandKitId' => '<string>',
'languageCodes' => [
'<string>'
],
'salesforceCampaignId' => '<string>',
'tagNames' => [
'<string>'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"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://setup.zuddl.com/api/mcp/tools/v1_create_event"
payload := strings.NewReader("{\n \"request\": {\n \"description\": \"<string>\",\n \"endDateTime\": \"2023-11-07T05:31:56Z\",\n \"startDateTime\": \"2023-11-07T05:31:56Z\",\n \"teamId\": \"<string>\",\n \"title\": \"<string>\",\n \"tz\": \"<string>\",\n \"brandKitId\": \"<string>\",\n \"languageCodes\": [\n \"<string>\"\n ],\n \"salesforceCampaignId\": \"<string>\",\n \"tagNames\": [\n \"<string>\"\n ]\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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://setup.zuddl.com/api/mcp/tools/v1_create_event")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"request\": {\n \"description\": \"<string>\",\n \"endDateTime\": \"2023-11-07T05:31:56Z\",\n \"startDateTime\": \"2023-11-07T05:31:56Z\",\n \"teamId\": \"<string>\",\n \"title\": \"<string>\",\n \"tz\": \"<string>\",\n \"brandKitId\": \"<string>\",\n \"languageCodes\": [\n \"<string>\"\n ],\n \"salesforceCampaignId\": \"<string>\",\n \"tagNames\": [\n \"<string>\"\n ]\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://setup.zuddl.com/api/mcp/tools/v1_create_event")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"request\": {\n \"description\": \"<string>\",\n \"endDateTime\": \"2023-11-07T05:31:56Z\",\n \"startDateTime\": \"2023-11-07T05:31:56Z\",\n \"teamId\": \"<string>\",\n \"title\": \"<string>\",\n \"tz\": \"<string>\",\n \"brandKitId\": \"<string>\",\n \"languageCodes\": [\n \"<string>\"\n ],\n \"salesforceCampaignId\": \"<string>\",\n \"tagNames\": [\n \"<string>\"\n ]\n }\n}"
response = http.request(request)
puts response.read_bodyAuthorizations
OAuth 2.1 access token. MCP clients obtain it themselves (dynamic client registration + PKCE) when you connect them to the server URL above.
Body
application/json
The tool's arguments, as sent in a JSON-RPC tools/call request.
The event to create. eventType, title, description, startDateTime, endDateTime, tz and teamId are always required.
Show child attributes
Show child attributes
Response
200
A JSON-RPC tools/call result. The tool's output is in content.
Was this page helpful?
⌘I