Skip to main content

Action-Based Import

With action-based import you can manage your records more flexibly. Instead of only creating new records, you can also update or delete existing ones directly from the import CSV file.

How it works​

When preparing your CSV file for import, you can add an action column. This tells Passwd what to do with each row:

  • create → Always creates a new record with a new ID
  • update → Updates an existing record with the given ID
  • delete → Deletes an existing record with the given ID

The action value is not case-sensitive. You can mix actions in one import file.

If the action column is missing, the default behavior is create (same as today).

Rules​

  • Create

    • A new record is always created.
    • A new ID is assigned, even if you provide one in the CSV.

  • Update

    • The row must contain a valid existing ID.
    • If the ID is missing or not found, the row is skipped.

  • Delete

    • The row must contain a valid existing ID.
    • Other fields in the row are ignored.
    • If the ID is missing or not found, the row is skipped.

Example​

version,action,type,id,name,username,password,note,web,tags,GSuite group IDs - viewers,GSuite group IDs - editors,GSuite group IDs - autofillOnly,GSuite whitelist user IDs - viewers,GSuite whitelist user IDs - editors,GSuite whitelist user IDs - autofillOnly,ignoreSecurityReport,createdBy - id,createdBy - name,createdBy - email,TOTP - secret,createdAt,fileName,fileData,cardNumber,cardholderName,expirationDate,cvvCode,credentials,hostname,server,port,databaseName,databaseType,privateKey,publicKey,secureNote
4,create,paymentCard,0i2egBOdXX067U2LrTuW,Card test,,,,,,,,,,,,,106836830256199635085,Marek,marek.@passwd.team,,1732284780547,,,8798455451321544,,06/54,845,,,,,,,,,
4,update,password,0oNgjqEUFhNPVfhMNBJW,Adobe,team,shared_password,,www.adobe.com,,,,01pxezwc3ndix4y,,,,false,106836830256199635085,Marek,marek@passwd.team,,1718008728092,,,,,,,,,,,,,,,
4,delete,password,0yuLAiUijIqnPVObUbnC,Facebook,marek,super-secret-password,,https://www.facebook.com/,,,,,,,111153092509596860363,false,106836830256199635085,Marek,marek@passwd.team,,1716540831956,,,,,,,,,,,,,,,

Download this example

Notes​

  • Rows without an action column are treated as create.
  • Errors, CSV formatting, and permissions work the same way as in the standard import.