Skip to main content
Contacts are reusable payout destinations. The CLI supports three contact types:
  • email
  • crypto
  • bank

​
List contacts

hevn contacts list
hevn contacts list --yaml
hevn contacts list --limit 500 --offset 0 --json
YAML output normalizes contact records for agents and scripts.

​
Email contacts

Create an email contact: 
hevn contacts new \
  --type email \
  --name "Vendor" \
  --email vendor@example.com

​
Crypto contacts

Create an on-chain contact: 
hevn contacts new \
  --type crypto \
  --name "Treasury wallet" \
  --wallet-address 0x0000000000000000000000000000000000000000 \
  --chain base \
  --currency USDC
Optionally attach a linked email: 
hevn contacts new \
  --type crypto \
  --wallet-address 0x0000000000000000000000000000000000000000 \
  --chain base \
  --currency USDC \
  --email wallet-owner@example.com

​
Bank contacts

Bank contacts require an account holder type: 
hevn contacts new \
  --type bank \
  --bank-type sepa \
  --account-holder-type business \
  --account-holder-business-name "Vendor GmbH" \
  --bank-name "Example Bank" \
  --iban DE89370400440532013000 \
  --country DE \
  --currency EUR
Supported bank account types:
TypeTypical fields
sepa--iban, --country, --currency, optional --bic
ach--account-number, --routing-number, --country, --currency
swift--account-number, --bic, --country, --currency
uaefts--iban, optional --bic

​
Update metadata

Existing contact payment details cannot be replaced. You can update contact metadata such as name and relationship: 
hevn contacts new \
  --contact-id <contact-id> \
  --name "Updated name" \
  --relationship external

​
Delete a contact

hevn contacts delete <contact-id>
hevn contacts delete --contact-id <contact-id> --yes
Delete operations prompt for confirmation unless --yes is provided.