Account & Settings
App Management
Authentication
Automation
CMS
Communication preferences
Conversations
CRM
- CRM embed
- Search the CRM
- Understanding the CRM
- Using object APIs
- API Guide
- POSTCreate a contact
- GETRetrieve a contact
- GETRetrieve contacts
- POSTMerge two contacts
- PATCHUpdate a contact
- DELArchive a contact
- GETGet Lifecycle Stage metrics for Contacts
- GETGet a contact by email address
- GETGet a batch of contacts by email address
- GETGet a batch of contacts by user token
- GETGet Contact Statistics
- GETGet a contact by its user token
- GETGet a batch of contacts by vid
- GETGet a contact by vid
- GETGet all contacts
- GETGet recently created contacts
- GETGet recently updated and created contacts
- GETSearch for contacts by email
- DELDelete a secondary email address
- PATCHCreate a new contact
- POSTCreate or update a group of contacts
- POSTCreate or update a contact by email
- POSTUpdate an existing contact by email
- POSTMerge contacts
- POSTCreate a new contact
- POSTUpdate a contact by vid
- GETSearch for contacts by email, name, phone number, or company
- PATCHCreate a new contact
- PUTUpdate a secondary email address
- PUTUpdate a secondary email address
- POSTCreate or update a group of contacts
- DELDelete a contact
- DELDelete a secondary email address
Events
Files
Marketing
Reporting
Scheduler
Create or update a contact by email
curl --request POST \
--url https://api.hubapi.com/contacts/v1/contact/createOrUpdate/email/{contact_email} \
--header 'Content-Type: application/json' \
--data '
{
"properties": [
{
"property": "<string>",
"value": "<string>"
}
]
}
'{
"vid": 3234574,
"isNew": false
}v1
Create or update a contact by email
The create or update a contact endpoint is used to create a new HubSpot contact or update an existing one. Use case for this endpoint: This method is useful when syncing changes to contacts in other CRMs with your HubSpot contacts.
POST
/
contacts
/
v1
/
contact
/
createOrUpdate
/
email
/
{contact_email}
Create or update a contact by email
curl --request POST \
--url https://api.hubapi.com/contacts/v1/contact/createOrUpdate/email/{contact_email} \
--header 'Content-Type: application/json' \
--data '
{
"properties": [
{
"property": "<string>",
"value": "<string>"
}
]
}
'{
"vid": 3234574,
"isNew": false
}Documentation Index
Fetch the complete documentation index at: https://developers.hubspot.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
Scope requirements
Scope requirements
Path Parameters
The email address of the contact to create or update.
Body
application/json
List of contact properties for the new contact.
Show child attributes
Show child attributes
Response
200 - application/json
Successful response - The create or update a contact endpoint is used to create a new HubSpot contact or update an existing one
The response is of type object.
Last modified on March 30, 2026
Was this page helpful?
⌘I
Assistant
Responses are generated using AI and may contain mistakes.