> ## Documentation Index
> Fetch the complete documentation index at: https://docs.autosend.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Contacts

> Manage your email contacts, organize them into lists and segments, and personalize your emails.

export const APP_PATHS = {
  home: '/',
  quickstart: '/quickstart',
  domainConfiguration: '/domain',
  apiReference: '/api-reference',
  sendEmail: '/api-reference/mails/send',
  bulkSendEmail: '/api-reference/mails/bulk',
  upsertContactApiRef: '/api-reference/contacts/upsert-contact',
  transactional: '/transactional-emails',
  emailActivity: '/transactional-emails/email-activity',
  emailTemplates: '/transactional-emails/email-templates',
  sendingEmail: '/quickstart/email-using-api',
  transactionalTroubleshooting: '/transactional-emails/troubleshooting',
  marketing: '/marketing-emails',
  campaigns: '/marketing-emails/campaigns',
  contacts: '/marketing-emails/contacts',
  contactsIntroduction: '/marketing-emails/contacts/introduction',
  contactsImportCsv: '/marketing-emails/contacts/import-csv',
  contactsLists: '/marketing-emails/contacts/lists',
  contactsSegments: '/marketing-emails/contacts/segments',
  contactsCustomFields: '/marketing-emails/contacts/custom-fields',
  sender: '/marketing-emails/sender',
  unsubscribeGroups: '/others/unsubscribe-groups',
  webhookIntroduction: '/others/webhooks/introduction',
  webhookEventType: '/others/webhooks/event-type',
  webhookRetries: '/others/webhooks/retries',
  webhookVerifyRequests: '/others/webhooks/verify-requests',
  dynamicTemplates: '/dynamic-templates',
  guides: '/guides',
  sitemap: '/sitemap.xml',
  team: '/others/team',
  automations: '/automations',
  smtpIntroduction: '/quickstart/smtp',
  betterAuth: '/guides/better-auth',
  templateVariables: '/transactional-emails/variables',
  suppressions: '/others/suppressions',
  rateLimit: '/api-reference/rate-limit',
  nodejsSdk: '/sdk/nodejs',
  smtpIntegrationGuides: '/guides/smtp',
  apiKeys: '/api-keys',
  apiReferenceIntroduction: '/api-reference/introduction',
  lovableGuide: '/ai/integrations/lovable',
  aiIntroduction: '/ai/introduction',
  aiSkills: '/ai/skills',
  aiMcpServer: '/ai/mcp-server',
  aiLovable: '/ai/integrations/lovable',
  aiBolt: '/ai/integrations/bolt',
  aiV0: '/ai/integrations/v0',
  aiReplit: '/ai/integrations/replit',
  mcpClaude: '/ai/mcp-clients/claude',
  mcpCursor: '/ai/mcp-clients/cursor',
  mcpCopilot: '/ai/mcp-clients/copilot',
  mcpWindsurf: '/ai/mcp-clients/windsurf',
  mcpCodex: '/ai/mcp-clients/codex',
  mcpAntigravity: '/ai/mcp-clients/antigravity',
  mcpChatgpt: '/ai/mcp-clients/chatgpt',
  mcpRaycast: '/ai/mcp-clients/raycast',
  domainWarmup: '/marketing-emails/domain-warmup',
  projects: '/projects',
  createAutomationApi: '/api-reference/automations/create-automation'
};

