Charchy Senddocs

Changelog

Changes to the Charchy Send API and these docs, newest first.

Within v1 we never rename an error code or remove a field. New fields and events may appear at any time — ignore fields your code doesn't know.

November 17, 2026 — Guides

November 2026 — @charchy/send 0.1.0

The Node.js and TypeScript SDK: every endpoint, retries that never send twice, and webhook verification.

November 2026 — v1, invite-only

The first version of the API.

  • POST /v1/emails, POST /v1/emails/batch (up to 100 emails).
  • GET /v1/emails/{id}, GET /v1/emails, PATCH /v1/emails/{id}, POST /v1/emails/{id}/cancel.
  • POST /v1/images for hosted images, and GET /v1/usage for your plan, credits, daily cap and limits.
  • to, cc, bcc and reply_to take one address or an array; tags take an object or an array of { name, value } pairs.
  • List-Unsubscribe and List-Unsubscribe-Post allowed as custom headers.
  • scheduled_at up to 30 days ahead, and expires_at for time-sensitive emails.
  • Idempotency-Key on every endpoint that sends (400 invalid_idempotency_key for a malformed one).
  • Test keys and the @sim.charchy.krd magic addresses.
  • Webhooks signed with the Standard Webhooks spec.
  • Docs at charchy.krd/docs, with llms.txt, a Markdown copy of every page, and an OpenAPI file.

Coming next

  • /v1/domains, /v1/webhooks and /v1/suppressions, so you can set up a workspace without the dashboard.

On this page