> For the complete documentation index, see [llms.txt](https://docs.globalalerting.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.globalalerting.com/administration/notifications/managing-global-address-books.md).

# Managing Global Address Books

{% hint style="info" %}
These actions require the **View Global Address Book** and **Manage Global Address Book** permissions.
{% endhint %}

## Contacts

### Adding Contacts

1. From the GAP Admin home page, click "Global Address Book" under the "Notifications" section.
2. Click the "+ New Contact" button.
3. Enter the contact's name in the "Contact name" text box.
4. Select the tenant in which the contact will reside from the "Tenant" drop-down list.
5. If you want the contact to be available to sub-tenants, check the "Available to subtenants" check box.
6. Click the "+ Add Contact Method" button.
7. Select a contact method from the left-hand side drop-down list.  This can either be an e-mail address, phone number (for SMS), GAP device ID or phone number (for a call).
8. Enter the e-mail address, phone number or GAP device ID into the next text box.
9. Repeat steps 6 and 7 as required.
10. If you want to be able to synchronise the contact to a supported device, check the "Sync contact to device" check box.
11. If you want to include the contact details on emergency event notification e-mails, check the "Use as escalation contact" check box.
12. Click the "Save Contact" button.

{% embed url="<https://vimeo.com/1177179437?fe=ci&fl=sv&share=copy>" %}

### Editing Contacts

1. From the GAP Admin home page, click "Global Address Book" under the "Notifications" section.
2. Click on the contact you want to edit.
3. If you want the contact to be available to sub-tenants, check the "Available to subtenants" check box.
4. To add new contact methods, click the "+ Add Contact Method" button.
5. Select a contact method from the left-hand side drop-down list.  This can either be an e-mail address, phone number (for SMS), GAP device ID or phone number (for a call).
6. Enter the e-mail address, phone number or GAP device ID into the next text box.
7. Repeat steps 6 and 7 as required.
8. To delete existing contact methods, click the "Delete Contact Method" button.
9. If you want to be able to synchronise the contact to a supported device, check the "Sync contact to device" check box.
10. If you want to include the contact details on emergency event notification e-mails, check the "Use as escalation contact" check box.
11. Click the "Save Contact" button.

### Deleting Contacts

1. From the GAP Admin home page, click "Global Address Book" under the "Notifications" section.
2. Click on the contact you want to delete.
3. Click the "Delete Contact" button.
4. At the confirmation dialog, click the "Delete Contact" button.

## Distribution Lists

### Adding Distribution Lists

1. From the GAP Admin home page, click "Global Address Book" under the "Notifications" section.
2. Click the "Distribution Lists" tab.
3. Click the "+ New Distribution List" button.
4. Enter the list name in the "List name" text box.
5. Select the tenant in which the list will reside from the "Tenant" drop-down list.
6. If you want the list to be available to sub-tenants, check the "Available to subtenants" check box.
7. Click the "+ Add Entry" button.
8. Select a contact method from the left-hand side drop-down list.  This can either be an e-mail address, phone number (for SMS), GAP device ID or phone number (for a call).
9. Enter the e-mail address, phone number or GAP device ID into the next text box.
10. Repeat steps 7 - 9 as required.
11. If you want to be able to synchronise the list to a supported device, check the "Sync contact to device" check box.
12. Click the "Save Distribution List" button.

{% embed url="<https://vimeo.com/1177182550?fe=ci&fl=sv&share=copy>" %}

### Editing Distribution Lists

1. From the GAP Admin home page, click "Global Address Book" under the "Notifications" section.
2. Click on the list you want to edit.
3. If you want the list to be available to sub-tenants, check the "Available to subtenants" check box.
4. To add new entries, click the "+ Add Entry" button.
5. Select a contact method from the left-hand side drop-down list.  This can either be an e-mail address, phone number (for SMS), GAP device ID or phone number (for a call).
6. Enter the e-mail address, phone number or GAP device ID into the next text box.
7. Repeat steps 4 - 6 as required.
8. To delete existing contact methods, click the "Delete Entry" button.
9. If you want to be able to synchronise the list to a supported device, check the "Sync distribution list to device" check box.
10. Click the "Save Distribution List" button.

### Deleting Distribution Lists

1. From the GAP Admin home page, click "Global Address Book" under the "Notifications" section.
2. Click the "Distribution Lists" tab.
3. Click on the list you want to delete.
4. Click the "Delete Distribution List" button.
5. At the confirmation dialog, click the "Delete Distribution List" button.
