Skip to main content
If you’re new to Events Reporting, learn how to get started with 1Password Events API.
To help you get started with the 1Password Events API we’ve put together a repository of example scripts across several languages, including JavaScript, Python, Ruby, Go, and PHP. The scripts will print up to 20 sign-in attempts and item usage events from the last 24 hours.

​
Requirements

Before implementing any of the examples, or your own scripts, you’ll need to generate a bearer token and store it in your 1Password account. To get a bearer token, you can:

​
Usage

All scripts use the EVENTS_API_TOKEN environment variable to load your API token. We recommend setting EVENTS_API_TOKEN to a secret reference that points to where your bearer token is saved in 1Password, to avoid revealing the token in plaintext. Then you can use op run with 1Password CLI to securely provision the token at runtime. Learn more about securely loading secrets from the environment. For example, to set the EVENTS_API_TOKEN environment variable with an environment file, then use op run to run the PHP eventsapi.php script with the variable provisioned:
events.env
EVENTS_API_TOKEN="op://Vault/Item/token"

op run --env-file="./events.env" -- php eventsapi.php
To export the EVENTS_API_TOKEN environment variable, then use op run to run the Go eventsapi.go script with the variable provisioned: 
EVENTS_API_TOKEN="op://Vault/Item/token" op run -- go run eventsapi.go

​
Learn more