---
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.

## 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.                                                                                                                            |
| `slug`        | string | No       | Team slug.                                                                                                                          |


---

[View full sitemap](/docs/sitemap)