Email

JavaScript
Python

Installing the SDK

Install the SDK

Bun
pnpm
npm
Yarn

bun add contiguity

pnpm add contiguity

npm install contiguity

yarn add contiguity

Initialize the Client

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

Sending an email

Various email parameters can be configured in the Console such as tracking, custom domains, and more.

const res = await contiguity.email.send({
  to: ["[email protected]", "[email protected]"],
  from: "Your App <[email protected]>",
  subject: "Welcome!",
  body: { html: "<h1>Hello</h1>" },
  reply_to: "[email protected]",
  cc: "[email protected]"
});

Response

email_id

string

Unique identifier for the sent email, used for tracking delivery status and analytics.

metadata

object

Request metadata including ID, timestamp, and API version.

You can also send a simple email with just the required fields:

const res = await contiguity.email.send({
  to: "[email protected]",
  from: "Your App <[email protected]>",
  subject: "Hello from Contiguity!",
  body: { text: "This is a plain text email." }
});

Installing the SDK

Install the SDK

pip install contiguity

Initialize the Client

import contiguity
client = contiguity.login("your_token_here")

You can also initialize it with the optional ‘debug’ flag:

client = contiguity.login("your_token_here", True)

Sending an email

Various email parameters can be configured in the Console such as tracking, custom domains, and more.

# HTML email
email_object = {
    "to": "[email protected]",
    "from": "Contiguity",
    "subject": "My first email!",
    "html": "<b>I sent an email using Contiguity</b>"
}

client.send.email(email_object)

Or, to send a plain text email:

# Plain text email
email_object = {
    "to": "[email protected]",
    "from": "Contiguity",
    "subject": "My first email!",
    "text": "I sent an email using Contiguity"
}

client.send.email(email_object)

Optionally, use replyTo and cc. At the moment, cc only allows one email address.

Parameters

email.send(params)

string | string[]

required

The recipient’s email address or an array of email addresses.

from

string

required

The sender’s email address. Can include a display name: "Your App <[email protected]>"

subject

string

required

The email subject line.

body

object

required

The email content. Must contain either text, html, or both.

Show Body object properties

body.text

string

Plain text version of the email content.

body.html

string

HTML version of the email content.

reply_to

string

Email address for replies. If not specified, replies will go to the from address.

string | string[]

Carbon copy recipients. Can be a single email address or an array of addresses.

bcc

string | string[]

Blind carbon copy recipients. Can be a single email address or an array of addresses.

headers

object[]

Custom email headers as an array of objects with name and value properties.

Show Header object structure

headers[].name

string

required

The header name (e.g., “X-Campaign”).

headers[].value

string

required

The header value.

Getting Started

SDK Documentation by Product

SDK Documentation by Language

Installing the SDK

Sending an email

Response

Installing the SDK

Sending an email

Parameters

email.send(params)

Getting Started

SDK Documentation by Product

SDK Documentation by Language

​Installing the SDK

​Sending an email

​Response

​Installing the SDK

​Sending an email

​Parameters

​email.send(params)

Installing the SDK

Sending an email

Response

Installing the SDK

Sending an email

Parameters

email.send(params)