Join a video meeting as an AI bot with voice, avatar, and screenshare across four operating modes.
Documents
go-hubspot
Try itUnofficial Go client for the HubSpot API. `hubspot.NewClientWithResponses("https://api.hubapi.com", ...)` from `github.com/psyb0t/go-hubspot` gives a typed method for every path in HubSpot's 2026-03 OpenAPI documents, including CRM objects such as contacts and companies, single-deal reads and updates, associations, properties, search, marketing, CMS, automation, conversations, files and webhooks. Auth is a Bearer private app or OAuth access token set through a request editor. Responses decode into typed `JSON200`/`JSON201` fields. Use when Go code needs to read or write HubSpot data, or already imports go-hubspot.
What it does
Typed Go client for the HubSpot API, generated with oapi-codegen. The package is ; every endpoint is a method on .
The skill document
go-hubspot
Typed Go client for the HubSpot API, generated with oapi-codegen. The package is hubspot; every endpoint is a method on *hubspot.ClientWithResponses.
For install details, naming, more operations and the developer API key scheme, see references/setup.md.
Security & safety
- Read the access token from an environment variable such as
HUBSPOT_ACCESS_TOKEN. Never hardcode it, commit it or log it, and never print request headers. - The client talks only to the base URL you give it. Use
https://api.hubapi.com; HubSpot data goes nowhere else. - Create, update, merge, archive, delete and GDPR purge endpoints change a live HubSpot account. Call them only when the user asked for that change, and only on records the task owns.
When to use
- Go code needs to read or write HubSpot CRM records, associations, properties, marketing, CMS or other HubSpot API data.
- You want typed request and response structs instead of hand-written HTTP calls.
- The project already imports
github.com/psyb0t/go-hubspot.
When NOT to use
- The code is not Go. Use one of HubSpot's own SDKs.
- You need an endpoint outside HubSpot's unified spec, such as a legacy v1 API. The client has no method for it.
- You only need to receive HubSpot webhooks. The client sends requests; it does not run a webhook server.
Usage
import (
"context"
"net/http"
"os"
"github.com/psyb0t/go-hubspot"
)
auth := hubspot.WithRequestEditorFn(func(_ context.Context, req *http.Request) error {
req.Header.Set("Authorization", "Bearer "+os.Getenv("HUBSPOT_ACCESS_TOKEN"))
return nil
})
client, err := hubspot.NewClientWithResponses("https://api.hubapi.com", auth)
if err != nil {
return err
}
Read one contact (GET /crm/objects/2026-03/contacts/{contactId}):
props := []string{"email", "firstname"}
res, err := client.Getcrmobjects202603contactsContactIdGetByIdWithResponse(
ctx,
"101",
&hubspot.Getcrmobjects202603contactsContactIdGetByIdParams{Properties: &props},
)
if err != nil {
return err // transport or decode failure
}
if res.JSON200 == nil {
return fmt.Errorf("hubspot: %s: %s", res.Status(), res.Body)
}
fmt.Println(res.JSON200.Id, res.JSON200.Properties["email"])
Create a contact (POST /crm/objects/2026-03/contacts, answers 201):
res, err := client.Postcrmobjects202603contactsCreateWithResponse(
ctx,
hubspot.CrmObjectsSimplePublicObjectInputForCreate{
Associations: []hubspot.CrmObjectsPublicAssociationsForObject{},
Properties: map[string]string{"email": "user@example.com"},
},
)
if err != nil {
return err
}
if res.JSON201 == nil {
return fmt.Errorf("hubspot: %s: %s", res.Status(), res.Body)
}
Search contacts (POST /crm/objects/2026-03/contacts/search):
value := "user@example.com"
res, err := client.Postcrmobjects202603contactssearchDoSearchWithResponse(
ctx,
hubspot.CrmPublicObjectSearchRequest{
FilterGroups: []hubspot.CrmFilterGroup{{
Filters: []hubspot.CrmFilter{{
PropertyName: "email",
Operator: hubspot.CrmFilterOperatorEQ,
Value: &value,
}},
}},
Limit: 10,
Properties: []string{"email"},
Sorts: []string{},
},
)
err is only set for network, request building or JSON decode failures. A HubSpot error status still returns err == nil: check res.StatusCode() or that the matching JSON2xx field is non-nil, and read res.Body for the error payload.
Related skills
Generate and edit Draw.io, Mermaid, and Excalidraw diagrams from natural language using a structured JSON spec.
Fetch raw ad creative, app, ranking, and revenue data from AdMapix as structured JSON.
Find why your productivity system keeps failing, then apply the smallest fix — capacity math, bottleneck routing, durable local notes.
Stores durable facts in a categorized, plain-markdown vault on disk, alongside your agent's built-in memory.
Write, debug, and tune Playwright specs with locator strategy, trace diagnosis, and CI-aware timeouts.
More from psyb0t
Browse all skillsDrive a user-deployed mt5-httpapi MetaTrader 5 bridge over HTTP, with per-action confirmation on every real-money call.
Docker-packaged browser automation for QA against anti-bot stacks and authorized detection testing.
Self-hosted OpenAI-compatible speech service — transcription, translation, and synthesis from one container.
Run ffmpeg, sox, and ImageMagick jobs against your files in a fixed-allowlist SSH sandbox.
Generate speech audio via Qwen3-TTS over SSH with preset voices, voice cloning, and voice design.
Drive one or more IMAP/SMTP mailboxes through a single REST + MCP endpoint — read, search, send, mark-seen, and delete across accounts in parallel.