# Contact Management

Search, view, and manage contacts.

You can use the contact management tool to view details about specific contacts and remove channels and contacts from your Airship records.

If on an [AXP](https://www.airship.com/docs/reference/feature-packages/) plan, you can also create [Named Users](https://www.airship.com/docs/reference/glossary/#named_user) and add/remove [Channels](https://www.airship.com/docs/reference/glossary/#channel_dev) to/from a Named User.

For SDK methods for managing Named Users, see [Contacts](https://www.airship.com/docs/sdk-topics/contacts/) in our developer documentation.

## Contact lookup

You can look up a contact using these identifiers:

* [Channel ID](https://www.airship.com/docs/reference/glossary/#channel_id)
* [Named User](https://www.airship.com/docs/reference/glossary/#named_user) — Case-sensitive
* [Device Token](https://www.airship.com/docs/reference/glossary/#device_token)
* Email address
* Phone number — Can include a combination of spaces, dashes, and braces around the area code, for example: `18001234567`, `1 800 123 4567`, and `1 (800) 123-4567`

### Looking up a contact

To look up a contact:

1. Go to **Audience**, then **Contact Management**.
1. Enter an identifier and select **Look up**. Lookup results list for each identifier and associated Named User, if any:
   * Creation date and time
   * Last registration or modified date and time
   * Associated channel types
1. For more information about a channel or Named User, select the right arrow icon (
). See the next two sections for descriptions of those views.
   ![Email channel and Named User returned for a Channel ID lookup](https://www.airship.com/docs/images/contact-mgmt-search_hu_5084ed6fbea1c679.webp)
   
   *Email channel and Named User returned for a Channel ID lookup* 

### Viewing channel details

1. [Look up a contact](#looking-up-a-contact).
1. For a returned channel, select the right arrow icon (
). Data displayed for each channel:
   * Identifier
   * [Channel ID](https://www.airship.com/docs/reference/glossary/#channel_id)
   * Creation and last registration dates and times
   * Installation status
   * Opt-in status
      * App, Web, and Open channels display **Opted-In** or **Opted-Out**. **Background Enabled** or **Background Disabled** appears for App channel background push.
      * SMS channels have a check box, which is checked if opted in. You can check/uncheck the box to change the status.
      * Email channels have **Commercial** and **Transactional** check boxes, which are checked if opted in. You can check/uncheck the boxes to change the status. If an email channel is suppressed, you will see a button for removing suppression. See [Removing email suppression](#removing-email-suppression).
   * Tracking status — Email channels have **Open tracking** and **Click tracking** check boxes, which are checked if opted-in. You can check/uncheck the boxes to change the status.
   * In a holdout group — This label appears if the channel is currently excluded from messaging as part of an active [Holdout Experiment](https://www.airship.com/docs/reference/glossary/#holdout_experiment).
   ![Details for Email, SMS, iOS, and Web channels](https://www.airship.com/docs/images/contact-mgmt-channels_hu_1d4c0401b9a772dd.webp)
   
   *Details for Email, SMS, iOS, and Web channels*
1. Select the down arrow icon (
) for information associated with the channel. Data displayed per tabbed section:

   | Section | Description |
   | --- | --- |
   | **Channel detail** | Channel ID, push address, and aliases, if any. Email channels also display commercial and transactional opt-in/out dates, if any. |
   | **Channel tags** | [Tags](https://www.airship.com/docs/reference/glossary/#tag) |
   | **Tag groups** | [Tag Groups](https://www.airship.com/docs/reference/glossary/#tag_group) and the tags within the groups |
   | **Attributes** | [Attribute](https://www.airship.com/docs/reference/glossary/#attributes) IDs, types, and values. For JSON Attributes, the ID is formatted as `<attribute_ID#instance_ID>`. See [JSON Attributes](https://www.airship.com/docs/guides/audience/attributes/about/#json-attributes) in _About Attributes_. |
   | **Device properties** | [Device Properties](https://www.airship.com/docs/reference/glossary/#device_properties) Tag Groups and the tags within the groups |
   | **Subscription lists** | [Subscription List](https://www.airship.com/docs/reference/glossary/#subscription_list) IDs |
   | **Holdout group history** | The [Holdout Experiment](https://www.airship.com/docs/reference/glossary/#holdout_experiment) name and start and end times when the user was excluded from messaging |

### Viewing Named User details

To view information about a Named User:

1. [Look up a contact](#looking-up-a-contact).
1. For a returned Named User, select the right arrow icon (
). Data displayed per tabbed section:

   | Section | Description |
   | --- | --- |
   | **Channels** | Each channel is listed separately. The appearance and functionality is identical to the [detail view for a channel](#viewing-channel-details). |
   | **User Tag Groups** | [Tag groups](https://www.airship.com/docs/reference/glossary/#tag_group) and the tags within a group. |
   | **Attributes** | [Attribute](https://www.airship.com/docs/reference/glossary/#attributes) IDs, types, and values. For JSON Attributes, the ID is formatted as `<attribute_ID#instance_ID>`. See [JSON Attributes](https://www.airship.com/docs/guides/audience/attributes/about/#json-attributes) in _About Attributes_. |
   | **Message History** | A list of messages sent to the user within the last 30 days. |
   
   ![Named User details](https://www.airship.com/docs/images/contact-mgmt-named-user_hu_7ff4265973b8ef05.webp)
   
   *Named User details*

## Creating a Named User

[AXP](https://www.airship.com/docs/reference/feature-packages/)

If a channel is not yet associated with a Named User, you can manually create one:

1. [Look up a contact](#looking-up-a-contact).
1. For a returned channel, select the right arrow icon (
).
1. Select **Create Named User**.
1. Enter the user name.
1. Select **Submit**.

The channel and any channels associated with it will be associated with the Named User.

## Associating channels with a Named User

[AXP](https://www.airship.com/docs/reference/feature-packages/)

To add a channel:

1. [Look up a contact](#looking-up-a-contact).
1. For a returned Named User, select the right arrow icon (
).
1. Select **Add/edit channels**.
1. Enter a contact identifier and select **Look up**.
1. Select ** Add channel** for an individual channel.
   * If the channel you want to add is already associated with a Named User, both the individual channel and its currently associated Named User will be listed in the results.
   * If you searched for a Named User, or if a Named User was returned when searching for a different identifier, select **
 View channels** to see its associated channels. Select ** Add channel** to disassociate the channel from its current Named User and associate it with the Named User you are editing.

To disassociate a channel from a Named User:

1. [Look up a contact](#looking-up-a-contact).
1. For a returned Named User, select the right arrow icon (
).
1. Select **Add/edit channels**.
1. Select **Remove** for a channel.

## Deleting a channel

To remove a channel from your Airship records:

1. [Look up a contact](#looking-up-a-contact).
1. For a returned channel, select the right arrow icon (
). Make sure to select a channel, not a Named User. The option to delete a channel is not available when viewing details for a channel within a Named User record.
1. Select **Delete this channel**.

## Deleting a contact

To remove a contact and its associated channels from your Airship records:

1. [Look up a contact](#looking-up-a-contact).
1. Select the right arrow icon (
) for a channel or Named User.
1. Select **Delete this contact**.

## Removing email suppression

To remove the [suppression state](https://www.airship.com/docs/developer/api-integrations/email/bounce-handling/) for an email channel:

1. [Look up a contact](#looking-up-a-contact).
1. For a returned email channel, select the right arrow icon (
).
1. Select the information icon () next to the Opt-in Status check box to view the complaint reason.
1. Select **Remove suppression**. The button is only present if the channel is suppressed.

The [Real-Time Data Streaming](https://www.airship.com/docs/reference/glossary/#rtds) [Email registration event](https://www.airship.com/docs/developer/rest-api/connect/schemas/email-compliance-events/#registration) for this action includes the username of the user who removed suppression.

After removing suppression, you must also opt the channel back in to messaging before they can receive email from you again.