SDKs

SendPing ships official SDKs for eight languages — Node.js (`sendping` on npm), Python, Go, Ruby, PHP, Rust, Java, and .NET — plus a CLI. Each wraps the same REST API with the idioms of its ecosystem.

Underneath them all is a clean REST API: predictable request and response shapes, mb_-prefixed API keys, the Bearer auth scheme, a consistent error envelope, and standard pagination conventions. So every language has two good options: install the official SDK, or hit the JSON API directly with any HTTP client.

Official Node.js SDK

Install the sendping package and instantiate the client with your mb_ API key. Every method returns { data, error } — error is null on success, or { statusCode, name, message } on failure, so there are no exceptions to catch for API errors.

npm install sendping

import { SendPing } from 'sendping';

const mb = new SendPing('mb_xxxxxxxxx');

const { data, error } = await mb.emails.send({
  from: 'Acme <hello@yourdomain.com>',
  to: ['delivered@test.sendping.co'],
  subject: 'Hello from SendPing',
  html: '<p>Your first email 🎉</p>',
});

if (error) console.error(error.name, error.message);
else console.log('sent', data.id);

The client exposes one property per resource — emails (with nested emails.receiving), batch, domains, audiences, contacts, contactProperties, campaigns, segments, topics, templates, automations, webhooks, logs, events, apiKeys, and polls — each modeled on the same create / get / list / update shape used throughout these docs.

const mb = new SendPing('mb_xxxxxxxxx', {
  baseUrl: 'https://www.sendping.co/api', // optional — defaults to the SendPing host
});

Call the REST API directly

Every endpoint in these docs is plain JSON over HTTPS at https://www.sendping.co/api. Authenticate with an Authorization: Bearer mb_xxxxxxxxx header. Each API page shows ready-to-run snippets for every official SDK plus raw cURL.

import { SendPing } from 'sendping';

const mb = new SendPing('mb_xxxxxxxxx');

const { data, error } = await mb.emails.send({
  "from": "Acme <hello@yourdomain.com>",
  "to": ["delivered@test.sendping.co"],
  "subject": "Hello from SendPing",
  "html": "<p>It works!</p>"
});
console.log({ data, error });

Any HTTP client works

Prefer no dependency? The API is plain JSON over HTTPS, so the standard HTTP client in any language can call it directly. Point your client at https://www.sendping.co/api with your mb_ key and send a request:

• Node.js — the official sendping SDK, or the built-in fetch.
• PHP — the official sendping/sendping package, or Guzzle / the cURL extension.
• Python — the official sendping package, or requests / httpx.
• Ruby — the official sendping gem, or Net::HTTP / Faraday.
• Go — the official Go module, or net/http.
• Java — the official co.sendping:sendping artifact, or java.net.http.HttpClient.
• Rust — the official sendping crate, or reqwest.
• .NET — the official SendPing NuGet package, or HttpClient.

Each API reference page includes ready-to-run snippets for every official SDK — Node.js, Ruby, PHP, Python, Go, Rust, Java, .NET, the CLI — plus raw cURL, so your stack's tab is one click away.

Which should I use?