# How to add, import, and share contacts with your team

Onyx Phone contacts are shared by your whole team. When a number is in your contacts, its name shows on calls, texts, voicemails, and the incoming call screen, on the website and in the iPhone and Android apps, in place of the caller ID name the carrier sends. This guide shows how to add and edit contacts, add a caller from a call, import a CSV from Google Contacts, Outlook, or your CRM, keep each business's contacts on its own lines, and keep them in sync with Zapier.

Works on: Web app, Android app, iPhone app. Updated November 12, 2026. Web page with labeled screenshots: https://www.onyxphone.io/guides/contacts

## Step 1. See and search your contacts (Web app)

- Step 1.a: Click Contacts in the menu on the left (at the bottom of the screen on a phone).
- Step 1.b: Type a name, company, email, or part of a number in the search box and click Search.
- Step 1.c: Click Edit next to a contact to change it.

![The Contacts page with Add contact, Import CSV, and Export CSV, the search box, and the list of contacts with their numbers.](https://www.onyxphone.io/guides/shots/web-contacts-list.webp)

## Step 2. Add a contact (Web app)

- Step 2.a: On Contacts, click Add contact.
- Step 2.b: Type a Name, a Company, or both.
- Step 2.c: Type each Phone number in any format, and pick a label such as Mobile or Work. Numbers outside the US start with + and the country code.
- Step 2.d: Optionally add an Email and Notes for the team.
- Step 2.e: Click Add contact. Calls and texts from those numbers now show the name.

![The Add a contact form with the name, company, phone numbers with labels, email, notes, and the Add contact button.](https://www.onyxphone.io/guides/shots/web-contact-form.webp)

## Step 3. Add a caller from a call or a text (Web app)

- Step 3.a: Open the call from Calls, or the conversation from Messages.
- Step 3.b: On a call, find Contact in the call's details and click Add to contacts. In a conversation, click Add to contacts under the number at the top.
- Step 3.c: The number is filled in. Type their name and click Add contact. You come back to the call or conversation.
- Step 3.d: When the number is already a contact, click its name or Edit contact to change it. The carrier's own name for the caller stays on the call as Carrier caller ID.

## Step 4. Import contacts from a CSV (Web app)

Only account admins can import. Export your contacts from Google Contacts, Outlook, or your CRM as a CSV, or start from the template.

- Step 4.a: On Contacts, click Import CSV.
- Step 4.b: Click Download the template if you're starting from scratch. What each column does explains every column.
- Step 4.c: Under CSV file, choose your file. If your account keeps contacts to chosen lines, tick the lines they belong on.
- Step 4.d: Click Check the file. Each row says whether it adds a new contact, updates one you have, or is skipped and why.
- Step 4.e: Click Import to save them. Big files import in the background; the page updates by itself.

Tip: A row whose number is already a contact updates that contact. Filled cells replace what it had and empty ones leave it alone, so you can import the same file again after changing it.

![The Import contacts page with Download the template, the CSV file chooser, Check the file, and what each column does.](https://www.onyxphone.io/guides/shots/web-contacts-import.webp)

![The Check the import page saying how many contacts it will add, update, and skip, with the Import button and each row's result.](https://www.onyxphone.io/guides/shots/web-contacts-import-check.webp)

## Step 5. Keep each business's contacts on its own lines (Web app)

For an account that runs more than one business, so one business's customers don't show on the other's lines.

- Step 5.a: On Contacts, click Which lines contacts show on.
- Step 5.b: Choose Choose lines for each contact and click Save.
- Step 5.c: When you add or edit a contact, tick All lines, a business's lines, or single lines under Lines. A business covers lines it gets later.
- Step 5.d: To put contacts on a line you just added, click Copy contacts to a line, choose where to copy from and the new line, and click Copy.
- Step 5.e: To change many at once, tick contacts in the list, choose a line under Checked contacts, and click Add to or Take off.

![The Which lines contacts show on setting, with Every contact on every line and Choose lines for each contact.](https://www.onyxphone.io/guides/shots/web-contacts-lines.webp)

## Step 6. Add or edit a contact in the iPhone or Android app (iPhone and Android)

- Step 6.a: Tap Calls and find the call in Recent calls.
- Step 6.b: Tap the call to open it.
- Step 6.c: Tap Add to contacts, or Edit contact when the number already has a name.
- Step 6.d: Type the Name, and optionally the Company, Email, and Notes, then tap Add or Save.

Tip: Recent calls, voicemails, and conversations show the contact's name as soon as it's saved, on every teammate's phone and browser.

## Step 7. Sync contacts with Google Contacts, Outlook, or a CRM

- Step 7.a: Connect Onyx Phone to Zapier; see API, Zapier, and AI.
- Step 7.b: To bring contacts in, make a Zap with your other app's new or updated contact as the trigger and Onyx Phone's Create or Update Contact as the action. Map the phone number, name, company, and email.
- Step 7.c: To send contacts out, use Onyx Phone's New Contact or Updated Contact trigger and your other app's create or update step.
- Step 7.d: Use Find Contact in a Zap to look up the name for a caller's number.

## Questions and answers

### Who sees our contacts?

Everyone on your team, on the website and in the apps. When contacts are kept to chosen lines, a teammate sees the contacts for the lines they answer.

### Who can add, edit, and delete contacts?

Everyone can add and edit contacts unless an admin turns that off for them on their page in Team, under Permissions. Only admins can delete contacts, import a CSV, and export.

### What shows when a contact and the carrier both have a name?

The contact's name. The carrier's caller ID name stays on the call's details as Carrier caller ID.

### Can one number belong to two contacts?

Only on different lines. While every contact is on every line, a number belongs to one contact. When contacts are kept to chosen lines, each business can have its own contact for the same number.

### Does importing a big file run our Zaps thousands of times?

No. Imports don't send the New Contact or Updated Contact triggers. Contacts added or changed one at a time do.

### Do changes from a two-way Zapier sync bounce back and forth?

No. A change made through a Zapier connection isn't sent back to that same connection's triggers.

### Can I export our contacts?

Yes. Admins click Export CSV on Contacts. The file uses the import's columns, so you can edit it and import it again.