HubSpot

CRM and marketing automation API for reading and writing contacts, companies, and deals. Best for workflows that need to sync customer records from other systems, create contacts from form submissions, or pull pipeline data into reports. Unlike Salesforce, HubSpot APIs are self-serve and free-tier-accessible, so they fit lightweight automation without enterprise contracts. 10 example endpoints available through Lava’s AI Gateway. See the HubSpot API docs for full documentation.

This provider requires your own credentials — connect your API key or OAuth account before use.

This is a catch-all provider — any valid URL under https://api.hubapi.com is supported. Any HubSpot API endpoint. Common paths: /crm/v3/objects/contacts, /crm/v3/objects/companies, /crm/v3/objects/deals. Construct URL as https://api.hubapi.com/{path}. See https://developers.hubspot.com/docs/api-reference for full reference. The endpoints below are curated examples.

Endpoints

List contacts. Supports limit, after (pagination cursor), properties, associations.

GET https://api.hubapi.com/crm/v3/objects/contacts?limit=100&properties=email,firstname,lastname — Free

SDK
cURL

const data = await lava.gateway('https://api.hubapi.com/crm/v3/objects/contacts?limit=100&properties=email,firstname,lastname', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.hubapi.com%2Fcrm%2Fv3%2Fobjects%2Fcontacts%3Flimit%3D100%26properties%3Demail%2Cfirstname%2Clastname" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

Retrieve a single contact by ID.

GET https://api.hubapi.com/crm/v3/objects/contacts/{contact_id}?properties=email,firstname,lastname — Free

SDK
cURL

const data = await lava.gateway('https://api.hubapi.com/crm/v3/objects/contacts/{contact_id}?properties=email,firstname,lastname', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.hubapi.com%2Fcrm%2Fv3%2Fobjects%2Fcontacts%2F%7Bcontact_id%7D%3Fproperties%3Demail%2Cfirstname%2Clastname" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

Create a new contact record.

POST https://api.hubapi.com/crm/v3/objects/contacts — Free

SDK
cURL

const data = await lava.gateway('https://api.hubapi.com/crm/v3/objects/contacts', {
  body: {
"properties": {
  "email": "ada@example.com",
  "firstname": "Ada",
  "lastname": "Lovelace"
}
},
});

curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.hubapi.com%2Fcrm%2Fv3%2Fobjects%2Fcontacts" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"properties":{"email":"ada@example.com","firstname":"Ada","lastname":"Lovelace"}}'

Update an existing contact. Only properties in the request body are modified.

PATCH https://api.hubapi.com/crm/v3/objects/contacts/{contact_id} — Free

SDK
cURL

const data = await lava.gateway('https://api.hubapi.com/crm/v3/objects/contacts/{contact_id}', { method: 'PATCH', body: {"properties":{"lifecyclestage":"customer"}} });

curl -X PATCH "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.hubapi.com%2Fcrm%2Fv3%2Fobjects%2Fcontacts%2F%7Bcontact_id%7D" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"properties":{"lifecyclestage":"customer"}}'

Search contacts with filter groups. Use for email lookups, recent activity, or custom property matching.

POST https://api.hubapi.com/crm/v3/objects/contacts/search — Free

SDK
cURL

const data = await lava.gateway('https://api.hubapi.com/crm/v3/objects/contacts/search', {
  body: {
"filterGroups": [
  {
    "filters": [
      {
        "propertyName": "email",
        "operator": "EQ",
        "value": "ada@example.com"
      }
    ]
  }
]
},
});

curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.hubapi.com%2Fcrm%2Fv3%2Fobjects%2Fcontacts%2Fsearch" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filterGroups":[{"filters":[{"propertyName":"email","operator":"EQ","value":"ada@example.com"}]}]}'

List companies with pagination and property selection.

GET https://api.hubapi.com/crm/v3/objects/companies?limit=100&properties=name,domain,industry — Free

SDK
cURL

