CRM

HubSpot — data contract (compatible with HubSpot’s documented schema; not affiliated with HubSpot)

Name: HubSpot data contract
Creator: DataContractGate
License: https://opensource.org/licenses/MIT

HubSpot CRM contact — default properties from the Contacts API / export. Compatible with HubSpot's documented default contact properties; not affiliated with HubSpot. Lifecycle stages listed here are the defaults; newer accounts can define their own.

Validate a client's HubSpot export at ingest into your warehouse, or with POST /egress before sending the same shape to a partner, reverse ETL, or an AI agent.

Download YAML

Also available: ODCS v3.1.0 YAML. “Use this contract” forks it into your org, then opens the validation playground so you can upload the client file.

Fields

Name	Type	Required	Rule	Description
id	string	required	pattern /^[0-9]+$/	HubSpot record id for the contact.
email	string	optional	email format	—
firstname	string	optional	—	—
lastname	string	optional	—	—
phone	string	optional	—	—
company	string	optional	—	—
lifecyclestage	string	optional	one of: subscriber, lead, marketingqualifiedlead, salesqualifiedlead, opportunity, customer, evangelist, other	The contact's stage in the marketing/sales lifecycle. The allowed values are HubSpot's default stages. Newer accounts can define their own stages; those values will not match until this list is edited.
hs_object_id	string	optional	pattern /^[0-9]+$/	—
createdate	timestamp	optional	—	Timestamp when the contact was created.
lastmodifieddate	timestamp	optional	—	—

Sample rows

Three synthetic rows we wrote. They validate against this contract with zero violations. No real customer data.

[
  {
    "company": "Example Co",
    "createdate": "2026-01-05T10:00:00Z",
    "email": "contact@example.com",
    "firstname": "Alex",
    "hs_object_id": "101",
    "id": "101",
    "lastmodifieddate": "2026-01-20T14:30:00Z",
    "lastname": "Sample",
    "lifecyclestage": "lead",
    "phone": "555-0100"
  },
  {
    "company": "Acme Test LLC",
    "createdate": "2026-01-06T08:15:00Z",
    "email": "jordan@example.org",
    "firstname": "Jordan",
    "hs_object_id": "102",
    "id": "102",
    "lastmodifieddate": "2026-01-21T09:00:00Z",
    "lastname": "Test",
    "lifecyclestage": "customer"
  },
  {
    "createdate": "2026-01-07T12:45:00Z",
    "email": "casey@example.net",
    "firstname": "Casey",
    "hs_object_id": "103",
    "id": "103",
    "lastname": "Demo",
    "lifecyclestage": "subscriber",
    "phone": "555-0177"
  }
]

Provenance

Verified against: https://developers.hubspot.com/docs/api-reference/latest/crm/objects/contacts/guide
Checked: 2026-11-06
Version: v1.0
Author: DataContractGate
License: MIT

Spotted a mismatch with the vendor’s current schema? Report an issue.

Stripe, Shopify, QuickBooks, Xero, HubSpot, Salesforce, Google Analytics and Square are trademarks of their respective owners. DataContractGate is not affiliated with or endorsed by them. These contracts describe data shaped like these vendors’ documented schemas; they are not official and are not certified by any vendor.