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

# Contacts

> Create, update, search, and manage individual subscriber profiles.

# Contacts

Learn how to create, update, search, and delete contacts in Mailofly.

***

## Contact Schema

| Field          | Type    | Description                                               |
| :------------- | :------ | :-------------------------------------------------------- |
| `id`           | string  | Unique contact identifier (`cnt_...`).                    |
| `email`        | string  | Validated email address (unique per organization).        |
| `first_name`   | string  | Optional first name.                                      |
| `last_name`    | string  | Optional last name.                                       |
| `unsubscribed` | boolean | Whether the contact has opted out of marketing campaigns. |
| `properties`   | object  | Arbitrary key-value dictionary of custom metadata.        |
| `created_at`   | string  | ISO-8601 creation timestamp.                              |

***

## Adding Contacts via the API

```http theme={null}
POST https://api.mailofly.com/api/contacts
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json
```

```typescript theme={null}
import { Mailofly } from "mailofly";

const mailofly = new Mailofly("mfly_live_your_api_key");

const { data, error } = await mailofly.contacts.create({
  email: "sarah@acme.com",
  first_name: "Sarah",
  last_name: "Connor",
  properties: {
    plan: "pro",
    company: "Skynet",
    mrr: 299,
  },
});
```

***

## Deleting Contacts

Deleting a contact permanently removes their profile and properties from your audience. If the contact had previously unsubscribed, their email address remains recorded on the global suppression list to prevent accidental resubscription.


## Related topics

- [Create Contact](/api/contacts/create-contact.md)
- [Delete Contact](/api/contacts/delete-contact.md)
- [List Contacts](/api/contacts/list-contacts.md)
- [Retrieve Contact](/api/contacts/get-contact.md)
- [Migration Guide](/audience/migration-guide.md)