Retrieve contacts ordered by most recently created/modified. (docs)
POST /crm/v3/objects/contacts/search
🟢 low
— no
Retrieve deals ordered by most recently created/modified. (docs)
POST /crm/v3/objects/deals/search
🟢 low
— no
What the agent can do
Capability
API call
Risk
Needs approval
Create a new contact record (email, name, etc.). (docs)
POST /crm/v3/objects/contacts
🟡 medium
✅ yes
Create a new deal record (name, amount, stage, pipeline). (docs)
POST /crm/v3/objects/deals
🔴 high
✅ yes
Create a note engagement, optionally associated to a contact/deal. (docs)
POST /crm/v3/objects/notes
🟢 low
— no
Connecting it
You provide: HubSpot account (OAuth)
Where to get it: Create a developer account at developers.hubspot.com → Apps → Create app → configure OAuth (redirect URL, Client ID/Secret) and select scopes; each customer installs via the authorization-code flow. (Single-account alternative: Settings → Integrations → Private Apps → access token.)
Verification required: No review to use OAuth for your own/managed accounts (private OAuth distribution up to 10 accounts). Public App Marketplace listing requires HubSpot certification.
Testing: Create free standard developer test accounts to build/test OAuth installs without touching production data.
Limits
Free/Starter: 100 req/10s, 250k/day per account. Pro/Enterprise: 190 req/10s, 625k–1M/day. Public marketplace apps: 110 req/10s per install. HTTP 429 on exceed.