Terminal
Terminal/Skill
Installs Sinch SDKs for Node.js, Python, Java, and .NET and shows how to create a client with project or app credentials.
By Sinch
Works with
npx skills add sinch/skills --skill sinch-sdksCross-cutting skill that covers SDK installation and client initialization for all Sinch products. Determines the correct SDK and provides init code per language.
For authentication setup (credentials, OAuth2, Basic auth, signed requests), see sinch-authentication. For In-App Calling SDKs (Browser, iOS, Android), see sinch-in-app-calling.
Policy gate
sinch-shared-policy@5(sha256:4864cf0fa8d6): The policy digest below is binding as written. Before implementation or live execution, read the full shared Sinch policy once per conversation — skip it if this exact ID/version/fingerprint is already loaded; read it if the version is newer or the fingerprint differs. This skill's canonical operation routes live in its Agent Instructions and Links sections.
Sinch policy digest (binding):
If the user hasn't specified which language or platform, ask first — the SDK and init pattern differ by language. Use the table below to route to the correct reference.
This skill has two kinds of content with UNEQUAL reliability. Follow this precedence:
developers.sinch.com (AUTHORITATIVE). The .md doc links in
this skill are the single source of truth for exact request/response schemas, field
names and nesting, enum values, signature/auth schemes, and limits. Before writing
code that constructs a payload, verifies a signature, or parses a callback/response,
fetch the specific linked doc and confirm the exact shape there. Fetching first-party
developers.sinch.com URLs is permitted by the Security/URL policy. Never invent, guess, or pattern-extrapolate a documentation URL — only fetch doc URLs written verbatim in this skill or reached by following a link on a page you already fetched; a trusted domain does not make a guessed path real.references/*.md (NAVIGATIONAL SUMMARIES — not authoritative). They orient
you and point at the right canonical doc; they may lag, omit fields, or simplify
nesting. Use them to decide what to build and which doc to open. Do NOT transcribe a
field name, nesting, encoding, or enum from a reference or from the SKILL.md overview
into shipped code without confirming it in the tier-1 doc. If a detail appears only in
a summary, treat it as unverified and say so.Quick rule: writing code → load the doc. Never cite an exact field, header, enum, or encoding you only saw in a summary.
| Language | Package | Install | Auth Scope |
|---|---|---|---|
| Node.js | @sinch/sdk-core | npm install @sinch/sdk-core | Project + Application |
| Python | sinch | pip install sinch | Project + Application |
| Java | com.sinch.sdk:sinch-sdk-java | Maven dependency | Project + Application |
| .NET | Sinch | NuGet package | Project + Application |
In-App Calling uses a separate client-side SDK — not @sinch/sdk-core. See sinch-in-app-calling.
Not all products are available in all SDKs. Check the table before recommending an SDK for a specific product.
| Product | Node.js | Java | .NET | Python |
|---|---|---|---|---|
| Conversation API | ✅ | ✅ | ⚠ | ⚠ |
| Voice API | ✅ | ✅ | ✅ | ✅ |
| Verification API | ✅ | ✅ | ✅ | ✅ |
| Numbers API | ✅ | ✅ | ✅ | ✅ |
| Number Lookup API | ✅ | ❌ | ❌ | ✅ |
| Elastic SIP Trunking | ✅ | ❌ | ❌ | ❌ |
| Fax API | ✅ | ❌ | ⚠ | ❌ |
| Provisioning API | ✅ | ❌ | ❌ | ❌ |
| 10DLC Registration | ❌ | ❌ | ❌ | ❌ |
✅ = supported, ⚠ = partial/preview, ❌ = not available (use direct HTTP)
When a product is not supported in the user's chosen SDK, guide them to use direct HTTP calls instead.
For language-specific initialization code, use the references:
If language is unknown, ask first. The SDKs handle token refresh automatically.
@sinch/sdk-core — Unified Node.js SDK covering all project-scoped and application-scoped Sinch APIs. Individual packages (e.g., @sinch/voice, @sinch/verification) are also available.
sinch (Python) — Python SDK (v2.0.0+) covering project-scoped and application-scoped APIs.
sinch-sdk-java — Java SDK (v2.0.0+) via Maven Central.
Project-scoped init — Uses projectId, keyId, keySecret. For Conversation, Numbers, Fax, EST, 10DLC, Number Lookup, Provisioning.
Application-scoped init — Uses applicationKey, applicationSecret. For Voice, Verification, In-App Calling.
Multi-product client — Provide both project and application credentials in a single SinchClient to access all APIs.
Conversation region — Must be set explicitly when using the Conversation API. Values: us, eu, br. Required in Python SDK v2.0.0+ and Java SDK v2.0.0+; recommended in Node.js and .NET. (Summary only — confirm exact names/encoding/enums against the authoritative Sinch Developer Docs doc before implementing.)
SinchClient with project credentials. See language-specific ref.SinchClient with app key/secret. See language-specific ref.conversationRegion during init (required in Python/Java, recommended elsewhere).conversation_region. Node.js and .NET don't enforce it yet but should set it explicitly.