HubSpot CRM API integration with managed OAuth. Manage contacts, companies, deals, and associations. Use this skill when users want to create or update CRM records, search contacts, or sync data with
Real data. Real impact.
Emerging
Developers
Per week
Open source
Skills give you superpowers. Install in 30 seconds.
Access the HubSpot CRM API with managed OAuth authentication. Create and manage contacts, companies, deals, and their associations.
# List contacts python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://gateway.maton.ai/hubspot/crm/v3/objects/contacts?limit=10&properties=email,firstname,lastname') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
https://gateway.maton.ai/hubspot/{native-api-path}
Replace
{native-api-path}api.hubapi.comAll requests require the Maton API key in the Authorization header:
Authorization: Bearer $MATON_API_KEY
Environment Variable: Set your API key as
MATON_API_KEYexport MATON_API_KEY="YOUR_API_KEY"
Manage your HubSpot OAuth connections at
https://ctrl.maton.aipython <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections?app=hubspot&status=ACTIVE') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
python <<'EOF' import urllib.request, os, json data = json.dumps({'app': 'hubspot'}).encode() req = urllib.request.Request('https://ctrl.maton.ai/connections', data=data, method='POST') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') req.add_header('Content-Type', 'application/json') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
Response:
{ "connection": { "connection_id": "21fd90f9-5935-43cd-b6c8-bde9d915ca80", "status": "ACTIVE", "creation_time": "2025-12-08T07:20:53.488460Z", "last_updated_time": "2026-01-31T20:03:32.593153Z", "url": "https://connect.maton.ai/?session_token=...", "app": "hubspot", "metadata": {} } }
Open the returned
urlpython <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}', method='DELETE') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
If you have multiple HubSpot connections, specify which one to use with the
Maton-Connectionpython <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://gateway.maton.ai/hubspot/crm/v3/objects/contacts') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') req.add_header('Maton-Connection', '21fd90f9-5935-43cd-b6c8-bde9d915ca80') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
If omitted, the gateway uses the default (oldest) active connection.
GET /hubspot/crm/v3/objects/contacts?limit=100&properties=email,firstname,lastname,phone
With pagination:
GET /hubspot/crm/v3/objects/contacts?limit=100&properties=email,firstname&after={cursor}
GET /hubspot/crm/v3/objects/contacts/{contactId}?properties=email,firstname,lastname
POST /hubspot/crm/v3/objects/contacts Content-Type: application/json{ "properties": { "email": "john@example.com", "firstname": "John", "lastname": "Doe", "phone": "+1234567890" } }
PATCH /hubspot/crm/v3/objects/contacts/{contactId} Content-Type: application/json{ "properties": { "phone": "+0987654321" } }
DELETE /hubspot/crm/v3/objects/contacts/{contactId}
POST /hubspot/crm/v3/objects/contacts/search Content-Type: application/json{ "filterGroups": [{ "filters": [{ "propertyName": "email", "operator": "EQ", "value": "john@example.com" }] }], "properties": ["email", "firstname", "lastname"] }
GET /hubspot/crm/v3/objects/companies?limit=100&properties=name,domain,industry
GET /hubspot/crm/v3/objects/companies/{companyId}?properties=name,domain,industry
POST /hubspot/crm/v3/objects/companies Content-Type: application/json{ "properties": { "name": "Acme Corp", "domain": "acme.com", "industry": "COMPUTER_SOFTWARE" } }
Note: The
industryCOMPUTER_SOFTWAREFINANCEHEALTHCAREPATCH /hubspot/crm/v3/objects/companies/{companyId} Content-Type: application/json{ "properties": { "industry": "COMPUTER_SOFTWARE", "numberofemployees": "50" } }
DELETE /hubspot/crm/v3/objects/companies/{companyId}
POST /hubspot/crm/v3/objects/companies/search Content-Type: application/json{ "filterGroups": [{ "filters": [{ "propertyName": "domain", "operator": "CONTAINS_TOKEN", "value": "*" }] }], "properties": ["name", "domain"], "limit": 10 }
GET /hubspot/crm/v3/objects/deals?limit=100&properties=dealname,amount,dealstage
GET /hubspot/crm/v3/objects/deals/{dealId}?properties=dealname,amount,dealstage
POST /hubspot/crm/v3/objects/deals Content-Type: application/json{ "properties": { "dealname": "New Deal", "amount": "10000", "dealstage": "appointmentscheduled" } }
PATCH /hubspot/crm/v3/objects/deals/{dealId} Content-Type: application/json{ "properties": { "amount": "15000", "dealstage": "qualifiedtobuy" } }
DELETE /hubspot/crm/v3/objects/deals/{dealId}
PUT /hubspot/crm/v4/objects/{fromObjectType}/{fromObjectId}/associations/{toObjectType}/{toObjectId} Content-Type: application/json[{"associationCategory": "HUBSPOT_DEFINED", "associationTypeId": 279}]
Common association type IDs:
2793341GET /hubspot/crm/v4/objects/{objectType}/{objectId}/associations/{toObjectType}
POST /hubspot/crm/v3/objects/{objectType}/batch/read Content-Type: application/json{ "properties": ["email", "firstname"], "inputs": [{"id": "123"}, {"id": "456"}] }
POST /hubspot/crm/v3/objects/{objectType}/batch/create Content-Type: application/json{ "inputs": [ {"properties": {"email": "one@example.com", "firstname": "One"}}, {"properties": {"email": "two@example.com", "firstname": "Two"}} ] }
POST /hubspot/crm/v3/objects/{objectType}/batch/update Content-Type: application/json{ "inputs": [ {"id": "123", "properties": {"firstname": "Updated"}}, {"id": "456", "properties": {"firstname": "Also Updated"}} ] }
POST /hubspot/crm/v3/objects/{objectType}/batch/archive Content-Type: application/json{ "inputs": [{"id": "123"}, {"id": "456"}] }
GET /hubspot/crm/v3/properties/{objectType}
EQNEQLTLTEGTGTECONTAINS_TOKENNOT_CONTAINS_TOKENList endpoints return a
paging.next.after{ "results": [...], "paging": { "next": { "after": "12345" } } }
Use the
afterGET /hubspot/crm/v3/objects/contacts?limit=100&after=12345
const response = await fetch('https://gateway.maton.ai/hubspot/crm/v3/objects/contacts', { method: 'POST', headers: { 'Content-Type': 'application/json', 'Authorization': `Bearer ${process.env.MATON_API_KEY}` }, body: JSON.stringify({ properties: { email: 'john@example.com', firstname: 'John' } }) });
import os import requestsresponse = requests.post( 'https://gateway.maton.ai/hubspot/crm/v3/objects/contacts', headers={'Authorization': f'Bearer {os.environ["MATON_API_KEY"]}'}, json={'properties': {'email': 'john@example.com', 'firstname': 'John'}} )
industrycurl -gfields[]sort[]records[]jq$MATON_API_KEY| Status | Meaning |
|---|---|
| 400 | Missing HubSpot connection |
| 401 | Invalid or missing Maton API key |
| 429 | Rate limited (10 req/sec per account) |
| 4xx/5xx | Passthrough error from HubSpot API |
MATON_API_KEYecho $MATON_API_KEY
python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
hubspothttps://gateway.maton.ai/hubspot/crm/v3/objects/contactshttps://gateway.maton.ai/crm/v3/objects/contactsNo automatic installation available. Please visit the source repository for installation instructions.
View Installation Instructions
1,500+ AI skills, agents & workflows. Install in 30 seconds. Part of the Torly.ai family.
© 2026 Torly.ai. All rights reserved.