# Livestorm Documentation

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

## 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)