MessageBlue Client SDKs

Typed clients generated from the MessageBlue API specification
View as Markdown

You can call the MessageBlue API directly over HTTPS from anything that speaks HTTP. The SDKs exist to save you the boilerplate: authentication, request shaping, retries and — most usefully — types that tell you when a call is wrong before you run it.

Every client is generated from the same OpenAPI specification that produces this documentation. When an endpoint changes, the reference and the SDKs are regenerated together, so a method signature disagreeing with these pages is a bug rather than a version skew you have to reason about.

Which to use

You are…Use
Writing Node or TypeScript on a serverThe TypeScript SDK
Automating with no codeZapier
Working inside a CRMHubSpot
On another stack, or want full controlThe REST API directly

Authentication, in one place

Every SDK and every direct API call authenticates the same way: an App ID identifying your app, and an App Secret proving it is you. Both come from Settings → API & secrets.

The App Secret is a server-side credential and is displayed only once when created. Keep it in an environment variable or a secret manager — never in browser code, a mobile app bundle, or a committed file. If it leaks, regenerate it from Settings; regeneration takes effect immediately and breaks any integration still using the old value.

Reporting problems

SDK and reference are generated from one spec, so a mismatch in either is worth reporting — contact support with the endpoint, what you sent, and what you expected.