> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zuddl.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Session

> **Tool name:** `v1_create_session` · **Behaviour:** ✏️ Write

Create a new session for a specific event in your Zuddl organization.

**Same as Public API:** [Create a new session](/api-reference/sessions/create-a-new-session) (`POST /v1/events/{eventId}/sessions`)



## OpenAPI

````yaml https://api.prod.zuddl.com/api/v3/api-docs/mcp-tools post /tools/v1_create_session
openapi: 3.1.0
info:
  title: Zuddl MCP Tools Reference
  description: >-
    The Zuddl MCP server lets AI assistants such as Claude and ChatGPT work with
    your Zuddl organization through the [Model Context
    Protocol](https://modelcontextprotocol.io). This reference lists every tool
    the server offers. It is generated from the live server, so it always
    matches what your assistant sees.


    # Connecting


    Add `https://setup.zuddl.com/api/mcp` as a remote MCP server in your
    assistant. It signs you in to Zuddl with OAuth and then calls tools on your
    behalf, with your permissions. AI features must be enabled for your
    organization.


    # Calling a tool


    Assistants call a tool with a JSON-RPC `tools/call` request whose `name` is
    the tool name and whose `arguments` match the request body documented on the
    tool's page. The `/tools/<name>` paths in this reference identify tools;
    they are not HTTP endpoints.


    # Behaviour labels


    | Label | Meaning |

    | --- | --- |

    | 🔒 Read-only | Reads data and changes nothing. |

    | ✏️ Write | Creates or updates data, but does not delete it. |

    | ⚠️ Destructive | Deletes or removes data. Most assistants ask you to
    approve these calls. |

    | 🔁 Idempotent | Calling it again with the same arguments has no further
    effect. |


    A tool that mirrors a Public API endpoint links to that endpoint's page.
    MCP-only tools have no Public API equivalent.
  version: 1.0.0
servers:
  - url: https://setup.zuddl.com/api/mcp
    description: Zuddl MCP server
security:
  - oauth: []
tags:
  - name: Events
  - name: Attendees
  - name: Sessions
  - name: Speakers
  - name: Sponsors
  - name: Locations
  - name: Teams
  - name: Brand Kits
  - name: Registration flows & tickets
  - name: Analytics
paths:
  /tools/v1_create_session:
    post:
      tags:
        - Sessions
      summary: Create Session
      description: >-
        **Tool name:** `v1_create_session` · **Behaviour:** ✏️ Write


        Create a new session for a specific event in your Zuddl organization.


        **Same as Public API:** [Create a new
        session](/api-reference/sessions/create-a-new-session) (`POST
        /v1/events/{eventId}/sessions`)
      operationId: v1_create_session
      requestBody:
        description: The tool's `arguments`, as sent in a JSON-RPC `tools/call` request.
        content:
          application/json:
            schema:
              type: object
              properties:
                eventId:
                  type: string
                  description: Unique identifier of the event
                sessionCreateUpdateRequest:
                  type: object
                  description: >-
                    Session details to create (title, description, start/end
                    time, location, capacity, etc.)
                  properties:
                    availableSpots:
                      type: integer
                      format: int32
                      description: >-
                        **Deprecated**: use `totalCapacity` instead. Available
                        Spots for an In-person session.
                    description:
                      type: string
                      description: Description of the session
                    endDateTime:
                      type: string
                      format: date-time
                      description: End date time of the session.
                    externalRefId:
                      type: string
                      description: >-
                        A reference ID that you can use to map this session to
                        your external systems or databases
                    locationId:
                      type: string
                      format: uuid
                      description: ID of the in-person location for the session
                    parentSessionId:
                      type: string
                      description: Parent session ID of the session
                    startDateTime:
                      type: string
                      format: date-time
                      description: Start date time of the session
                    tags:
                      type: array
                      description: Tags for the session
                      items:
                        type: string
                    title:
                      type: string
                      description: Title of the session
                    totalCapacity:
                      type: integer
                      format: int32
                      description: >-
                        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.
                  required:
                    - endDateTime
                    - startDateTime
                    - title
              required:
                - eventId
                - sessionCreateUpdateRequest
        required: true
      responses:
        '200':
          description: A JSON-RPC `tools/call` result. The tool's output is in `content`.
components:
  securitySchemes:
    oauth:
      type: http
      description: >-
        OAuth 2.1 access token. MCP clients obtain it themselves (dynamic client
        registration + PKCE) when you connect them to the server URL above.
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.