Mailmodo · Schema

Mailmodo Contact

A subscriber profile stored on a Mailmodo workspace, with list membership, subscription state, and custom attributes used for AMP-for-Email personalization and journey segmentation.

EmailInteractive EmailAMP for EmailMarketing AutomationTransactional EmailCampaignsJourneysCustomer Engagement

Properties

Name	Type	Description
email	string	Primary identifier for the contact.
firstName	string
lastName	string
subscriptionStatus	string	Lifecycle state across the workspace.
lists	array	Named lists the contact belongs to.
data	object	Workspace-defined custom attributes.
createdAt	string
updatedAt	string

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/mailmodo/refs/heads/main/json-schema/mailmodo-contact-schema.json",
  "title": "Mailmodo Contact",
  "description": "A subscriber profile stored on a Mailmodo workspace, with list membership, subscription state, and custom attributes used for AMP-for-Email personalization and journey segmentation.",
  "type": "object",
  "required": ["email"],
  "properties": {
    "email": {
      "type": "string",
      "format": "email",
      "description": "Primary identifier for the contact."
    },
    "firstName": { "type": "string" },
    "lastName": { "type": "string" },
    "subscriptionStatus": {
      "type": "string",
      "enum": ["subscribed", "unsubscribed", "bounced", "archived"],
      "description": "Lifecycle state across the workspace."
    },
    "lists": {
      "type": "array",
      "items": { "type": "string" },
      "description": "Named lists the contact belongs to."
    },
    "data": {
      "type": "object",
      "additionalProperties": true,
      "description": "Workspace-defined custom attributes."
    },
    "createdAt": { "type": "string", "format": "date-time" },
    "updatedAt": { "type": "string", "format": "date-time" }
  },
  "additionalProperties": false
}