Managing 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

POST https://api.mailofly.com/api/contacts
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

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

Scheduling and audience Delete Contact Importing Email types Event types

⌘I