# Get contact by email api/v3

**URL:** <https://community.hubspot.com/t/get-contact-by-email-api-v3/41077>\
**Category:** HubSpot Ideas\
**Tags:** object\
**Created:** [July 21, 2021, 2:19pm UTC](https://community.hubspot.com/t/get-contact-by-email-api-v3/41077 "2021-07-21T14:19:11Z")\
**Posts on this page:** 11\
**Page:** 1

<div class="post-metadata">

**Author:** ![vcheloudiakof](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/vcheloudiakof/32/9373_2.png) [@vcheloudiakof](https://community.hubspot.com/u/vcheloudiakof)\
**Post date:** [July 21, 2021, 2:19pm UTC](https://community.hubspot.com/t/get-contact-by-email-api-v3/41077/1 "2021-07-21T14:19:11Z")

</div>

I can get contact by email using API v1, but couldn’t find any way to do so via v3.  
Is there a solution ?

---

<div class="post-metadata">

**Author:** ![CSwart](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/cswart/32/60590_2.png) [@CSwart](https://community.hubspot.com/u/CSwart)\
**Post date:** [September 9, 2021, 6:36pm UTC](https://community.hubspot.com/t/get-contact-by-email-api-v3/41077/2 "2021-09-09T18:36:06Z")

</div>

I am having some trouble with this as well have you solved the issue?

---

<div class="post-metadata">

**Author:** ![vcheloudiakof](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/vcheloudiakof/32/9373_2.png) [@vcheloudiakof](https://community.hubspot.com/u/vcheloudiakof)\
**Post date:** [October 8, 2021, 11:19am UTC](https://community.hubspot.com/t/get-contact-by-email-api-v3/41077/3 "2021-10-08T11:19:00Z")

</div>

I did not find any solutions..

---

<div class="post-metadata">

**Author:** ![CBN](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/cbn/32/95196_2.png) [@CBN](https://community.hubspot.com/u/CBN)\
**Post date:** [December 18, 2021, 10:09pm UTC](https://community.hubspot.com/t/get-contact-by-email-api-v3/41077/4 "2021-12-18T22:09:16Z")

</div>

Support this one from 2018: [https://community.hubspot.com/t5/HubSpot-Ideas/Find-Contacts-with-Multiple-Email-Addresses/idi-p/194773](https://community.hubspot.com/t5/HubSpot-Ideas/Find-Contacts-with-Multiple-Email-Addresses/idi-p/194773)

---

<div class="post-metadata">

**Author:** ![digs](https://avatars.discourse-cdn.com/v4/letter/d/a698b9/32.png) [@digs](https://community.hubspot.com/u/digs)\
**Post date:** [July 12, 2022, 11:02pm UTC](https://community.hubspot.com/t/get-contact-by-email-api-v3/41077/5 "2022-07-12T23:02:09Z")

</div>

I finally managed to get this to work. If you look at their description under contacts: [Accounts Dashboard | HubSpot](https://developers.hubspot.com/docs/api/crm/contacts) it says the following:

“The idProperty query parameter doesn’t appear on the Endpoints tab due to technical limitations, but it can be used for contacts exclusively with email. To use an email address as the unique identifier, set the idProperty as email and enter the email address in place of the contact ID. This should be set as a query parameter rather than added to the request body.”

so the url request would be:

[https://api.hubapi.com/crm/v3/objects/contacts/](https://api.hubapi.com/crm/v3/objects/contacts/) + email\_address + ?idProperty=email

---

<div class="post-metadata">

**Author:** ![CBN](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/cbn/32/95196_2.png) [@CBN](https://community.hubspot.com/u/CBN)\
**Post date:** [July 20, 2022, 3:17pm UTC](https://community.hubspot.com/t/get-contact-by-email-api-v3/41077/6 "2022-07-20T15:17:02Z")

</div>

Thanks @digs - I will try this later today as we do have customers with multiple emails and we want to find the correct contact no matter which email they use.

---

<div class="post-metadata">

**Author:** ![MBrien](https://avatars.discourse-cdn.com/v4/letter/m/ce7236/32.png) [@MBrien](https://community.hubspot.com/u/MBrien)\
**Post date:** [September 16, 2022, 10:41am UTC](https://community.hubspot.com/t/get-contact-by-email-api-v3/41077/7 "2022-09-16T10:41:14Z")

</div>

Also looking to solve this but with the ruby client [GitHub - HubSpot/hubspot-api-ruby: HubSpot API Ruby Client Libraries for V3 version of the API · GitHub](https://github.com/HubSpot/hubspot-api-ruby) - anyone else been able to use this for fetching a contact by email?

---

<div class="post-metadata">

**Author:** ![BThapa2](https://avatars.discourse-cdn.com/v4/letter/b/a587f6/32.png) [@BThapa2](https://community.hubspot.com/u/BThapa2)\
**Post date:** [September 19, 2022, 9:00pm UTC](https://community.hubspot.com/t/get-contact-by-email-api-v3/41077/8 "2022-09-19T21:00:04Z")

</div>

@MBrien this worked for me

```lia-code-sample
 client = Hubspot::Client.new
 client.get_by_id('test@email.com', {archived: false, id_property: 'email'})

```

---

<div class="post-metadata">

**Author:** ![PaulOomple](https://avatars.discourse-cdn.com/v4/letter/p/898d66/32.png) [@PaulOomple](https://community.hubspot.com/u/PaulOomple)\
**Post date:** [November 11, 2022, 9:20pm UTC](https://community.hubspot.com/t/get-contact-by-email-api-v3/41077/9 "2022-11-11T21:20:21Z")

</div>

Since they keep messing with their code, here’s what I’ve found works with version 15.0.1 of the gem

```lia-code-sample
# In initializer
$hubspot = Hubspot::Client.new(access_token: ENV['HUBSPOT_ACCESS_TOKEN'])

# Find contact by email. Normally from a model 
email = 'test@test.com' 
hs_contact = $hubspot.crm.contacts.basic_api.get_by_id(contact_id: email, id_property: 'email', archived: false) rescue nil

```

---

<div class="post-metadata">

**Author:** ![ASingla5](https://avatars.discourse-cdn.com/v4/letter/a/97f17d/32.png) [@ASingla5](https://community.hubspot.com/u/ASingla5)\
**Post date:** [December 1, 2023, 10:04am UTC](https://community.hubspot.com/t/get-contact-by-email-api-v3/41077/10 "2023-12-01T10:04:40Z")

</div>

To get more new clients

---

<div class="post-metadata">

**Author:** ![ASingla5](https://avatars.discourse-cdn.com/v4/letter/a/97f17d/32.png) [@ASingla5](https://community.hubspot.com/u/ASingla5)\
**Post date:** [December 1, 2023, 10:06am UTC](https://community.hubspot.com/t/get-contact-by-email-api-v3/41077/11 "2023-12-01T10:06:36Z")

</div>

By preparing them to reach
