Skip to content
Pidgely Docs

Get started

Introduction

Pidgely is an email API for developers that delivers through its own MTA. Official SDKs for Node.js, Python, PHP, Go and Ruby, SMTP relay and signed webhooks.

View as Markdown

Pidgely is an email API for developers. Send transactional and broadcast email with the official SDKs for Node.js, Python, PHP, Go and Ruby, with plain HTTP, or through SMTP. Already sending with another provider? The API follows the conventions you know, so migrating is mostly a configuration change.

Behind the API, Pidgely runs its own MTA. It signs DKIM per domain, aligns SPF through a return-path subdomain, separates transactional and broadcast traffic into their own IP pools, warms new IPs up gradually and processes bounces and complaints itself.

Start here

  • Quickstart: verify a domain and send your first email in a couple of minutes, in Node.js, Python, PHP, Go, Ruby or cURL.
  • SDKs: install and configure the official SDK for your language.
  • Migrate from Resend: move existing code and data over, plus the differences worth knowing.
  • API reference: every endpoint, generated from the OpenAPI 3.1 document.

What you can do

Capability Where to read
Send transactional email: single, batch of up to 100, scheduled with natural language (in 1 hour), attachments from base64 or a URL Sending email
Authenticate your domain with DKIM, an aligned return path (SPF) and DMARC Domains & DNS
Store reusable templates with typed variables, drafts and published versions Templates
Manage contacts and segments, send broadcasts with personalization and one-click unsubscribe Contacts, Broadcasts
Receive signed webhooks for deliveries, bounces, complaints and contact changes Webhooks
Send through SMTP from any framework (smtp.pidgely.com) SMTP relay
Keep bad addresses out automatically with the suppression list Suppressions

What is not available yet

So that nothing misbehaves silently, these features are either rejected or documented as inert:

  • Open and click tracking. The flags are accepted and always reported as false; email.opened and email.clicked webhooks never fire.
  • Inbound email (receiving domains, inboxes, email.received).
  • Automations, topics, contact imports, logs and a few other endpoints listed in Migrate from Resend.

Basics

  • Base URL: https://api.pidgely.com
  • Authentication: Authorization: Bearer pdg_<prefix>_<secret> (Authentication)
  • Format: JSON request and response bodies, UTF-8
  • Errors: {"statusCode", "name", "message"} (Errors)
  • Lists: cursor pagination with limit, after and before (Pagination)

For AI assistants and agents

Every page of these docs is also available as plain Markdown: add .md to the URL (for example /quickstart.md) or use the Copy page as Markdown button. /llms.txt indexes all pages and /llms-full.txt contains all of them in one file. The MCP server (preview) lets agents send email and manage resources directly.