# Livestorm Documentation

> Build rich custom integrations, apps, and plugins with Livestorm. Grow your business. Check our API reference and developer documentation.

Append .md to any documentation page URL to get its markdown version.

## Guides
- [Introduction](https://developers.livestorm.co/docs/introduction.md)
- [Use cases](https://developers.livestorm.co/docs/use-cases.md)
- [Model Context Protocol (MCP)](https://developers.livestorm.co/docs/model-context-protocol-mcp.md)
- [Rate limits](https://developers.livestorm.co/docs/rate-limits-and-quotas.md): Learn everything about Livestorm's API rate limits
- [About the Marketplace](https://developers.livestorm.co/docs/about-the-marketplace.md): Discover what is Livestorm Marketplace
- [Marketplace listing requirements](https://developers.livestorm.co/docs/marketplace-listing-requirements.md): Everything you need to provide to be listed in the Livestorm Marketplace

## API Reference
- [Test authentication](https://developers.livestorm.co/reference/get_ping.md): Test whether your API token or OAuth2 access token works.
- [Get current user](https://developers.livestorm.co/reference/get_me-1.md): Get the currently connected user (only supported with OAuth2) and organization.
- [Get current organization](https://developers.livestorm.co/reference/get_organization-1.md): Get the currently connected workspace organization.
- [List events](https://developers.livestorm.co/reference/get_events.md): List the events of your workspace.
- [Create an event](https://developers.livestorm.co/reference/post_events.md): Create a new event or duplicate an existing one.
- [Get an event](https://developers.livestorm.co/reference/get_events-id.md): Retrieve a single event.
- [Fully update an event](https://developers.livestorm.co/reference/put_events-id.md): Update an event with its full list of attributes.
- [Partially update an event](https://developers.livestorm.co/reference/patch_events-id.md): Partially update an event with some of its attributes.
- [Delete an event](https://developers.livestorm.co/reference/delete_events-id.md): Delete a single event.
- [List the people from an event](https://developers.livestorm.co/reference/get_events-id-people.md): List all the people linked to all the sessions of an event.
- [Get someone's details for an event](https://developers.livestorm.co/reference/get_events-event-id-people-id.md): Get the details of someone who engaged with an event (who either registered or attended a session of this event).
- [List event sessions](https://developers.livestorm.co/reference/get_events-id-sessions.md): List all the sessions of an event.
- [Create an event session](https://developers.livestorm.co/reference/post_events-id-sessions.md): Create a new session for an event.
- [Assign a tag](https://developers.livestorm.co/reference/post_events-id-tags-1.md): Assign a tag to an event. If the tag does not exist, it will be created.
- [Remove a tag](https://developers.livestorm.co/reference/delete_events-id-tags.md): Remove a tag from an event. The tag itself is not deleted.
- [List the chat messages from a session](https://developers.livestorm.co/reference/get_sessions-id-chat-messages.md): List all the chat messages of a session.
- [List the people from a session](https://developers.livestorm.co/reference/get_sessions-id-people.md): List all the participants of a session.
- [Remove someone from a session using an email](https://developers.livestorm.co/reference/delete_sessions-id-people.md): Remove a registrant from a session using his/her email address.
- [Register someone for a session](https://developers.livestorm.co/reference/post_sessions-id-people.md): Register a new participant for a session (either an external registrant or internal team member).
- [Update a contact in a session](https://developers.livestorm.co/reference/patch_sessions-period-id-people-id.md): Update a contact's registration data for a specific session. This endpoint allows updating UTM tracking data (referrer, utm_source, utm_medium, etc.) and custom registration fields. Protected fields like email cannot be modified.
- [Get someone's details for a session](https://developers.livestorm.co/reference/get_sessions-session-id-people-id.md): Get the details of someone who engaged with a session (who either registered or attended the session).
- [Creates a job for registering multiple registrants to a session](https://developers.livestorm.co/reference/post_sessions-id-people-bulk.md): Creates a job for registering multiple registrants to a session.
- [Remove someone from a session](https://developers.livestorm.co/reference/delete_sessions-id-people-people-id.md): Remove a registrant from a session using his/her ID.
- [List the questions from a session](https://developers.livestorm.co/reference/get_sessions-id-questions.md): List all the questions of a session.
- [List the recordings from a session](https://developers.livestorm.co/reference/get_sessions-id-recordings.md): List all the recordings of a session.
- [Get a Session](https://developers.livestorm.co/reference/get_sessions-id.md): Retrieve a single session.
- [Fully update a session](https://developers.livestorm.co/reference/put_sessions-id.md): Update a session with its full list of attributes.
- [Partially update a session](https://developers.livestorm.co/reference/patch_sessions-id.md): Partially update a session with some of its attributes.
- [Delete a session](https://developers.livestorm.co/reference/delete_sessions-id.md): Delete a single session.
- [List Sessions](https://developers.livestorm.co/reference/get_sessions.md): List all your event sessions.
- [List people](https://developers.livestorm.co/reference/get_people.md): List all the people belonging to your workspace, who engaged with one of your event sessions at some point, including your team members.
- [Get a person](https://developers.livestorm.co/reference/get_people-id.md): Retrieve someone's details.
- [Get a job](https://developers.livestorm.co/reference/get_jobs-id.md): Retrieve job's status.
- [List job tasks](https://developers.livestorm.co/reference/get_jobs-id-tasks.md): List all the tasks of a job.
- [List people_attributes](https://developers.livestorm.co/reference/get_people-attributes.md): List the people_attributes of your workspace.
- [Create a user](https://developers.livestorm.co/reference/post_users-1.md): Create a new team member user.
- [Get Team Members](https://developers.livestorm.co/reference/get_users-1.md): List organization team members.
- [Delete a user](https://developers.livestorm.co/reference/delete_users-id-1.md): Delete a team member user.
- [Create a webhook](https://developers.livestorm.co/reference/post_webhooks.md): Create a new webhook subscription.
- [List webhooks](https://developers.livestorm.co/reference/get_webhooks.md): List all your webhook subscriptions.
- [Delete a webhook](https://developers.livestorm.co/reference/delete_webhooks-id.md): Delete a single webhook subscription.

## Changelog
- [New: Categorize and Organize Events with Tags](https://developers.livestorm.co/changelog/new-categorize-and-organize-events-with-tags.md)
- [New date-based filters for events, sessions, and people](https://developers.livestorm.co/changelog/new-date-based-filters-for-events-sessions-and-people.md)
- [API: "name" field added to the Session endpoints](https://developers.livestorm.co/changelog/api-name-field-added-to-the-session-endpoints.md)
- [New "people.watched_replay" webhook](https://developers.livestorm.co/changelog/new-webhook-peoplewatched_replay.md)
- [New GET /people_attributes](https://developers.livestorm.co/changelog/new-get-people_attributes.md)
- [New Bulk Registration API Endpoint](https://developers.livestorm.co/changelog/new-bulk-registration-api-endpoint.md)
- [API: Email is now the only mandatory field to register someone](https://developers.livestorm.co/changelog/api-email-is-now-the-only-mandatory-custom-field-to-register-someone.md)
- [New GET /sessions/{id}/questions Endpoint](https://developers.livestorm.co/changelog/new-get-sessionsidquestions-endpoint.md)
- [New GET /sessions/{id}/recordings Endpoint](https://developers.livestorm.co/changelog/new-get-sessionsidrecordings-endpoint.md)
- [API: New GET /sessions/{id}/chat_messages Endpoint](https://developers.livestorm.co/changelog/api-new-get-sessionsidchat_messages-endpoint.md)