Developers

API Docs
Changelog
Community
Get Featured
Create an Account

Overview
- API overview
- API usage guidelines
- Getting featured
- Working within API rate limits
- Check daily API usage
- Get account details
Developer Preview
- Developer preview overview
- Tickets API
- Products API
- Line Items API
- CRM Object Properties API
- CRM Associations API
Authentication
- Authentication overview
OAuth 2.0
- OAuth 2.0 overview
- OAuth 2.0 scopes
- Initiating an OAuth connection
- Get access and refresh tokens
- Refresh access token
- Get access token information
- Get refresh token information
- Delete refresh token
- Using OAuth 2.0 access tokens
FAQ
- FAQ overview
- Subscribing to API updates
- Testing the HubSpot APIs
- API error responses
- Timestamp formatting
- CORS / AJAX support
- vidOffset and timeOffset
- Getting all contact properties
- Multiple values for checkbox
- Manipulating forms with jQuery
- How do I send transactional emails?
- How are email addresses validated?
- Tracking lawful basis of processing in HubSpot
Using the developer tools
- Developer tools overview
- How do I create an app in HubSpot?
- Installing an app
- How do I create a test portal?
- Using app request monitoring
- Prerequisites for Integrations Platform API
Analytics API
- Analytics API Overview
- Get analytics data breakdowns
- Get analytics data for specific objects
- Get analytics data for HubSpot hosted content
Calendar API
- List content events
- List social events
- List task events
- List all events
- Create task
- Get task by ID
- Update task
- Delete task
Companies API
- Companies overview
- Create a company
- Update a company
- Update a group of companies
- Delete a company
- Get all companies
- Get recently modified companies
- Get recently created companies
- Search for companies by domain
- Get a company
- Get contacts of a company
- Get contacts IDs of a company
- Add contact to company
- Remove contact from company
Company Properties API
- Company properties overview
- Get all company properties
- Get a company property
- Create a company property
- Update a company property
- Delete a company property
- Get company property groups
- Create a company property group
- Update a company property group
- Delete a company property group
Contacts API
- Contacts overview
- Create a contact
- Update a contact
- Update a contact by email
- Create or update a contact
- Create or update a group of contacts
- Delete a contact
- Get all contacts
- Get recently modified contacts
- Get recently created contacts
- Get contact by ID
- Get group of contacts by ID
- Get contact by email
- Get group of contacts by email
- Get contact by user token
- Search for contacts
- Merge contacts
- Get lifecycle stage metrics for contacts
Contact Lists API
- Contact lists overview
- Create a contact list
- Get contact lists
- Get a contact list by ID
- Update a contact list
- Delete a contact list
- Get a group of contact lists
- Get static contact lists
- Get dynamic contact lists
- Get contacts in a list
- Get recently added contacts in a list
- Add contact to list
- Remove contact from list
Contact Properties API
- Contact properties overview
- Get all properties
- Get a contact property
- Create a new property
- Update a property
- Delete a property
- Get property groups
- Get property group details
- Create a property group
- Update a property group
- Delete a property group
COS Blog API
- List blogs
- Get a blog by ID
- List blog revisions
- Get a blog revision
COS Blog Authors API
- List blog authors
- Search blog authors
- Get blog author
- Create blog author
- Update blog author
- Delete blog author
COS Blog Comments API
- List comments
- Get comment
- Create new comment
- Delete comment
- Restore deleted comment
COS Blog Post API
- List blog posts
- Get a blog post by ID
- Create a new blog post
- Update the blog post
- Delete the blog post
- Clone the blog post
- Publish or unpublish a blog post
- Get the current contents of the auto-save buffer
- Update the auto-save buffer
- Determine if the auto-save buffer differs from the live blog post
- Validate the auto-save buffer version of the blog post
- Copy the contents of the auto-save buffer into the live blog post
- Restore a previously deleted blog post
- List blog post revisions
- Get a previous blog post revision
- Restore a previous blog post revision
COS Blog Topics API
- List blog topics
- Search blog topics
- Get blog topic
- Create blog topic
- Update blog topic
- Delete blog topic
- Merge blog topics
COS Domains API
- Get domains
- Get a domain by ID
COS Files API
- Upload a new file
- List metadata for all files
- Upload a replacement file
- Mark a file as deleted
- Get file metadata
- Archive a file
- Hard delete a file and related items
- Move a file
- Create a folder
- List folder metadata
- Delete a folder
- Get the folder by ID
- Move or rename a folder
COS HubDB API
- HubDB API overview
- Get all tables
- Get details for a specific table
- Create a new table
- Clone a table
- Update a table
- Delete a table
- Get table rows
- Add a new row to a table
- Clone a row
- Update a row
- Delete a row
- Update a row cell
- Delete a cell from a row
- Import a CSV file
COS Layouts API
- List layouts
- Get the layout by ID
- Gets the current contents of the auto-save buffer
- Determine if the auto-save buffer differs from the live layout
- List previous versions of the layout
- Get the previous version of the layout
COS Page Publishing API
- Create a new page
- List pages
- Update a page
- Delete a page
- Get a page by ID
- Updates the auto-save buffer
- Gets the current contents of the auto-save buffer
- Clone a page
- Determine if the auto-save buffer differs from the live page
- Publishes or unpublishes a page
- Copies the contents of the auto-save buffer into the live page.
- Restores a previously deleted page
- Validates the auto-save buffer version of the page
- List previous versions of a page
- Restore a previous version of a page
COS Site Maps
- List site maps
- Get the site map by ID
- Gets the current contents of the auto-save buffer
- Determine if the auto-save buffer differs from the live site map
- List previous versions of the site map
- Get the previous version of the site map
COS Site Search API
- Search for Content
COS Templates API
- Create a new template
- List templates
- Update the template
- Delete the template
- Get the template by ID
- Updates the auto-save buffer
- Gets the current contents of the auto-save buffer
- Determine if the auto-save buffer differs from the live template
- Copies the contents of the auto-save buffer into the live template.
- Restores a previously deleted template
- List previous versions of the template
- Get the previous version of the template
- Restore a previous version of the template
COS URL Mappings API
- List URL mappings
- Get the URL mapping by ID
- Create a new URL mapping
- Update the URL mapping
- Delete the URL mapping
CRM Extensions API
- CRM Extensions overview
- Extension property types
- Create object type
- View an object type
- Modify an object type
- Delete an object type
CRM Integration Guide
- Getting Started
- Contacts
- Companies
- Deals
- Owners
- Engagements
Deals API
- Deals overview
- Create a deal
- Update a deal
- Update a group of deals
- Get all deals
- Get recently modified deals
- Get recently created deals
- Delete a deal
- Get a deal
- Associate deal
- Remove association of deal
- Get associated deals
Deal Pipelines API
- Deal pipelines overview
- Get deal pipeline
- Get all deal pipelines
- Create deal pipeline
- Update deal pipeline
- Delete deal pipeline
Deal Properties API
- Deal properties overview
- Create a deal property
- Update a deal property
- Delete a deal property
- Get all deal properties
- Get a deal property
- Create a deal property group
- Update a deal property group
- Delete a deal property group
- Get deal groups
- Get a deal group
Ecommerce Bridge API
- Ecommerce Bridge Overview
- Install ecommerce settings
- Check ecommerce installation
- Uninstall ecommerce settings
- Upsert ecommerce settings
- Get ecommerce settings
- Delete ecommerce settings
- Send ecommerce sync messages
- Get sync errors
- Set ecommerce import trigger URI
- Retrieve ecommerce import settings
- Import ecommerce data
- Signal the end of an import
Email API
- Email subscription overview
- Get subscription type definitions
- View subscriptions timeline
- View subscription status of email address
- Update subscription status of email address
Email Events API
- Email events overview
- Get all campaign IDs for a portal
- Get campaign IDs with recent activity for a portal
- Get campaign data for a particular Campaign
- Get event data for a campaign or recipient
- Get event data for a specific event
Engagements API
- Engagements overview
- Create an engagement
- Update an engagement
- Get an engagement
- Get all engagements
- Get recent engagements
- Delete an engagement
- Associate engagement with CRM object
- Get associated engagements
- Get call dispositions
Forms API
- Forms overview
- Submit form data
- Submit form data (AJAX)
- Get forms
- Get form
- Create a form
- Update a form
- Delete a form
- Get form fields
- Get a form field
- Customizing the embed code
- Using Global Form Events
Keywords API
- Get keyword List
- Get a keyword
- Create a keyword
- Delete a keyword
Line Items API
Owners API
- Owners overview
- Get Owners
Products API
Social Media API
- Get publishing channels
- Get a channel
- Get broadcast messages
- Get a broadcast message
- Create a broadcast message
- Cancel a broadcast message
Tickets API
Timeline API
- Timeline API overview
- Details for timeline event templates
- Create or update timeline event
- Get the details for an existing event
- Create or update a group of timeline events
- Get timeline event types
- Create new timeline event type
- Update timeline event type
- Delete timeline event type
- Get properties for event type
- Create property for event type
- Update property for event Type
- Delete property for event type
Tracking Code API
- Tracking code overview
- Set page path
- Track page view
- Identify a visitor
- Events Javascript API
- Events HTTP API
- Remove cookies
- Get privacy consent status
- Place do not track cookie
Transactional Email API
- Overview
- SMTP API
- List SMTP tokens
- Create SMTP token
- Token password reset
- Single-send API
Workflows API
- Workflows overview
- Get all workflows
- Get a specific workflow
- Enroll a contact into a workflow
- Create a workflow
- Delete a workflow
- Unenroll (remove) a contact from a workflow
- Current enrollments
- Log events
- Using webhooks in workflows
Webhooks API
- Webhooks overview

