HubSpot Record IDs

Definition

A HubSpot Record ID is the unique numeric identifier HubSpot assigns to every record — each contact, company, deal and ticket. It never changes, making it the reliable key for imports, integrations, deduplication and matching records across systems.

Key takeaways

  • Every HubSpot record has a unique, permanent numeric Record ID.
  • It's the stable key for imports, integrations and deduplication.
  • Use it to match records reliably across systems.

Why the Record ID matters

Names and emails change; the Record ID doesn't. That permanence makes it the safest key for updating records on import, matching them in integrations, and deduplicating — because it can never collide or drift the way human-readable fields do.

Where you use it

  • Updating existing records on import (match by Record ID).
  • Mapping records between HubSpot and other systems.
  • Building reliable integrations and deduplication logic.

Frequently asked questions

What is a HubSpot Record ID?

The unique, permanent numeric identifier HubSpot assigns to every record, used as a reliable key across imports and integrations.

Does the HubSpot Record ID change?

No — it's assigned at creation and never changes, which is what makes it dependable for matching records.

How do I use the Record ID for imports?

Include it as a column and match on it, so HubSpot updates the existing record instead of creating a duplicate.

Related service: Get imports right in HubSpot

Related terms