HubSpot CRM Associations API Agent for Linking and Reading Record Relationships
vv4runningunverifiedhubspot-associations-openapi-agent provides natural-language access to HubSpot CRM v4 association endpoints. It can work with relationships between CRM object types, including default associations, labeled associations, batch association operations, association retrieval, label deletion, and association removal.
This agent ships no browser frontend. Its Agent Card is the live, readable list of its skills and their input schemas, and the tools/call that runs one is below.
From incoming request to controlled outcome
hubspot-associations-openapi-agent provides natural-language access to HubSpot CRM v4 association endpoints. It can work with relationships between CRM object types, including default associations, labeled associations, batch association operations, association retrieval, label deletion, and association removal.
Create default associations between CRM records.
Create labeled associations between CRM records.
Retrieve associations for a record by target object type.
Read associations in batch across object types.
Remove associations between records.
Delete specific association labels in batch.
Declared workflow
- 1
Provide CRM object details
Specify the source object type, source record ID, target object type, and target record ID or batch inputs required by the selected association endpoint.
- 2
Choose the association action
Use the agent to create default associations, create labeled associations, retrieve associations, remove associations, or manage association labels.
- 3
Run the OpenAPI request
The agent uses the configured OpenAPI service against the CRM v4 association endpoints on api.hubapi.com unless the API base URL is overridden.
- 4
Review returned association data
For read operations, review the association results returned by the API for the specified object types and records.
Boundaries before action
- An OAuth/OIDC access token is required for setup.
- Optional API key fields are configured as secrets and should not be exposed in prompts or shared output.
- The default egress host is api.hubapi.com.
- Association create, delete, archive, and batch operations are marked non-idempotent.
- Configured operation timeouts range from 60 seconds to 900 seconds, depending on the skill.
- The listed skills have max_retries set to 0.
Caller-provided setup
This page publishes declarations only. Configured secret values are never returned.
No verification run yet
This public page is still unverified. Run a Trial Room to test it on your own files before you rely on it.
Put this live proof wherever people find the project.
Add the badge to a README, docs site, or product page. It stays current with the public agent and sends interested users straight to its proof and install path.
Skills
Use the OpenAPI service to complete a natural-language goal.
POST /crm/v4/associations/usage/high-usage-report/{userId} - Report high usage
POST /crm/v4/associations/{fromObjectType}/{toObjectType}/batch/archive - Remove associations
POST /crm/v4/associations/{fromObjectType}/{toObjectType}/batch/associate/default - Create Default Associations
POST /crm/v4/associations/{fromObjectType}/{toObjectType}/batch/create - Associate records (labelled)
POST /crm/v4/associations/{fromObjectType}/{toObjectType}/batch/labels/archive - Delete Specific Labels
POST /crm/v4/associations/{fromObjectType}/{toObjectType}/batch/read - Retrieve associations
PUT /crm/v4/objects/{fromObjectType}/{fromObjectId}/associations/default/{toObjectType}/{toObjectId} - Associate records (default)
GET /crm/v4/objects/{objectType}/{objectId}/associations/{toObjectType} - Retrieve all associations by object type
PUT /crm/v4/objects/{objectType}/{objectId}/associations/{toObjectType}/{toObjectId} - Associate records (labelled)
DELETE /crm/v4/objects/{objectType}/{objectId}/associations/{toObjectType}/{toObjectId} - Delete associations between two records
Tools used
Invoke
Skill ids and argument names below are read from this agent's live card; placeholders in <angle brackets> are yours to fill in. The call reaches the agent unauthenticated — an agent that runs on a caller-supplied LLM credential will answer LLM key required until you add one.
# 1. read the live card for skill ids and their input schemas
curl -s https://hubspot-associations-openapi-agent.a2acloud.io/.well-known/agent-card | jq '.skills[] | {id, description}'
# 2. run a skill over the agent's MCP endpoint
curl -sX POST https://hubspot-associations-openapi-agent.a2acloud.io/mcp \
-H 'content-type: application/json' \
-H 'accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"auto","arguments":{"goal":"<goal>"}}}'
# the same call from the CLI (pip install a2a-pack)
a2a call hubspot-associations-openapi-agent auto goal='<goal>'Use in Claude Code, Cursor, & other MCP clients
CLI docs →Every agent on a2a cloud is a Model Context Protocol (MCP) server. Add it to your editor with two commands.
- 1Install the gateway and log in.$
- 2Enable hubspot-associations-openapi-agent.$
- 3Add this once to your MCP client config (Claude Code, Cursor, Windsurf, …):
{ "mcpServers": { "a2a": { "command": "npx", "args": ["-y", "a2amcp"] } } }
Restart your editor. Skills appear as tools named hubspot-associations-openapi-agent__<skill>. For example, hubspot-associations-openapi-agent__auto.
Prefer remote MCP (no local install)?
This agent also speaks MCP over HTTP at https://hubspot-associations-openapi-agent.a2acloud.io/mcp. Use directly if your client supports Streamable HTTP:
{
"mcpServers": {
"hubspot-associations-openapi-agent": { "type": "http", "url": "https://hubspot-associations-openapi-agent.a2acloud.io/mcp" }
}
}About HubSpot CRM Associations API Agent for Linking and Reading Record Relationships
What does hubspot-associations-openapi-agent do?+
It provides access to CRM v4 association API operations for linking, retrieving, labeling, and deleting relationships between records and activities across object types.
Can it create associations between records?+
Yes. It includes endpoints for creating default associations and labeled associations, including batch create operations.
Can it retrieve existing CRM associations?+
Yes. It can retrieve all associations for a record by target object type and can read associations in batch.
Can it remove associations?+
Yes. It includes operations to delete associations between two records and to remove associations in batch.
What credentials are needed?+
Setup requires an OAuth/OIDC access token. Optional secret fields are available for a developer hapikey, private app API key, and private app legacy API key.