Overview
Use this guide to connect your AHA eCard inventory to Hovn and set up the right permissions for issuing certifications.
Who this is for: Service Provider Admins and Owners
Outcome:
Your AHA Card Bank is connected
Issuers are assigned correctly
Instructor Agency IDs are in place
You can issue eCards from one or multiple banks
Why Connect Your AHA Card Bank?
A Card Bank links Hovn to your AHA eCard inventory at ecards.heart.org. Once connected, Hovn can issue certifications using the inventory you already manage.
This helps you:
Avoid double entry and errors
Keep rosters and records in one system
Support multiple alignments (Training Center, Training Site, Instructor-owned inventory)
Good to know: Issuing permissions are set per bank. Anyone added as an Issuer can issue from every bank they’re assigned to.
Before You Begin
Make sure you have:
Admin access to your Hovn Service Provider account
Your AHA Training Center ID
The correct Requester Key, based on who owns the inventory:
Training Center inventory → key from the TC Coordinator
Training Site inventory → key from the TS Coordinator
Instructor inventory → key from that instructor
AHA Instructor IDs added to the profiles of anyone who will issue certifications
Step 1 — Create an AHA Card Bank
Go to Settings → Card Banks → Create
Choose AHA eCard API
Name the bank clearly so your team recognizes it, for example:
AHA — Training Center Inventory
AHA — Training Site Inventory
AHA — Instructor Jane Doe
Step 2 — Choose Inventory Source & Add API Key
In the Card Bank form, enter:
TC ID: Your AHA Training Center ID
Requester Key: Generated by the owner of the inventory
Inventory Source: Select Training Center, Training Site, or Instructor to match the key
🔗 The bank owner generates the key at: ecards.heart.org/APIGateway
Step 3 — Assign Issuers
By default, Admins can issue from a bank.
To let an instructor issue:
Open the Card Bank
Click Add Issuer
Select the instructor
If an instructor issues from their own inventory, create a separate bank using their Requester Key and add them as the Issuer on that bank.
Rule of thumb: Issuers can issue from every bank they’re assigned to—assign carefully.
Step 4 — Add Agency IDs (Required)
Every issuer must have their AHA Instructor ID on their Hovn profile.
To add an ID:
Click your name → Profile
Scroll to Agency Identifications
Add American Heart Association
Enter your AHA Instructor ID (from Atlas)
Save
⚠️ Don’t see “Agency Identifications”? Make sure the user is set as an Instructor.
Common Setup Scenarios
Let selected instructors issue from your TC bank
Connect the TC bank
Add chosen instructors as Issuers
Confirm each instructor’s AHA ID is on their profile
Training Site inventory
Connect the TS bank
Add the right instructors as Issuers
Keep names and permissions site-specific
Instructor issues from their own inventory
Instructor generates the Requester Key
Create a bank with Instructor as the source
Add the instructor as an Issuer on that bank
(Optional) Remove them from other banks to avoid mistakes
Multiple alignments (TC + TS + Instructor)
Connect each bank with clear names
Assign Issuers only to the banks they should use
Issuers choose the correct bank at issuance time
Security & Naming Tips
Treat Requester Keys like passwords—store securely and rotate if needed
Use clear, descriptive bank names (include TC/TS/Instructor and owner)
Follow least-privilege access: only give issuer rights where needed
Remove issuer access promptly when roles change
Troubleshooting
An instructor can’t see the “Issue” option
Are they added as an Issuer on that exact bank?
Do they have the correct AHA Instructor ID on their profile?
Error loading inventory
Confirm the Inventory Source matches the owner of the Requester Key
Recreate the bank if the source and key don’t align
Purchasing eCards
eCards are purchased directly through your Training Center or Training Site (outside Hovn).
They load inventory into the appropriate bank based on your agreement.