Public preview

Adds programmatic access to account activity logs Public preview

What’s new

Adds programmatic access to your account’s security history through the Activity Logs API. Retrieve detailed logs of security-related activities across your Stripe account, including API key management, user invitations, and role changes. The new API adds the List activity logs endpoint. This endpoint retrieves a paginated list of activity logs with filtering options.

The API tracks the following action types:

• API key actions : Creation, deletion, updates, and viewing of API keys ( api _ key _ created , api _ key _ deleted , api _ key _ updated , api _ key _ viewed )
• User invitation actions : Creating, deleting, and accepting user invitations ( user _ invite _ created , user _ invite _ deleted , user _ invite _ accepted )
• User role actions : Updates and deletions of user roles ( user _ roles _ updated , user _ roles _ deleted )

Each ActivityLog object contains details about the event, including the actor, timestamp, affected resources, and contextual metadata.

Impact

Build automated security monitoring and compliance reporting systems by integrating with the Activity Logs API. This enables you to:

• Monitor API key lifecycle events for security auditing
• Track user access changes and role modifications
• Create custom alerting systems for suspicious activities
• Integrate activity data with external the related setting systems

Previously, this security information was available through the Dashboard, requiring manual review and limiting automation capabilities.

To learn how to programmatically access your account’s security history, see Activity logs.

Changes

Upgrade

1. View your current API version in Workbench.
2. If you use an SDK, upgrade to the corresponding SDK version for this API version.

• If you don’t use an SDK, update your API requests to include Stripe-Version: 2026-04-22. preview

3. Upgrade the API version used for webhook endpoints .
4. Test your integration against the new version.
5. If you use Connect, test your Connect integration .
6. In Workbench, perform the upgrade . You can roll back the version for 72 hours.

Learn more about Stripe API upgrades.