SOURCE_URL: https://majikah.solutions/products/majik-buwiz/docs/buwiz-contacts-overview

---
title: "Managing Contacts in Majik Buwiz"
id: "buwiz-contacts-overview"
group: "majik-buwiz"
type: "products"
version: "0.1.1"
lastUpdated: "2026-05-13T00:00:00.000Z"
difficulty: "Beginner"
time: "3–5 minutes"
tags: [contacts, directory, recipients, public-key, tax-profile, encryption, exchange]
---

# Managing Contacts in Majik Buwiz

> What contacts are in Majik Buwiz, what they store, and how they connect to invoices and the Exchange

## Overview
Contacts in Majik Buwiz are more than an address book — each contact holds a full tax identity record and the cryptographic public keys needed to send them encrypted invoices. This overview explains what contacts are, what they contain, and how they are used across the app.

### What is a contact in Majik Buwiz?

A contact in Majik Buwiz is a cryptographic contact record — it combines the billing party information you would find on an invoice (legal name, TIN, address, tax classification) with the public key material needed to send that party encrypted invoices via the Exchange. Every contact requires a valid public key to be created. There is no basic or key-free contact mode — the cryptographic fields are mandatory because the app's encryption and signing features depend on them.

### How contacts connect to invoices

When you create an invoice and select a recipient from your Contacts, their party information (legal name, TIN, address, etc.) is copied into the invoice's recipient field as a snapshot. Their ML-KEM-768 public key is used to encrypt the invoice if you choose encrypted mode. Their Ed25519 and ML-DSA-87 public keys are used to verify any signatures they have added. Changes to a contact after an invoice is created do not affect that invoice — the data was snapshotted at invoice creation time.

### What a contact record contains

| Field | Required? | Purpose |
| --- | --- | --- |
| Legal Name | Yes | Primary party name on invoices |
| Trade Name | No | DBA name |
| Nature of Business | No | Industry classification |
| TIN | No | Tax Identification Number |
| Tax ID Type | No | Type of tax identifier |
| Tax Exempt | No | Whether party is tax-exempt |
| Tax Exempt Reference | No | Exemption certificate reference |
| Taxpayer Type | No | BIR-aligned legal classification |
| Taxpayer Category | No | Sub-classification |
| VAT Type | No | VAT-registered, non-VAT, or zero-rated |
| Is Percentage Tax | No | Subject to 2551Q |
| Is Withholding Agent | No | Registered withholding agent |
| Default ATC | No | EWT alphanumeric tax code hint |
| Address | No | Structured postal address |
| Email / Phone / Website | No | Contact information |
| Ed25519 Public Key | Yes (crypto) | Signature verification |
| ML-DSA-87 Public Key | Yes (crypto) | Post-quantum signature verification |
| ML-KEM-768 Public Key (mlKey) | Yes (crypto) | Encryption key for sending encrypted invoices |
| Fingerprint | Yes (crypto) | Unique contact identifier derived from public key |

*Caption: All fields stored in a Majik Buwiz contact.*

### How to add a contact

Because a contact requires cryptographic key material, you cannot add one by typing details manually from scratch. Contacts are added by importing a contact's public key in one of two formats: a .png contact card (a scannable image that encodes the contact's public key and party metadata) or an invite key string (a text string encoding the same data). Both formats are exported from the other party's Majikah product. Once imported, you can edit all non-cryptographic fields (name, TIN, address, tax profile) freely.

### Exporting contacts

Each contact can be exported as a .png contact card — a portable image that encodes their full public key and party metadata. You can export individual contacts or perform a batch export as part of a full backup. Contacts are also included in the app's general backup export.

> **NOTE:** Contacts can be organized into groups for easier filtering and management. See Organizing Contacts with Groups for details.