Skip to main content

1Password Events Reporting item usage actions

You can use the 1Password Events API to send your 1Password account activity to your security information and event management (SIEM) system, including item usage.

ItemUsage objects contain actions, which describe how an item was used.

caution

Actions are only captured from client apps using 1Password 8.4.0 or later.

Item usage activity is only sent when client apps sync to the 1Password server. Not all item usage triggers a sync, so there may be delays before actions are received.

Item usage action values

Possible values for action include:

  • enter-item-edit-mode
  • export
  • fill
  • other
  • reveal
  • secure-copy
  • select-sso-provider
  • server-create
  • server-fetch
  • server-update
  • share

The behaviors that trigger each type of action are grouped below by 1Password client type.

enter-item-edit-mode

ClientBehavior
1Password appsAdd an item to Favorites.
Edit an item. Usage is recorded upon selecting Edit, whether or not the item is modified.

export

ClientBehavior
1Password appsDownload a file.
Export 1Password account data as a 1PUX or CSV file. Usage is recorded for every exported item.

fill

ClientBehavior
1Password apps

Fill an item by selecting:

  • "Open and fill"
  • "Type in window" (Windows only)
1Password in the browser

Fill an item by selecting:

  • Autofill
  • Auto-Type (Windows only)
  • Open & Fill
  • An item from the inline menu in a form field

other

Item usage actions are only captured from devices using 1Password 8.4.0 or later. The other value indicates the action was performed using an earlier version of 1Password and is unknown.

ClientBehavior
1Password appsAction is unknown.

reveal

ClientBehavior
1Password appsPreview a file.
Reveal a password.
Show a password in large type.
1Password in the browserReveal a password.
Show a password in large type.

secure-copy

ClientBehavior
1Password appsCopy an item field.
Copy an item's password history.
1Password in the browserCopy an item field.
Copy an item in JSON format.

select-sso-provider

ClientBehavior
1Password in the browserSign in to a site using a sign-in provider.

server-create

The server prefix indicates that the action occurred on the server rather than in the client app.

ClientBehavior
1Password appsDuplicate an item.
Move an item.
1Password.comCreate an item.
Duplicate an item.
1Password CLICreate an item.
1Password Connect serverCreate an item.

server-fetch

The server prefix indicates that the action occurred on the server rather than the client app. server-fetch is a special kind of action type that isn't used by most clients. It's only used when the client reporting the usage is a web server, like 1Password Connect server.

ClientBehavior
1Password appsDownload a file.
Preview a file.
1Password.comOpen an item.
1Password CLIOpen an item.
1Password Connect serverGet all of an item's files.
Get the contents of a file.
Get the details of a file.
Get the details of an item.

server-update

The server prefix indicates that the action occurred on the server rather than the client app.

ClientBehavior
1Password appsAdd an item to Favorites.
Archive an item.
Delete an item.
Edit an item.
Move an item.
Restore an item.
1Password in the browserAdd an item to Favorites.
1Password.comAdd an item to Favorites.
Archive an item.
Delete an item.
Edit an item.
Restore an item.
1Password CLIArchive an item.
Delete an item.
Edit an item.
1Password Connect serverDelete an item.
Edit an item.
Replace an item.

share

ClientBehavior
1Password appsCopy an item in JSON format.
Duplicate an item.
Move an item.
Share a link to an item.
1Password.comShare a link to an item.

Learn more

Was this page helpful?