---
title: list_user_events
product: vercel
url: /docs/agent-resources/vercel-mcp/tools/teams/list_user_events
canonical_url: "https://vercel.com/docs/agent-resources/vercel-mcp/tools/teams/list_user_events"
last_updated: 2018-10-20
type: reference
prerequisites:
  - /docs/agent-resources/vercel-mcp/tools/teams
  - /docs/agent-resources/vercel-mcp/tools
related:
  []
summary: Use list_user_events with Vercel MCP.
install_vercel_plugin: npx plugins add vercel/vercel-plugin
---

# list_user_events

List User Events.


<!-- docsgraph:related -->
## Related pages

> **For AI agents:** Follow these links to understand how this page connects to the rest of the Vercel ecosystem. For the full cross-link map (inbound, outbound, prerequisites, and semantic neighbors), see the .graph.md link below.

- [count_events](https://vercel.com/docs/agent-resources/vercel-mcp/tools/web-analytics/count_events) — Use count_events with Vercel MCP.
- [list_team_members](https://vercel.com/docs/agent-resources/vercel-mcp/tools/teams/list_team_members) — Use list_team_members with Vercel MCP.
- [aggregate_events](https://vercel.com/docs/agent-resources/vercel-mcp/tools/web-analytics/aggregate_events) — Use aggregate_events with Vercel MCP.
- [list_event_types](https://vercel.com/docs/agent-resources/vercel-mcp/tools/teams/list_event_types) — Use list_event_types with Vercel MCP.
- [list_teams](https://vercel.com/docs/agent-resources/vercel-mcp/tools/teams/list_teams) — Use list_teams with Vercel MCP.

Full cross-link map for this page: [/docs/agent-resources/vercel-mcp/tools/teams/list_user_events.graph.md](/docs/agent-resources/vercel-mcp/tools/teams/list_user_events.graph.md)
<!-- /docsgraph:related -->

## Parameters

| Parameter     | Type   | Required | Description                                                                                                                         |
| ------------- | ------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| `limit`       | number | No       | Maximum number of items which may be returned.                                                                                      |
| `since`       | string | No       | Timestamp to only include items created since then.                                                                                 |
| `until`       | string | No       | Timestamp to only include items created until then.                                                                                 |
| `types`       | string | No       | Comma-delimited list of event "types" to filter the results by.                                                                     |
| `userId`      | string | No       | Deprecated. Use `principalId` instead. If `principalId` and `userId` both exist, `principalId` will be used.                        |
| `principalId` | string | No       | When retrieving events for a Team, the `principalId` parameter may be specified to filter events generated by a specific principal. |
| `projectIds`  | string | No       | Comma-delimited list of project IDs to filter the results by.                                                                       |
| `entityId`    | string | No       | Filters events to those associated with a specific entity (matched against `payload.id`). For example, a connector ID.              |
| `withPayload` | string | No       | When set to `true`, the response will include the `payload` field for each event.                                                   |
| `teamId`      | string | No       | Team ID to use for this operation.                                                                                                  |
| `slug`        | string | No       | Team slug to use for this operation. Use instead of teamId.                                                                         |


---

[View full sitemap](/docs/sitemap)