Developer docs

Send your first email in minutes

A UK-built and hosted email relay with SDKs for every major language. Clean REST API, automatic retries and real-time analytics out of the box.

Start buildingAPI reference

Quickstart

Install, send, verify — three steps.

Official SDKs

Six typed ways to call the relay.

API reference

Endpoints and auth at a glance.

01 · Quickstart

Quickstart

Pick your language and start sending emails in three steps.

1

Install the SDK

pip install maielr
shell
2

Send your first email

from maielr import Maielr as Senthop

client = Senthop("maielr_your_api_key")

result = client.email.send(
    from_email="[email protected]",
    to=["[email protected]"],
    subject="Hello from Senthop",
    html="<h1>Welcome!</h1><p>Your first email via Senthop.</p>",
)

print(result["success"], result["message_id"])
python
3

Check delivery status

View real-time delivery status, open tracking, and click analytics in your dashboard, or query the API:

GET /v1/email/{message_id}

→ { "message": { "status": "delivered", "delivered_at": "..." }, "events": [...] }
http

02 · SDKs

Official SDKs

Typed clients for your preferred language. Every SDK includes automatic retries and clear error handling.

03 · Reference

API reference

RESTful API with JSON request/response bodies. All endpoints use Bearer token authentication.

Email sending

POST/v1/email/sendSend an email
GET/v1/email/:idGet message status
GET/v1/emailList messages
GET/v1/rate-limitCheck rate limits

Analytics & tracking

GET/api/relay/analytics/overviewSummary metrics
GET/api/relay/analytics/timeseriesDaily timeseries
GET/api/relay/tracking/summaryOpen & click rates
GET/api/relay/events/streamReal-time events

Deliverability

GET/api/relay/bounces/healthBounce health
GET/api/relay/bounces/trendsBounce trends
GET/api/relay/spam/healthSpam analysis
GET/api/relay/suppressions/exportExport suppressions

Configuration

POST/domainsAdd sending domain
POST/api/relay/webhooksCreate webhook
POST/api/relay/templatesCreate template
GET/api/relay/providersProvider intelligence

Authentication

All API requests require a Bearer token. Create an API key in your dashboard.

curl -H "Authorization: Bearer maielr_your_api_key" \
     https://relay.senthop.co.uk/v1/email
shell