github.com/threecolts/go-hubspot

This is a HubSpot Go client generated using openapi-generator. It includes packages for every OpenAPI spec listed in HubSpot's API directory.

Installing

go get github.com/threecolts/go-hubspot

Re-generating Clients

This package includes a client generator that runs the openapi-generator binary (must be located in your PATH) and re-generates the Go clients using the most up-to-date API specs. Any changes to the specs should be committed to this repository through a PR. I'll do my best to keep this up to date with the most recent changes. Assuming that you have openapi-generator installed, just run the following to re-generate the clients.

go generate

Using the clients

The clients are broken out into their own packages by name and categorized by API version.

import "github.com/threecolts/go-hubspot/generated/v3/contacts"

client := contacts.NewAPIClient(contacts.NewConfiguration())

input := contacts.SimplePublicObjectInput{
  Properties: map[string]string{
    "firstname": "Adrian", 
    "lastname": "Mott",
  },
}

client.BasicApi.
    Create(context.Background()).
    SimplePublicObjectInput(input).
    Execute()

Authorization

Authorization is done by passing context values in with each request. In order to facilitate this, I've created a simple Authorizer interface and a private app token implementation (more implementations to come). An API key implementation is also available but the HubSpot API has deprecated API tokens.

authorizer := hubspot.NewTokenAuthorizer("<PRIVATE APP TOKEN>")
ctx := hubspot.WithAuthorizer(context.Background(), authorizer)
// Pass this context to your hubspot API requests