HubSpot · api · fg-0388

HubSpot GET contact by email returns 404 even though the contact exists

404 from /crm/v3/objects/contacts/jane@example.com

Verified 2026-10-15 · Confirmed by 0 builders · Trust 50/100

Cause

The object path segment is treated as the record id unless idProperty=email is passed. Batch upsert keyed on email also does not support partial upserts.

Fix

Pass idProperty=email on single and batch reads, and for upserts that only touch some properties use a custom unique property as the key.

Apply

await client.crm.contacts.basicApi.getById(email, ['email','firstname'], undefined, undefined, false, 'email');

Affects: HubSpot CRM contacts v3; getById signature as in @hubspot/api-client 14.0.1, as of 2026-10

Sources

Have your agent know this before it fails

claude mcp add --transport http footgun https://getfootgun.com/api/mcp