APIs & Integrations

mlacruz
Member

Integration [New Apis/Legacy]

Hello, I am currently starting with the integration of my external api with hubspot to keep certain contact properties up to date.

 

That is what I want to do:

I need to update some contact properties by email from my external api

 

1.- I'm testing the new hubspot api to update a contact's properties, I need to get the contactId and then the update, but for that I have to call the hubspot api 2 times. I tried postman and ruby sdk and it works, but I don't know if it is right, Is it the right way in the new api?

POST
/crm/v3/objects/contacts/search
PATCH
/crm/v3/objects/contacts/{contactId}


2.- I'm testing the legacy api to update a contact's properties, in this api there is 1 endpoint that allows me to update the contact's properties by email.

POST /contacts/v1/contact/email/:email/profile

 

My question:

Which of the two ways is it recommended to use?

 

Thank you.

 

0 Upvotes
1 Reply 1
dennisedson
HubSpot Product Team
HubSpot Product Team

Integration [New Apis/Legacy]

Hi @mlacruz ,

You should be able to safely use the v1 endpoint.  Eventually, I believe its equivalent will be included in the v3, but not sure what the timeline is on that. 

You will be given ample time if that v1 endpoint is deprecated.  I do not forsee that happening for some time.

0 Upvotes