# Contacts Management

Mailtrap Contacts allows you to upload and store your contacts on the Mailtrap platform and organize them in different email lists to send targeted campaigns.

## Key Features

* Import contacts via CSV, API, or third-party integrations
* Organize contacts into targeted lists and segments
* Manage custom fields for personalization
* Track subscription status and engagement

## Getting Started

<table data-view="cards" data-full-width="false"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Overview</strong></td><td><em>Filter, search, edit, and perform bulk actions on your contact database.</em></td><td><a href="/pages/YPXsDv6CWMlSnsrAbm6S">/pages/YPXsDv6CWMlSnsrAbm6S</a></td></tr><tr><td><strong>Custom Fields</strong></td><td><em>Define custom variables like name, date of birth, or location to personalize your campaigns.</em></td><td><a href="/pages/sZAO43LwyIX9uHGTKXcI">/pages/sZAO43LwyIX9uHGTKXcI</a></td></tr><tr><td><strong>Import Contacts</strong></td><td><em>Bulk contacts import from spreadsheets, sync via API, or use our integrations.</em></td><td><a href="/pages/jJvUMiKRJUXPmGZbQafk">/pages/jJvUMiKRJUXPmGZbQafk</a></td></tr><tr><td><strong>Lists</strong></td><td><em>Static groups of contacts that help you organize your audience for targeted email campaigns</em></td><td><a href="/pages/lWBpTOU8L3wtccIATrBo">/pages/lWBpTOU8L3wtccIATrBo</a></td></tr><tr><td><strong>Segments</strong></td><td><em>Dynamic groups of contacts that automatically update based on criteria you define</em></td><td><a href="/pages/GGnkCmyxMa8qo1cU7BNL">/pages/GGnkCmyxMa8qo1cU7BNL</a></td></tr></tbody></table>

## Contact management workflow

{% stepper %}
{% step %}
**Define custom fields**

Set up custom fields to store additional contact information for personalization.
{% endstep %}

{% step %}
**Import your contacts**

Upload contacts via CSV, API integration, or third-party tools like Zapier.
{% endstep %}

{% step %}
**Organize into lists**

Group contacts into relevant lists based on your marketing strategy.
{% endstep %}

{% step %}
**Create segments**

Build dynamic segments that automatically update based on contact properties.
{% endstep %}

{% step %}
**Launch campaigns**

Use your organized contacts to send targeted email marketing campaigns.
{% endstep %}
{% endstepper %}

## Import methods

{% tabs %}
{% tab title="CSV Import" %}
**Bulk upload from spreadsheets**

Perfect for migrating existing contact lists or periodic bulk updates.

* Download our CSV template
* Map fields to custom variables
* Import thousands of contacts at once
  {% endtab %}

{% tab title="API Integration" %}
**Real-time syncing from your application**

Keep contacts synchronized with your application database.

* RESTful API endpoints
* Webhook support
* Automatic updates
  {% endtab %}

{% tab title="Third-party Integrations" %}
**Connect your favorite tools**

Seamlessly integrate with your existing workflow.

* Zapier automation
* Make.com scenarios
* n8n workflows
  {% endtab %}
  {% endtabs %}

## Important considerations

{% hint style="warning" %}
**Consent requirements:**

You must have explicit consent from recipients before adding them to marketing campaigns. Mailtrap requires confirmation of consent during the import process.
{% endhint %}

{% hint style="info" %}
**Subscription management:**

Once a contact unsubscribes, they cannot be manually resubscribed. They must sign up for your list again to receive marketing emails.
{% 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://docs.mailtrap.io/email-marketing/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.