1Password icon

1Password

Interact with 1Password API

Overview

This node integrates with the 1Password API to add a new item into a specified vault. It is useful for automating the creation and organization of various types of secure items such as logins, credit cards, identities, secure notes, and more within 1Password vaults. Practical applications include programmatically adding credentials or sensitive information during onboarding processes, syncing data from other systems, or bulk importing secure items.

Properties

Name Meaning
Vault UUID The unique identifier (UUID) of the vault where the item will be added. This specifies the target vault in 1Password.
Title The title or name of the item being created.
Category The category/type of the item. Options include: API Credential, Bank Account, Credit Card, Database, Driver License, Email Account, Identity, Login, Medical Record, Membership, Outdoor License, Passport, Password, Reward Program, Secure Note, Server, Social Security Number, Software License, SSH Key, Wireless Router.
URLs One or more URLs associated with the item. Each URL can be marked as primary or not.
Favorite Boolean flag indicating whether the item should be marked as a favorite in 1Password.
Tags Comma-separated list of tags to assign to the item for easier searching and categorization.
Sections Sections to organize fields within the item. Each section has an ID and a label.
Fields Custom fields included in the item. Each field can have properties such as ID, label, type (e.g., string, email, date), purpose (username, password, notes), value, and options for password generation like character sets, excluded characters, and length.

Output

The node outputs JSON data representing the newly created item as returned by the 1Password API. This typically includes the item's metadata such as its unique ID, title, category, vault association, URLs, tags, sections, and fields with their values. If the item contains any binary data (not typical for this operation), it would be represented accordingly, but this node primarily deals with structured JSON data.

Dependencies

  • Requires an API key credential for authenticating with the 1Password API.
  • The base URL for the 1Password API must be configured in the node's credentials.
  • Network access to the 1Password API endpoint is necessary.

Troubleshooting

  • Invalid Vault UUID: If the provided vault UUID does not exist or is incorrect, the API will return an error. Verify the vault UUID is correct.
  • Missing Required Fields: The "Title" and "Category" are mandatory. Omitting these will cause validation errors.
  • Authentication Errors: Ensure the API key credential is valid and has sufficient permissions to add items.
  • Malformed Fields or Sections: Incorrectly formatted fields or sections may cause the request to fail. Double-check the structure and required properties.
  • API Rate Limits: Frequent requests might hit rate limits imposed by 1Password; handle such errors by retrying after some delay.

Links and References

Discussion