SDKs

Integrate Suger in your language of choice.

Official SDKs for Node.js, Python, Go, and Java. Type-safe, well-documented, and production-ready.

Available libraries

Four official SDKs, consistent API

Node.js

JavaScript / TypeScript

Generated SDK for Node.js with first-class TypeScript types.

$ npm install suger-sdk-ts

View documentation GitHub

Python

Python 3.9+

Pythonic SDK with type hints for scripting and services.

$ pip install suger-sdk-python

View documentation GitHub

Go

Go 1.18+

Idiomatic Go SDK with context support and typed responses.

$ go get github.com/sugerio/suger-sdk-go

View documentation GitHub

Java

Java 11+

Enterprise-ready client for Java applications (Maven / Gradle).

io.suger.sdk:suger-java-client

View documentation

Simple API

Call an org-scoped resource API in a few lines

Every SDK follows the same pattern: exchange your OAuth client credentials for a short-lived access token, point the client at api.suger.cloud, then call the resource method.

Read SDK Docs

example.ts

import { OfferApi, Configuration, ServerConfiguration } from 'suger-sdk-ts';

// Exchange your OAuth client credentials for a short-lived access token
// (POST https://apiv2.suger.cloud/oauth2/token, resource=https://api.suger.cloud)
const accessToken = await getAccessToken(clientId, clientSecret);

const configuration = new Configuration({
  baseServer: new ServerConfiguration('https://api.suger.cloud', {}),
  authMethods: { APIKeyAuth: 'Bearer ' + accessToken },
});

// Call an org-scoped resource API
const offerApi = new OfferApi(configuration);
const offer = await offerApi.getOffer(orgId, offerId);

console.log('Offer:', offer.id);

FAQ

SDK questions, answered

Which programming languages does Suger support? +

Suger provides official SDKs for Node.js (with TypeScript), Python, Go, and Java. The underlying REST API works with any language that can make HTTPS requests.

How do I install the Suger SDK? +

Use your language's package manager: `npm install suger-sdk-ts` (Node.js), `pip install suger-sdk-python` (Python), `go get github.com/sugerio/suger-sdk-go` (Go), or add the Maven/Gradle dependency `io.suger.sdk:suger-java-client` for Java.

Are Suger SDKs type-safe? +

Yes. The Node.js SDK ships with first-class TypeScript types, the Python SDK uses PEP 484 type hints, the Go SDK uses strict typing, and the Java SDK provides full class definitions.

How are the Suger SDKs built? +

Each SDK is a typed client generated from the Suger OpenAPI specification, so its methods and models track the REST API. The Node.js/TypeScript client is fetch-based and returns Promises; every client follows its language's conventions. You can always call the REST API directly if you prefer.

Where can I find SDK code examples? +

The full documentation at doc.suger.io includes runnable code examples for every endpoint in each SDK. There are also integration recipes for Salesforce, HubSpot, and common billing providers.

Can I use the Suger API without an SDK? +

Yes. The REST API works with any HTTP client — cURL, Postman, or your language's native library. The SDKs are optional but recommended for type safety and convenience.

Need a different language?

Our REST API works with any language. Check out the full API reference.

View API Reference Browse All SDKs