Skip to main content

​
Installing the SDK

1

Install the SDK

bun add contiguity
2

Initialize the Client

import { Contiguity } from "contiguity";
const contiguity = new Contiguity("contiguity_sk_...your_token...");

​
Initialization

The SDK accepts a token and optional configuration: 
import { Contiguity } from "contiguity";

// Basic initialization
const contiguity = new Contiguity("contiguity_sk_...your_token...");

// With options
const contiguity = new Contiguity("contiguity_sk_...your_token...", {
    raw: false,    // Return data in top level of response (default)
    debug: false   // Disable debug logging (default)
});

​
Options

​
raw
boolean
default:"false"
When true, returns raw API responses with metadata at the top level and data nested inside a data object. When false, returns cleaned responses with metadata separate.
​
debug
boolean
default:"false"
When true, enables extra logging for debugging purposes.

​
Quick Start

Once initialized, you can start using the SDK immediately: 
// Send a text message
await contiguity.text.send({
    to: "+1234567890",
    message: "Hello from Contiguity!"
});

// Send an email
await contiguity.email.send({
    to: "[email protected]",
    from: "Your App <[email protected]>",
    subject: "Welcome!",
    body: { text: "Welcome to our platform!" }
});

​
Response Format

The SDK returns different response formats depending on the raw option:

​
Default Format (raw: false)

Clean responses with metadata separate from the main data: 
{
    // Method-specific response data
    message_id?: string,
    email_id?: string,
    otp_id?: string,
    // ... other response fields
    
    // Metadata included with every response
    metadata: {
        id: string,
        timestamp: string,
        api_version: string,
        object: string,
    }
}

​
Raw Format (raw: true)

Raw API responses with metadata at the top level and data nested: 
{
    // Metadata at top level
    id: string,
    timestamp: string,
    api_version: string,
    object: string,
    
    // All response data nested in data object
    data: {
        message_id?: string,
        email_id?: string,
        otp_id?: string,
        // ... other response fields
    }
}