# Managing Contacts

Memorizing wallet addresses is impossible. It's much better to assign a name to the address. Integral has two main ways to assign contacts to wallet addresses: (1) Add a single contact from Bookkeeping; or (2) Upload a CSV of your contacts.&#x20;

## Add a Contact from Bookkeeping

Creating a new contact from the Bookkeeping page is easy. Whenever you come across a transactions from/to an address you know, simply **hover over the address** and **select Add Contact**.&#x20;

### **Link Contact**

Integral imports your customers and vendors from your ERP (QuickBook/Xero). Linking an address to an existing contact, or to an ERP customer/vendor automatically imports all their information so everything stays in sync. This is also required to push customers/vendors as part of journal entries. This is the preferred method.

{% hint style="info" %}
A single contact can have multiple addresses across chains associated with them. You can link an existing contact to additional wallet addresses.
{% endhint %}

<figure><img src="/files/JPxXAVNBjgWJbn16pTCt" alt=""><figcaption></figcaption></figure>

### **Add Contact**

This creates a new contact in Integral. You must associate the address with a contact name, and optionally Company and Email. At this time, Integral does not publish customers or vendors to your ERP.

<figure><img src="/files/TZgydGr6tHtCfER50RQg" alt=""><figcaption><p>Click to add contact in Bookkeeping V2</p></figcaption></figure>

### Add Contacts in Bulk Using a CSV

If you prefer to import contacts you already have documented:&#x20;

1. Navigate to the [Contacts page](https://app.integraltreasury.xyz/contacts/integral)
2. Download the template by clicking `"Import Contacts"` > `"Download Template"` in the top-right corner
3. Fill in the information (address, chain, and name are required\* fields)
4. Click on `"Import Contacts"` > `"Upload CSV"` in the top right corner to select your file
5. Review the preview to make sure the information is correct, then click `"Import X Contacts"`

That's it! All your contacts have been imported, and your transactions updated with their names.

<figure><img src="/files/Y7bI19hIoEODnAse0YEZ" alt=""><figcaption></figcaption></figure>

### **Delete a contact or a contacts wallet**

To delete a contact and remove it from any transactions, navigate to the [Contacts page](https://app.integraltreasury.xyz/contacts/integral). From here, you can either delete a contact entirely or simply delete one of the contacts' wallets.

1. Select the customer(s) you want to delete using the checkboxes on the left.&#x20;
2. Click `"Delete"` in the bulk actions bar at the bottom of the page.&#x20;

To delete a wallet of a contact but not the contact itself:

1. Click on the contact and then Wallets
2. Click the edit button beside the wallet you want to delete, and then `"Remove"`.

<figure><img src="/files/mc3sBgFUaoFt0N6g4uGZ" alt=""><figcaption><p>Delete a contact or wallet of a contact</p></figcaption></figure>

### Filter a contact in Bookkeeping (V2)

To filter to only see transactions that interact with a specific contact in Bookkeeping:

1. Go to Bookkeeping
2. Find a transaction related to the contact
3. Click on the contact name and hit `"Filter"`
4. Only transactions that are To or From that contact will now appear in the Bookkeeping view

<figure><img src="/files/2bOQxhhAhOqbTMryroYh" alt=""><figcaption><p>Filter a contact in Bookkeeping V2</p></figcaption></figure>

{% hint style="info" %}
To filter a contact in Bookkeeping V1, copy-paste the wallet address or contact name into the Bookkeeping search bar to surface transactions related to that contact.&#x20;
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://integral-treasury.gitbook.io/integral-treasury/bookkeeping-and-accounting/managing-contacts.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