export const IMAGES = {
  logo: `${`https://dqy38fnwh4fqs.cloudfront.net/`}autosend/docs/autosend-docs-logo.png`,
  emailActivityHome: `${`https://dqy38fnwh4fqs.cloudfront.net/`}autosend/docs/email-activity-home.png`,
  emailActivityClicks: `${`https://dqy38fnwh4fqs.cloudfront.net/`}autosend/docs/email-activity-clicks.png`,
  emailTemplate: {
    testData: `${`https://dqy38fnwh4fqs.cloudfront.net/`}autosend/docs/test-data.png`,
    emailPreview: `${`https://dqy38fnwh4fqs.cloudfront.net/`}autosend/docs/email-preview.png`,
    creatingEmailTemplate: `${`https://dqy38fnwh4fqs.cloudfront.net/`}autosend/docs/create-email-template.png`,
    sendingTestEmail: `${`https://dqy38fnwh4fqs.cloudfront.net/`}autosend/docs/send-test-email.png`
  },
  addSender: `${`https://dqy38fnwh4fqs.cloudfront.net/`}autosend/docs/add-sender.png`,
  createList: `${`https://dqy38fnwh4fqs.cloudfront.net/`}autosend/docs/create-list.png`,
  createSegment: `${`https://dqy38fnwh4fqs.cloudfront.net/`}autosend/docs/create-segment.png`,
  contacts: `${`https://dqy38fnwh4fqs.cloudfront.net/`}autosend/docs/contacts.png`,
  allContacts: `${`https://dqy38fnwh4fqs.cloudfront.net/`}autosend/docs/all-contacts.png`,
  contactDetails: `${`https://dqy38fnwh4fqs.cloudfront.net/`}autosend/docs/contact-details.png`,
  csvContactDetails: `${`https://dqy38fnwh4fqs.cloudfront.net/`}autosend/docs/csv-contact-details.png`,
  importCsv: `${`https://dqy38fnwh4fqs.cloudfront.net/`}autosend/docs/import-csv.png`,
  importSuccess: `${`https://dqy38fnwh4fqs.cloudfront.net/`}autosend/docs/import-successful.png`,
  mapFields: `${`https://dqy38fnwh4fqs.cloudfront.net/`}autosend/docs/map-fields.png`,
  listContactDetails: `${`https://dqy38fnwh4fqs.cloudfront.net/`}autosend/docs/list-contact-details.png`,
  createList: `${`https://dqy38fnwh4fqs.cloudfront.net/`}autosend/docs/create-list.png`,
  listDetails: `${`https://dqy38fnwh4fqs.cloudfront.net/`}autosend/docs/list-details.png`,
  contactSegment: `${`https://dqy38fnwh4fqs.cloudfront.net/`}autosend/docs/contact-segment.png`,
  createSegment: `${`https://dqy38fnwh4fqs.cloudfront.net/`}autosend/docs/create-segment.png`,
  customFieldDetails: `${`https://dqy38fnwh4fqs.cloudfront.net/`}autosend/docs/custom-field-details.png`,
  newCustomField: `${`https://dqy38fnwh4fqs.cloudfront.net/`}autosend/docs/new-custom-field.png`,
  campaignsList: `${`https://dqy38fnwh4fqs.cloudfront.net/`}autosend/docs/campaigns-list.png`,
  campaignsEmpty: `${`https://dqy38fnwh4fqs.cloudfront.net/`}autosend/docs/campaigns-empty.png`,
  designCampaign: `${`https://dqy38fnwh4fqs.cloudfront.net/`}autosend/docs/design-campaign.png`,
  campaignDetails: `${`https://dqy38fnwh4fqs.cloudfront.net/`}autosend/docs/campaign-details.png`,
  reviewCampaign: `${`https://dqy38fnwh4fqs.cloudfront.net/`}autosend/docs/review-campaign.png`,
  campaignSuccess: `${`https://dqy38fnwh4fqs.cloudfront.net/`}autosend/docs/campaign-success.png`,
  testCampaign: `${`https://dqy38fnwh4fqs.cloudfront.net/`}autosend/docs/test-campaign.png`,
  sendTestCampaign: `${`https://dqy38fnwh4fqs.cloudfront.net/`}autosend/docs/send-test-campaign.png`
};

Contacts are the people you send emails to in AutoSend. Each contact has a unique email address and associated data like name, location, or any other information you’ve added through fields.

Contacts can be organized using **Lists** or **Segments** for better targeting.

<Frame>
  <img src={IMAGES.contacts} alt="Contacts" />
</Frame>

## All Contacts

The **All Contacts** list shows every contact you’ve ever added to your account.

<Frame>
  <img src={IMAGES.allContacts} alt="All Contacts" />
</Frame>

Contacts can come from:

* Manual additions
* Imported via CSV
* API integrations
* Sign-ups or form submissions

You can filter and search contacts, and view detailed insights for each.

## Contact Details

Clicking on any contact opens their **Contact Details** page, where you can view:

<Frame>
  <img src={IMAGES.contactDetails} alt="Contact Details" />
</Frame>

* **Details**: Basic information (email, name, etc.), Reserved and Custom Fields.
* **Lists & Segments**: All the lists and segments the contact belongs to
* **Unsubscribes:** The kind of emails a particular user has unsubscribed from.
* **Email Activity**: The email history of a particular user.

### Reserved Fields

Reserved fields are system-defined fields that AutoSend uses to store core contact information. You can’t rename or delete them.

| **Field**                | **Description**                                                                            |
| ------------------------ | ------------------------------------------------------------------------------------------ |
| email                    | The contact's primary email address. This field is required and unique for each contact.   |
| firstName                | The contact's first name. Often used for personalizing emails (e.g., Hey `{{firstName}}`). |
| first\_name              | The contact's first name. Often used for personalizing emails (e.g., Hey `{{firstName}}`). |
| lastName                 | The contact's last name.                                                                   |
| last\_name               | The contact's last name.                                                                   |
| mobile                   | The contact's mobile phone number.                                                         |
| unsubscribe              | Boolean indicating if the contact has unsubscribed from all emails.                        |
| unsubscribed             | Boolean indicating if the contact has unsubscribed from all emails.                        |
| unsubscribe\_groups      | Array of specific email groups/categories the contact has unsubscribed from.               |
| unsubscribe\_preferences | Object containing detailed unsubscribe preferences for different email types.              |
| userId                   | Your internal user ID for tracking contacts across your systems.                           |
| externalId               | External identifier from third-party integrations or CRM systems.                          |
| createdAt                | Timestamp when the contact was first added to AutoSend.                                    |
| updatedAt                | Timestamp when the contact was last modified.                                              |
| contactLists             | Array of list IDs that this contact belongs to.                                            |
| address                  | The contact's full address (single field).                                                 |
| address\_line\_1         | First line of the contact's address (street address).                                      |
| address\_line\_2         | Second line of the contact's address (apartment, suite, etc.).                             |
| city                     | The contact's city.                                                                        |
| state                    | The contact's state or province.                                                           |
| zip                      | The contact's postal or ZIP code.                                                          |
| country                  | The contact's country.                                                                     |

### Custom Fields

<a href={APP_PATHS.contactsCustomFields} title="Custom fields">Custom fields</a> let you store additional information beyond the reserved ones — for example, “Company,” “Plan Type,” or “Signup Date.”

They can be text, number, or date fields

You can use these in both **marketing campaigns** and **transactional emails** to personalize your content using variables like `{{custom_field_name}}`.