Python

SendPing ships an official Python SDK — see Send emails with Python for the pip install sendping path — but you do not need it: this guide sends email by POSTing JSON to https://www.sendping.co/api/emails. The examples below use the popular `requests` library, but any HTTP client (including the stdlib urllib) works.

Prerequisites

• A SendPing API key.
• A verified domain to send from.
• Python 3.8 or newer if you install the official sendping package (it declares requires-python >= 3.8). The requests example below runs on older interpreters too.

1. Install an HTTP client

pip install requests

2. Set your API key

Read your key from the environment so it never lives in source.

SENDPING_API_KEY=mb_xxxxxxxxx

3. Send email using HTML

The easiest way to send an email is with the html field.

import os
import requests

res = requests.post(
    "https://www.sendping.co/api/emails",
    headers={"Authorization": f"Bearer {os.environ['SENDPING_API_KEY']}"},
    json={
        "from": "Acme <onboarding@yourdomain.com>",
        "to": ["delivered@test.sendping.co"],
        "subject": "hello world",
        "html": "<strong>it works!</strong>",
    },
)
res.raise_for_status()
print(res.json()["id"])