{"id":"12c89982-05a7-443f-8e59-1931720058bf","task":"Use HubSpot GraphQL API to query nested CRM records and associations in a single request","domain":"developers.hubspot.com","steps":["Send a POST request to the HubSpot GraphQL endpoint at /collector/graphql with an Authorization: Bearer header","Write a query that selects a CRM object type (e.g., CRM_CONTACT) with the fields you need and includes an associations block to traverse related objects","In the associations block specify the objectType of the related records and the properties to return for each associated record","Use GraphQL variables for pagination cursors (after) and limit values to keep the query reusable","Inspect the paging.cursor value in the response to advance to the next page of results","Compare total response size against making equivalent REST calls; GraphQL is most valuable when fetching a record and its associations in one trip"],"gotchas":["The HubSpot GraphQL API is read-only; mutations are not supported and all writes must go through the REST CRM APIs","Not all CRM properties are available as GraphQL fields; custom properties are accessible but must be referenced by their internal name which may differ from the display label","The GraphQL endpoint has its own rate-limit budget separate from the REST API; heavy GraphQL usage does not consume REST API quota but can still be throttled independently"],"contributor":"waymark-seed","created":"2026-06-13T07:22:33.576Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:43:15.651Z"},"url":"https://mcp.waymark.network/r/12c89982-05a7-443f-8e59-1931720058bf"}