Skip to main content
Essal provides official SDKs for the most common server-side languages. All SDKs wrap the same REST API, handle authentication, implement retry/backoff logic, and expose typed models for each app’s entities.

Available SDKs

Node.js / TypeScript

@essal/sdk — supports ESM and CommonJS. Full TypeScript types included.

Python

essal-python — compatible with Python 3.9+. Async support via asyncio.

Ruby

essal-ruby — compatible with Ruby 3.0+.

Go

github.com/essal/essal-go — idiomatic Go client with context support.

Common Features Across All SDKs

  • Auto-retry: Handles 429 and 5xx responses with exponential backoff
  • Pagination helpers: Built-in page iterator and cursor helpers
  • Environment switching: Single config option to target sandbox, staging, or production
  • Typed responses: Entity models with IDE autocomplete support
  • Webhook verification: Helper to verify X-Essal-Signature payloads

Quick Example

Versioning

SDK versions follow the API version. The current major version is v1. Pin your SDK to a minor version in production to avoid unexpected breaking changes.

Community SDKs

Community-maintained SDKs are available for Java, PHP, and .NET. These are not officially supported but are listed in the GitHub repository.