Using the HubSpot developer tools

Below you can find documentation for using some of the developer tools you'll find in your HubSpot developer portal (don't have a devloper portal yet? Get one here).

For more general questions about HubSpot's APIs, see the API Overview and our FAQ list.

Docs for this section or API

Overview
- API overview
- API usage guidelines
- Getting featured
- Working within API rate limits
- Check daily API usage
- Get account details
Developer Preview
- Developer preview overview
- Tickets API
- Products API
- Line Items API
- CRM Object Properties API
- CRM Associations API
Authentication
- Authentication overview
OAuth 2.0
- OAuth 2.0 overview
- OAuth 2.0 scopes
- Initiating an OAuth connection
- Get access and refresh tokens
- Refresh access token
- Get access token information
- Get refresh token information
- Delete refresh token
- Using OAuth 2.0 access tokens
FAQ
- FAQ overview
- Subscribing to API updates
- Testing the HubSpot APIs
- API error responses
- Timestamp formatting
- CORS / AJAX support
- vidOffset and timeOffset
- Getting all contact properties
- Multiple values for checkbox
- Manipulating forms with jQuery
- How do I send transactional emails?
- How are email addresses validated?
- Tracking lawful basis of processing in HubSpot
Using the developer tools
- Developer tools overview
- How do I create an app in HubSpot?
- Installing an app
- How do I create a test portal?
- Using app request monitoring
- Prerequisites for Integrations Platform API
Analytics API
- Analytics API Overview
- Get analytics data breakdowns
- Get analytics data for specific objects
- Get analytics data for HubSpot hosted content
Calendar API
- List content events
- List social events
- List task events
- List all events
- Create task
- Get task by ID
- Update task
- Delete task
Companies API
- Companies overview
- Create a company
- Update a company
- Update a group of companies
- Delete a company
- Get all companies
- Get recently modified companies
- Get recently created companies
- Search for companies by domain
- Get a company
- Get contacts of a company
- Get contacts IDs of a company
- Add contact to company
- Remove contact from company
Company Properties API
- Company properties overview
- Get all company properties
- Get a company property
- Create a company property
- Update a company property
- Delete a company property
- Get company property groups
- Create a company property group
- Update a company property group
- Delete a company property group
Contacts API
- Contacts overview
- Create a contact
- Update a contact
- Update a contact by email
- Create or update a contact
- Create or update a group of contacts
- Delete a contact
- Get all contacts
- Get recently modified contacts
- Get recently created contacts
- Get contact by ID
- Get group of contacts by ID
- Get contact by email
- Get group of contacts by email
- Get contact by user token
- Search for contacts
- Merge contacts
- Get lifecycle stage metrics for contacts
Contact Lists API
- Contact lists overview
- Create a contact list
- Get contact lists
- Get a contact list by ID
- Update a contact list
- Delete a contact list
- Get a group of contact lists
- Get static contact lists
- Get dynamic contact lists
- Get contacts in a list
- Get recently added contacts in a list
- Add contact to list
- Remove contact from list
Contact Properties API
- Contact properties overview
- Get all properties
- Get a contact property
- Create a new property
- Update a property
- Delete a property
- Get property groups
- Get property group details
- Create a property group
- Update a property group
- Delete a property group
COS Blog API
- List blogs
- Get a blog by ID
- List blog revisions
- Get a blog revision
COS Blog Authors API
- List blog authors
- Search blog authors
- Get blog author
- Create blog author
- Update blog author
- Delete blog author
COS Blog Comments API
- List comments
- Get comment
- Create new comment
- Delete comment
- Restore deleted comment
COS Blog Post API
- List blog posts
- Get a blog post by ID
- Create a new blog post
- Update the blog post
- Delete the blog post
- Clone the blog post
- Publish or unpublish a blog post
- Get the current contents of the auto-save buffer
- Update the auto-save buffer
- Determine if the auto-save buffer differs from the live blog post
- Validate the auto-save buffer version of the blog post
- Copy the contents of the auto-save buffer into the live blog post
- Restore a previously deleted blog post
- List blog post revisions
- Get a previous blog post revision
- Restore a previous blog post revision
COS Blog Topics API
- List blog topics
- Search blog topics
- Get blog topic
- Create blog topic
- Update blog topic
- Delete blog topic
- Merge blog topics
COS Domains API
- Get domains
- Get a domain by ID
COS Files API
- Upload a new file
- List metadata for all files
- Upload a replacement file
- Mark a file as deleted
- Get file metadata
- Archive a file
- Hard delete a file and related items
- Move a file
- Create a folder
- List folder metadata
- Delete a folder
- Get the folder by ID
- Move or rename a folder
COS HubDB API
- HubDB API overview
- Get all tables
- Get details for a specific table
- Create a new table
- Clone a table
- Update a table
- Delete a table
- Get table rows
- Add a new row to a table
- Clone a row
- Update a row
- Delete a row
- Update a row cell
- Delete a cell from a row
- Import a CSV file
COS Layouts API
- List layouts
- Get the layout by ID
- Gets the current contents of the auto-save buffer
- Determine if the auto-save buffer differs from the live layout
- List previous versions of the layout
- Get the previous version of the layout
COS Page Publishing API
- Create a new page
- List pages
- Update a page
- Delete a page
- Get a page by ID
- Updates the auto-save buffer
- Gets the current contents of the auto-save buffer
- Clone a page
- Determine if the auto-save buffer differs from the live page
- Publishes or unpublishes a page
- Copies the contents of the auto-save buffer into the live page.
- Restores a previously deleted page
- Validates the auto-save buffer version of the page
- List previous versions of a page
- Restore a previous version of a page
COS Site Maps
- List site maps
- Get the site map by ID
- Gets the current contents of the auto-save buffer
- Determine if the auto-save buffer differs from the live site map
- List previous versions of the site map
- Get the previous version of the site map
COS Site Search API
- Search for Content
COS Templates API
- Create a new template
- List templates
- Update the template
- Delete the template
- Get the template by ID
- Updates the auto-save buffer
- Gets the current contents of the auto-save buffer
- Determine if the auto-save buffer differs from the live template
- Copies the contents of the auto-save buffer into the live template.
- Restores a previously deleted template
- List previous versions of the template
- Get the previous version of the template
- Restore a previous version of the template
COS URL Mappings API
- List URL mappings
- Get the URL mapping by ID
- Create a new URL mapping
- Update the URL mapping
- Delete the URL mapping
CRM Extensions API
- CRM Extensions overview
- Extension property types
- Create object type
- View an object type
- Modify an object type
- Delete an object type
CRM Integration Guide
- Getting Started
- Contacts
- Companies
- Deals
- Owners
- Engagements
Deals API
- Deals overview
- Create a deal
- Update a deal
- Update a group of deals
- Get all deals
- Get recently modified deals
- Get recently created deals
- Delete a deal
- Get a deal
- Associate deal
- Remove association of deal
- Get associated deals
Deal Pipelines API
- Deal pipelines overview
- Get deal pipeline
- Get all deal pipelines
- Create deal pipeline
- Update deal pipeline
- Delete deal pipeline
Deal Properties API
- Deal properties overview
- Create a deal property
- Update a deal property
- Delete a deal property
- Get all deal properties
- Get a deal property
- Create a deal property group
- Update a deal property group
- Delete a deal property group
- Get deal groups
- Get a deal group
Ecommerce Bridge API
- Ecommerce Bridge Overview
- Install ecommerce settings
- Check ecommerce installation
- Uninstall ecommerce settings
- Upsert ecommerce settings
- Get ecommerce settings
- Delete ecommerce settings
- Send ecommerce sync messages
- Get sync errors
- Set ecommerce import trigger URI
- Retrieve ecommerce import settings
- Import ecommerce data
- Signal the end of an import
Email API
- Email subscription overview
- Get subscription type definitions
- View subscriptions timeline
- View subscription status of email address
- Update subscription status of email address
Email Events API
- Email events overview
- Get all campaign IDs for a portal
- Get campaign IDs with recent activity for a portal
- Get campaign data for a particular Campaign
- Get event data for a campaign or recipient
- Get event data for a specific event
Engagements API
- Engagements overview
- Create an engagement
- Update an engagement
- Get an engagement
- Get all engagements
- Get recent engagements
- Delete an engagement
- Associate engagement with CRM object
- Get associated engagements
- Get call dispositions
Forms API
- Forms overview
- Submit form data
- Submit form data (AJAX)
- Get forms
- Get form
- Create a form
- Update a form
- Delete a form
- Get form fields
- Get a form field
- Customizing the embed code
- Using Global Form Events
Keywords API
- Get keyword List
- Get a keyword
- Create a keyword
- Delete a keyword
Line Items API
Owners API
- Owners overview
- Get Owners
Products API
Social Media API
- Get publishing channels
- Get a channel
- Get broadcast messages
- Get a broadcast message
- Create a broadcast message
- Cancel a broadcast message
Tickets API
Timeline API
- Timeline API overview
- Details for timeline event templates
- Create or update timeline event
- Get the details for an existing event
- Create or update a group of timeline events
- Get timeline event types
- Create new timeline event type
- Update timeline event type
- Delete timeline event type
- Get properties for event type
- Create property for event type
- Update property for event Type
- Delete property for event type
Tracking Code API
- Tracking code overview
- Set page path
- Track page view
- Identify a visitor
- Events Javascript API
- Events HTTP API
- Remove cookies
- Get privacy consent status
- Place do not track cookie
Transactional Email API
- Overview
- SMTP API
- List SMTP tokens
- Create SMTP token
- Token password reset
- Single-send API
Workflows API
- Workflows overview
- Get all workflows
- Get a specific workflow
- Enroll a contact into a workflow
- Create a workflow
- Delete a workflow
- Unenroll (remove) a contact from a workflow
- Current enrollments
- Log events
- Using webhooks in workflows
Webhooks API
- Webhooks overview

About

What is HubSpot?
Our Story
Executive Team
Press Room
Partners
FAQs

Jobs

Cambridge
International

Learn Inbound

Marketing Resources
Inbound Marketing Blog
Deutscher Inbound Blog
HubSpot Academy
INBOUND Conference

Support

Open a support ticket
Submit a feature request
Join a local user group
Help & support home

Contact Sales

Request a call
North America
888.482.7768
United Kingdom
+44.20.36847648
Ireland
+353.1.5187500
Germany
+49.69.299571918
Australia
+61.1300.482.7768

Locations

HubSpot, Inc.
25 First Street, 2nd Floor
Cambridge, MA 02141

European Headquarters
2nd Floor, 30 North Wall Quay
Dublin 1, Ireland

Asia/Pacific Office
Level 19, 1 O'Connell Street
Sydney, NSW 2000, Australia
ABN: 33169157911

English
Deutsch
日本語
Español

Legal Stuff
Privacy Policy
Site Map