topic Re: How to retrieve a contact's user token through Contacts API? in APIs & Integrations

How to retrieve a contact's user token through Contacts API?

bblatnick — Tue, 16 Aug 2016 22:17:16 GMT

I have a contact’s vid and I wish to get the user token associated that contact record. What’s the best way to achieve this? The GET /contacts/v1/contact/vid/:contact_id/profile endpoint seems to not return the contact’s usertoken in the response.

Re: How to retrieve a contact's user token through Contacts API?

Dadams — Wed, 17 Aug 2016 18:03:24 GMT

Hi @bblatnick

The usertokens (it’s possible for more than one token to be associated with a contact) don’t show up in the data for the contact, and we don’t currently have a way to look those up.

Can you tell me what you’d want to use the uerstoken for?

Re: How to retrieve a contact's user token through Contacts API?

bblatnick — Wed, 17 Aug 2016 18:34:45 GMT

I see. I want to identify known vs unknown Hubspot visitors coming to my website which means I’d need to know each contact’s user token or tokens. The API seems a bit misleading because the usertoken is returned as a property in http://developers.hubspot.com/docs/methods/contacts/get_contact_by_utk.

Is there any plans to be able to look up user tokens for contacts in the future?

Re: How to retrieve a contact's user token through Contacts API?

Dadams — Wed, 17 Aug 2016 19:11:30 GMT

That endpoint won’t return the utk, it only uses the utk to look up a contact record. That endpoint actually sounds like it would do what you’re looking to do. When a visitor hits your site, you can grab the hubspotutk cookie (which gets created by the HubSpot tracking code) from that visitor, and then use that endpoint to see if there’s a contact associated with that cookie. If you get a 404, or a response that includes "is-contact": false then the cookie is not associated with a contact.

Re: How to retrieve a contact's user token through Contacts API?

bblatnick — Mon, 05 Mar 2018 20:14:53 GMT

Has anything changed in this regard? I know there has been some changes to the API since I asked this question last.

Re: How to retrieve a contact's user token through Contacts API?

Derek_Gervais — Tue, 06 Mar 2018 20:20:00 GMT

Hi @bblatnick,

It's not currently possible to look up a contact's usertoken(s). The best method to identify known contacts is still to make a call to the 'Get a contact by usertoken' endpoint and look for the "is-contact" field.

Re: How to retrieve a contact's user token through Contacts API?

nflaherty — Fri, 17 Aug 2018 13:47:18 GMT

Hi @Derek_Gervais, has anything changed with regard to looking up a contact's (or a batch of contacts') usertoken(s) programmatically?

Here is our use case: we would like to send a users' usertoken up to google analytics as the userid. Then, we'd like to pull hubspot contacts and google analytics page view and event data down into a data warehouse and associate the two. With this, we will know the complete visitor journey, and be able to map it all the way down the funnel past conversion.

Re: How to retrieve a contact's user token through Contacts API?

Derek_Gervais — Wed, 22 Aug 2018 20:11:33 GMT

Hi @nflaherty,

There aren't any updates on this that I'm aware of. I can totally see the use case you're describing, though; If you have the inclination, I would encourage you to check out the Ideas Forum on the HubSpot Community. There, you can create a post including your use case that product and other customers can see.

Re: How to retrieve a contact's user token through Contacts API?

arielledesma — Mon, 01 Jul 2019 20:15:28 GMT

Has there been an update to this?

I have a ton of GA data with hubspotutk, and I want to get this data tied to our Hubspot dataset.

Re: How to retrieve a contact's user token through Contacts API?

Kaitos — Tue, 26 Mar 2024 22:54:27 GMT

The v1 docs made this possible. Is it still possible with the V3?

Docs: https://legacydocs.hubspot.com/docs/methods/contacts/get_contact_by_utk

Re: How to retrieve a contact's user token through Contacts API?

Jaycee_Lewis — Wed, 27 Mar 2024 16:52:19 GMT

Hey, @Kaitos You linked to the correct endpoint. Legacy endpoints are stable and supported. There is not a v3 equivalent of this specific endpoint.

Best,

Jaycee