const data = await lava.gateway('https://api.hubapi.com/crm/v3/objects/companies?limit=100&properties=name,domain,industry', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.hubapi.com%2Fcrm%2Fv3%2Fobjects%2Fcompanies%3Flimit%3D100%26properties%3Dname%2Cdomain%2Cindustry" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

List deals in the pipeline.

GET https://api.hubapi.com/crm/v3/objects/deals?limit=100&properties=dealname,amount,dealstage,closedate — Free

SDK
cURL

const data = await lava.gateway('https://api.hubapi.com/crm/v3/objects/deals?limit=100&properties=dealname,amount,dealstage,closedate', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.hubapi.com%2Fcrm%2Fv3%2Fobjects%2Fdeals%3Flimit%3D100%26properties%3Ddealname%2Camount%2Cdealstage%2Cclosedate" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

Create a new deal in a specified pipeline and stage.

POST https://api.hubapi.com/crm/v3/objects/deals — Free

SDK
cURL

const data = await lava.gateway('https://api.hubapi.com/crm/v3/objects/deals', {
  body: {
"properties": {
  "dealname": "Example Deal",
  "amount": "5000",
  "dealstage": "qualifiedtobuy",
  "pipeline": "default"
}
},
});

curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.hubapi.com%2Fcrm%2Fv3%2Fobjects%2Fdeals" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"properties":{"dealname":"Example Deal","amount":"5000","dealstage":"qualifiedtobuy","pipeline":"default"}}'

Archive (soft-delete) a contact by ID. HubSpot retains the record for 90 days in case of recovery.

DELETE https://api.hubapi.com/crm/v3/objects/contacts/{contact_id} — Free

SDK
cURL

const data = await lava.gateway('https://api.hubapi.com/crm/v3/objects/contacts/{contact_id}', { method: 'DELETE' });

curl -X DELETE "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.hubapi.com%2Fcrm%2Fv3%2Fobjects%2Fcontacts%2F%7Bcontact_id%7D" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json"

Create or replace an association between two CRM objects (e.g. contact ↔ company).

PUT https://api.hubapi.com/crm/v3/objects/contacts/{contact_id}/associations/companies/{company_id}/{association_type_id} — Free

SDK
cURL

const data = await lava.gateway('https://api.hubapi.com/crm/v3/objects/contacts/{contact_id}/associations/companies/{company_id}/{association_type_id}', { method: 'PUT' });

curl -X PUT "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.hubapi.com%2Fcrm%2Fv3%2Fobjects%2Fcontacts%2F%7Bcontact_id%7D%2Fassociations%2Fcompanies%2F%7Bcompany_id%7D%2F%7Bassociation_type_id%7D" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json"

Get Started

AI Gateway

AI Spend

Monetize

Integration

SDK

Cookbook

Comparisons

Endpoints

Retrieve a single contact by ID.

Create a new contact record.

Update an existing contact. Only properties in the request body are modified.

Search contacts with filter groups. Use for email lookups, recent activity, or custom property matching.

List deals in the pipeline.

Create a new deal in a specified pipeline and stage.

Archive (soft-delete) a contact by ID. HubSpot retains the record for 90 days in case of recovery.

Create or replace an association between two CRM objects (e.g. contact ↔ company).

Next Steps

All Providers

Forward Proxy

​Endpoints

​List contacts. Supports limit, after (pagination cursor), properties, associations.

​Retrieve a single contact by ID.

​Create a new contact record.

​Update an existing contact. Only properties in the request body are modified.

​Search contacts with filter groups. Use for email lookups, recent activity, or custom property matching.

​List companies with pagination and property selection.

​List deals in the pipeline.

​Create a new deal in a specified pipeline and stage.

​Archive (soft-delete) a contact by ID. HubSpot retains the record for 90 days in case of recovery.

​Create or replace an association between two CRM objects (e.g. contact ↔ company).

​Next Steps

All Providers

Forward Proxy

Endpoints

List contacts. Supports limit, after (pagination cursor), properties, associations.

Retrieve a single contact by ID.

Create a new contact record.

Update an existing contact. Only properties in the request body are modified.

Search contacts with filter groups. Use for email lookups, recent activity, or custom property matching.

List companies with pagination and property selection.

List deals in the pipeline.

Create a new deal in a specified pipeline and stage.

Archive (soft-delete) a contact by ID. HubSpot retains the record for 90 days in case of recovery.

Create or replace an association between two CRM objects (e.g. contact ↔ company).

Next Steps