Filter contacts by id

Develop, Build & Integrate APIs & Integrations
, , ,
1

Hello everyone,
I am trying to filter/get a contact using the endpoint
POST/crm/v3/objects/contacts/search

I am building the request like that:

{
 "filters": [
 {
 "operator": "EQ",
 "propertyName": "id",
 "value": "7951"
 }
 ]
}

However, this returns an error like

{
 "status": "error",
 "message": "There was a problem with the request.",
 "correlationId": "a517c46c-c5ec-4057-8cdd-03954b3d6fbe"
}

Some weeks ago, filtering by the id like that was working. Right now it is not.
Now changing the filter to consider another property, filtering by email for example, the request is well succeded. What is wrong? Can someone help me/w

2

Hello @kizus , thank you for writing!

For the CRM Search API, use hs_object_id to filter contacts by their HubSpot Record ID. The vid identifier comes from HubSpot’s older contact API conventions.

Moderator Note: this post was reviewed for relevancy and optimized for clarity on October 23, 2026. Thank you for your contributions to the HubSpot Community!

3

Hello @miljkovicmisa , thanks by your answer. I tested your suggestion and it really works.
I found out another way to filter by the contact id using the property hs_object_id, like that

{
 "filters": [
 {
 "operator": "EQ",
 "propertyName": "hs_object_id",
 "value": "7951"
 }
 ]
}

So thank you!