Skip to main content

Import from QRZ

QRZ offers two supported ways to move contacts into Hamtrax:

  • Connect the QRZ Logbook API for a workspace that checks contacts in both directions without downloading a file.
  • Export an ADIF file from QRZ and use Hamtrax's file importer.

The direct connection is the easiest option when you have the required QRZ subscription. The ADIF path is useful when you want a file backup or prefer not to connect an API key.

Option 1: connect QRZ directly​

Requires an XML-level QRZ subscription or higher

QRZ documents Logbook API access as a subscriber feature. Callsign lookups are already built into Hamtrax and do not require this connection.

1. Sign in and select the logbook​

  1. Sign in at QRZ.com.
  2. Open QRZ Logbook.
  3. Use the logbook selector in the upper-left to choose the logbook you want to connect. Each QRZ logbook has its own API key.
  4. Open Settings.

2. Copy the API key​

Find the QRZ Logbook API section, select Show beside API Key, and copy the complete key.

Treat the key like a password

The key grants read/write access to the selected QRZ logbook. Keep it private. Hamtrax uses it for contact reads and safe new-contact uploads while Automatically sync with QRZ is On or when you request Sync now. Hamtrax does not replace or delete existing QRZ records. See QRZ sync rules.

3. Connect Hamtrax​

  1. In Hamtrax, open Settings → Integrations, then select QRZ Logbook to open its dedicated page.
  2. Under Logbooks, select Add logbook — the last row, and the only one until a logbook is connected. Add a QRZ logbook opens.
  3. Paste the key into QRZ Logbook API Key.
  4. Review Automatically sync with QRZ, which starts On. Turn it Off before connecting if you want to sync manually.
  5. Select Connect logbook. Hamtrax opens the connected logbook's own page.

Hamtrax validates the key before encrypting it for server-side storage. The saved key is never returned to the app. A successful connection immediately completes the Get Started Connect QRZ milestone; transferring contacts is not required, and it also counts if you turn automatic sync Off. An existing connection counts when the checklist loads.

The key field, Automatically sync with QRZ, and Connect logbook appear in that order. Callsign routing and the optional key-security explanation sit alongside them on desktop and below them on tablet and phone.

Connecting with automatic sync On starts checking eligible existing contacts and future changes for this logbook. With it Off, connecting saves the key without transferring contacts; select Sync now on the logbook's page for one check without enabling automatic sync. Both actions include eligible Hamtrax contacts that may be sent to QRZ; they are not incoming-only imports. Existing logbooks keep their saved automatic-sync choices. Edits, ambiguous matches, and contacts needing a folder choice appear under Review issues. See QRZ sync rules.

More than one logbook​

Repeat these steps for each QRZ logbook you want to sync, up to five. The Logbooks header counts them, such as 2 / 5, and Add logbook is unavailable once five are connected. Each logbook uses its own API key and its own Automatically sync with QRZ choice. Hamtrax connects one logbook per callsign, so a key for a second logbook with an already connected callsign is refused. Each contact syncs only with the logbook whose callsign matches the contact's station callsign.

If a logbook reads Needs a new API key

Enter that logbook's key again: QRZ rejected the saved key, or the logbook was connected by an earlier version of Hamtrax. Open the logbook: its Automatically sync with QRZ card shows QRZ Logbook API Key and Validate & replace where Sync now, Review issues, and Excluded contacts usually sit, and only Disconnect remains below the cards. Enter a key for that same logbook. Until you do, the switch and Sync now stay unavailable.

If you used the old QRZ vault

Paste the API key once more to create the server connection. Hamtrax cannot migrate the old locally encrypted key because its vault passphrase was never stored.

Option 2: export an ADIF file from QRZ​

QRZ documents ADIF export as a subscriber feature.

Export the complete logbook​

  1. Open the correct QRZ logbook and select Settings.
  2. Find ADIF Import/Export.
  3. Select Export and follow QRZ's prompts to generate the ADIF file.
  4. Download the resulting .adi file.

Export only filtered contacts​

  1. Open or create a QRZ logbook view with the filters you need.
  2. Apply the filters and open the menu above the filter options.
  3. Select Export Results.
  4. Download the generated ADIF file.

Then continue with Importing Contacts. That page is the single maintained map of Hamtrax's browse, review, folder-routing, and finalize steps.

Official QRZ references​

QRZ website instructions last verified August 1, 2026. Hamtrax is independent from QRZ.com and is not endorsed by or affiliated with QRZ.