HubSpot APIs
Account Request URL
https://developers.hubspot.com/get-startedBase Endpoint
https://developers.hubspot.com/docs/api/overview
Contacts
Retrieve a contact by ID.
/contacts/v1/contact/vid/{contactId}
contactId
Contacts
Lists all contacts in HubSpot.
/contacts/v1/contacts/all
category, excludeProperties, includeProperties, orderBy, limit, property, startAfterId, deletedFilterType, showHidden, archivedFilterType
Contacts
Creates a new contact.
/contacts/v1/contact
associatedCompanyIds, email, firstName, lastName, website, address, city, state, zip, country, phone, fax, mobile, jobTitle, notes, properties
Contacts
Replaces the properties of a contact.
/contacts/v1/contact/vid/{contactId}
contactId, associatedCompanyIds, email, firstName, lastName, website, address, city, state, zip, country, phone, fax, mobile, jobTitle, notes, properties
Contacts
Partially updates the properties of a contact.
/contacts/v1/contact/vid/{contactId}
contactId, properties
Companies
Retrieve a company by ID.
/companies/v2/companies/{companyId}
companyId
Companies
Creates a company.
/companies/v2/companies
address, annualRevenue, city, country, description, domain, industry, name, numberOfEmployees, parentCompanyId, phone, state, tickerSymbol, website
Companies
Replaces the properties of a company.
/companies/v2/companies/{companyId}
companyId, address, annualRevenue, city, country, description, domain, industry, name, numberOfEmployees, parentCompanyId, phone, state, tickerSymbol, website
Companies
Partially updates the properties of a company.
/companies/v2/companies/{companyId}
companyId, properties
Deals
Retrieve a deal by ID.
/deals/v1/deal/{dealId}
dealId
Deals
Lists all deals in HubSpot.
/deals/v1/deals/all
archivedFilterType, closedDateFilterType, closedDealFilterType, dealstageFilterType, excludeProperties, includeProperties, orderBy, limit, property, startAfterId, statusFilterType, wonDealFilterType
Deals
Creates a new deal.
/deals/v1/deal
dealName, amount, closeDate, stageId, properties, pipelineId
Deals
Replaces the properties of a deal.
/deals/v1/deal/{dealId}
dealId, dealName, amount, closeDate, stageId, properties, pipelineId
Deals
Partially updates the properties of a deal.
/deals/v1/deal/{dealId}
dealId, properties
Engagements
Retrieve a list of engagements associated with a contact.
/engagements/v1/engagements/contact/{contactId}
contactId
Engagements
Retrieve a list of engagements associated with a company.
/engagements/v1/engagements/company/{companyId}
companyId
Engagements
Retrieve a list of engagements associated with a deal.
/engagements/v1/engagements/deal/{dealId}
dealId
Engagements
Retrieve a list of engagements associated with a ticket.
/engagements/v1/engagements/ticket/{ticketId}
ticketId
Engagements
Retrieve a specific engagement by ID.
/engagements/v1/engagements/{engagementId}
engagementId
Engagements
Retrieve the most recent engagement associated with a contact
a company
a deal
Events
Retrieve a list of events associated with a contact.
/events/v3/events/contact/{contactId}
contactId
Events
Retrieve a list of events associated with a company.
/events/v3/events/company/{companyId}
companyId
Events
Retrieve a list of events associated with a deal.
/events/v3/events/deal/{dealId}
dealId
Events
Retrieve a list of events associated with a ticket.
/events/v3/events/ticket/{ticketId}
ticketId
Events
Retrieve a list of events associated with an owner.
/events/v3/events/owner/{ownerId}
ownerId
Events
Retrieve a list of events in a date range with optional filtering.
/events/v3/events
startDateTime, endDateTime, hs_event_type, eventTypeId, eventTypeFilterType, category, limit, property, associationsFilter, orderBy, after, includeDeleted
Events
Creates a new event.
/events/v3/events
objectId, objectType, eventTypeId, eventTypeFilterType, category, subject, startDate, endDate, location, duration, hs_event_status, hs_event_outcome, description, associations
Events
Replaces the properties of an event.
/events/v3/events/{eventId}
eventId, objectId, objectType, eventTypeId, eventTypeFilterType, category, subject, startDate, endDate, location, duration, hs_event_status, hs_event_outcome, description, associations
Events
Partially updates the properties of an event.
/events/v3/events/{eventId}
eventId, properties
Files
Retrieve an individual file.
/files/v3/files/{fileId}
fileId
Files
Retrieve all the files associated with a contact.",/files/v3/files/contacts/{contactId},contactId Files,GET,Retrieve all the files associated with a company."
/files/v3/files/companies/{companyId}
companyId
Files
Retrieve all the files associated with a deal.",/files/v3/files/deals/{dealId},dealId Files,GET,Retrieve all the files associated with a ticket."
/files/v3/files/tickets/{ticketId}
ticketId
Forms
Lists all forms
public forms
or forms accessible to the current user.
Forms
Retrieve a form by ID.
/forms/v2/forms/{formId}
formId
Forms
Creates a form.
/forms/v2/forms
portalId, name, redirectUri, formSource, headerBackgroundImage, footerBackgroundColor, submitText, submitBgColor, submitTextColor, cancelText, cancelBgColor, cancelTextColor, disclaimerContent, thankYouMessage, confirmationEmail, customHtml, css, javascript, bodyBackgroundColor, bodyTextFont, buttonFont, headerTextFont, submitButtonStyle, submitHeight, submitWidth, captcha, emailFieldLabel, privacyPolicyLabel, legalConsentLabel, submitPayment, recaptchaSiteKey, recaptchaSecretKey, useRecaptcha, embedded, defaultValues, metaDescription, metaKeywords, metaTitle, submitButtonBorderColor, submitButtonBorderWidth, submitButtonTextColor
Forms
Replaces the properties of a form.
/forms/v2/forms/{formId}
formId, portalId, name, redirectUri, formSource, headerBackgroundImage, footerBackgroundColor, submitText, submitBgColor, submitTextColor, cancelText, cancelBgColor, cancelTextColor, disclaimerContent, thankYouMessage, confirmationEmail, customHtml, css, javascript, bodyBackgroundColor, bodyTextFont, buttonFont, headerTextFont, submitButtonStyle, submitHeight, submitWidth, captcha, emailFieldLabel, privacyPolicyLabel, legalConsentLabel, submitPayment, recaptchaSiteKey, recaptchaSecretKey, useRecaptcha, embedded, defaultValues, metaDescription, metaKeywords, metaTitle, submitButtonBorderColor, submitButtonBorderWidth, submitButtonTextColor
Forms
Partially updates the properties of a form.
/forms/v2/forms/{formId}
formId, properties
Forms
Lists all forms
public forms
or forms accessible to the current user.
Journeys
Retrieve a journey by ID.
/marketing/v3/journeys/{journeyId}
journeyId
Journeys
Lists all journeys in HubSpot.
/marketing/v3/journeys/all
archivedFilterType, pipelineId, includeDeleted, limit, property, startAfterId, orderBy
Journeys
Creates a new journey.
/marketing/v3/journeys
name, fromName, workflows, sequences, pipelineId, startNode, stopNode, initialDelay, timezone,
Journeys
Replaces the properties of a journey.
/marketing/v3/journeys/{journeyId}
journeyId, name, fromName, workflows, sequences, pipelineId, startNode, stopNode, initialDelay, timezone,
Journeys
Partially updates properties on a journey.
/marketing/v3/journeys/{journeyId}
journeyId, properties
Leads
Retrieve a lead by ID.
/leads/v2/lead/{leadId}
leadId
Leads
Lists all leads in HubSpot.
/leads/v2/leads/all
archivedFilterType, excludeProperties, includeProperties, orderBy, limit, property, startAfterId, deletedFilterType, showHidden, recentFilterType, moreRecentThanDays, createdateFilterType, createdAfterTimestamp, createdAtFilterType, createdBeforeTimestamp, updateAtFilterType, updatedAtFilterType, updatedAfterTimestamp, updatedBeforeTimestamp
Leads
Creates a new
Details
Provider
Country HQ
API Type
Categories
Alternatives
Important URLs
Last Updated on
Created At
Other Apps
Upskill for a better future
Want to start tracking API at scale?
Get updates about your favorite APIs and SDKs
We do our best to ensure that the data we release is complete, accurate, and useful. However, because we are not able to verify all the data, and because the processing required to make the data useful is complex, we cannot be held liable for omissions or inaccuracies.
