Import a collection into a binder with the API

If your collection lives in a spreadsheet or another tool, the API can bring it into Holo Folder without retyping every card. This guide covers the approach. Request formats and limits are documented at /app/docs.

Pick a target binder

Imports write into a named binder. Changes stay scoped to that binder, so a test import never touches the rest of your collection. Start with a small binder while you check your mapping.

Match the exact printing

Map each row to an exact catalog printing and keep its cardId. A physical copy has its own inventoryItemId; a slot has a slotId within a collectionId. Trainer and Energy printings can use card or free-slot targets without a Pokémon species link.

Review conflicts first

Entries that do not match cleanly, or that are not supported, are reported before anything changes. Fix them in your source data or skip them, then run the import.

Use a write-enabled key

Imports need write permission. Create a separate key for the import, and revoke it when you are done.

Read the developer docs