# Charchy Send > Charchy Send (Namabar) is Charchy's transactional email API: an app's server calls POST https://api.charchy.krd/v1/emails to send sign-in codes, password resets, receipts and order updates from its own verified domain, DKIM-signed. Keys: chy_test_ (free, never sends) and chy_live_. Webhooks follow the Standard Webhooks spec. Marketing email is not allowed on this API. Every page below is Markdown. The whole docs in one file: https://charchy.krd/llms-full.txt. The OpenAPI 3.1 file: https://charchy.krd/docs/openapi.yaml. ## Docs - [Charchy Send](https://charchy.krd/docs.md): Transactional email for your app — sign-in codes, password resets, receipts and order updates — sent from your own domain. - [Sending emails](https://charchy.krd/docs/sending-emails.md): Which emails go through Charchy Send, which go through Charchy Campaigns, and how to tell. - [Quickstart](https://charchy.krd/docs/quickstart.md): Send your first email in five minutes with a test key — curl, Node/TypeScript, Laravel, Python or Go. - [SDKs](https://charchy.krd/docs/sdks.md): Official Charchy Send libraries. Node and TypeScript today; any language works with plain HTTP. - [Node.js and TypeScript](https://charchy.krd/docs/sdks/node.md): @charchy/send — the official SDK: typed, zero dependencies, retries that never send twice, a one-line webhook endpoint and end-to-end test helpers. Node 18+, Bun, Deno, Vercel Edge and Cloudflare Workers. - [Build with AI](https://charchy.krd/docs/build-with-ai.md): A ready prompt for your coding agent per stack, and these docs as Markdown for any AI tool — llms.txt, llms-full.txt and a .md copy of every page. - [Pricing](https://charchy.krd/docs/pricing.md): Monthly plans from $9, or pay-as-you-go credits at $0.45 per 1,000 emails. Prepaid. Test mode is free. - [Request access](https://charchy.krd/docs/request-access.md): Charchy Send is invite-only. Tell us about your app; we answer within a business day. - [Send an email](https://charchy.krd/docs/send-email.md): POST /v1/emails — every field, what we check, what you get back, and how to read an email's status later. - [Batch](https://charchy.krd/docs/batch.md): POST /v1/emails/batch — up to 100 emails in one request, checked all-or-nothing. - [Scheduling and expiry](https://charchy.krd/docs/scheduling.md): Send later with scheduled_at, change or cancel it before it leaves, and let time-sensitive emails expire with expires_at. - [Idempotency](https://charchy.krd/docs/idempotency.md): Send an Idempotency-Key on every request, so a retry never sends an email twice. - [Logos, images and attachments](https://charchy.krd/docs/images-and-attachments.md): Three ways to put a logo, an image or a file in an email — hosted images, inline images and attachments — and when to use each. - [Tags and headers](https://charchy.krd/docs/tags-and-headers.md): Label emails with tags to find them and route their webhooks, and add your own email headers. - [Test mode](https://charchy.krd/docs/test-mode.md): Test keys and the @sim.charchy.krd magic addresses — build, test and run CI without sending a real email or spending a credit. - [Domains and DNS](https://charchy.krd/docs/domains.md): Verify your sending domain with three DKIM records and a DMARC record — or one click with Cloudflare — and avoid the two classic DNS mistakes. - [Cloudflare](https://charchy.krd/docs/domains/cloudflare.md): Add Charchy Send's DNS records on Cloudflare — in one click with Add with Cloudflare, or by hand. - [Hostinger](https://charchy.krd/docs/domains/hostinger.md): Add Charchy Send's DNS records in Hostinger's hPanel. - [GoDaddy](https://charchy.krd/docs/domains/godaddy.md): Add Charchy Send's DNS records in GoDaddy's DNS management. - [Namecheap](https://charchy.krd/docs/domains/namecheap.md): Add Charchy Send's DNS records in Namecheap's Advanced DNS. - [Route 53](https://charchy.krd/docs/domains/route-53.md): Add Charchy Send's DNS records in an Amazon Route 53 hosted zone. - [Vercel](https://charchy.krd/docs/domains/vercel.md): Add Charchy Send's DNS records in Vercel DNS — in the dashboard or with the Vercel CLI. - [API keys and security](https://charchy.krd/docs/api-keys.md): Test and live keys, full and sending-only permission, locking a key to a domain, keeping keys on the server — and what to do if one leaks. - [Webhooks](https://charchy.krd/docs/webhooks.md): Signed events to your server when an email is delivered, bounces or fails — the events, the payload, and how to verify the signature in Node, Laravel, Python and Go. - [Events reference](https://charchy.krd/docs/events.md): One full payload example for every webhook event — email, domain and account events. - [Next.js](https://charchy.krd/docs/guides/nextjs.md): Send email from a Next.js App Router app — a Server Action, a Route Handler, React Email, a one-line webhook endpoint, and an end-to-end check with the magic addresses. - [Convex](https://charchy.krd/docs/guides/convex.md): Send email from Convex — scheduled from the mutation that writes the record, so it goes only if the write commits; an action with an idempotency key and retries; webhooks into an HTTP action; and sign-in codes with Better Auth on Convex. - [Sign-in codes with Better Auth](https://charchy.krd/docs/guides/better-auth.md): Send Better Auth's one-time codes, magic links, verification emails and password resets through Charchy Send, with expiring codes, idempotency keys and sending after the response. - [Supabase Auth emails](https://charchy.krd/docs/guides/supabase.md): Send Supabase Auth's sign-up, magic link, recovery, invite, email change and reauthentication emails through Charchy Send with the Send Email Hook — an Edge Function, no SMTP. - [Laravel](https://charchy.krd/docs/guides/laravel.md): Send from Laravel through Charchy Send — a small client on the Http facade, sign-in codes that expire, receipts from queued jobs, a mail transport for your Mailables and notifications, and a verified webhook route. - [Testing in CI](https://charchy.krd/docs/guides/testing-in-ci.md): Run real end-to-end email tests in CI with a test key and the magic addresses — free, no inbox, no real email. - [What counts as transactional](https://charchy.krd/docs/transactional.md): Charchy Send is for email a person's own action triggers. What that includes, what it doesn't, and how we check. - [Deliverability basics](https://charchy.krd/docs/deliverability.md): How to keep your emails in the inbox — authentication and DMARC, warming up a new domain, and handling bounces and complaints. - [Rate limits and quotas](https://charchy.krd/docs/rate-limits.md): Requests per second, emails per day, and the headers that tell you where you stand. - [Limits](https://charchy.krd/docs/limits.md): Every size and count limit of the API in one table. - [Suppressions](https://charchy.krd/docs/suppressions.md): Addresses we stop sending to after a hard bounce or a spam complaint — why, what you see, and how to remove one. - [Troubleshooting](https://charchy.krd/docs/troubleshooting.md): The common problems and their fixes — a domain that won't verify, domain_not_verified, emails delivered but not received, and keys used from the browser. - [Errors](https://charchy.krd/docs/errors.md): Every error code the API returns, what it means, and whether to retry. Each error's docs link points here. - [Changelog](https://charchy.krd/docs/changelog.md): Changes to the Charchy Send API and these docs, newest first. ## API reference - [API reference](https://charchy.krd/docs/api-reference.md): Every endpoint, field and response of the Charchy Send API, generated from our OpenAPI file. - [Send an email](https://charchy.krd/docs/api-reference/send-email.md): Accepts one email and queues it (or schedules it, with `scheduled_at`). The answer comes back at once; delivery is reported by webhooks and `GET /emails/{id}`. Charged per recipient when accepted, refunded if the email is canceled, expires, is suppressed or fails for good. - [Send a batch](https://charchy.krd/docs/api-reference/send-email-batch.md): Up to 100 emails in one request, without attachments. Validation is all-or-nothing: one invalid email and nothing is sent, with every problem listed by index. Charged once for the whole batch. - [Get an email](https://charchy.krd/docs/api-reference/get-email.md): An email's status, recipients, tags, timestamps and event timeline. Kept for 30 days. Needs a key with full permission. - [List emails](https://charchy.krd/docs/api-reference/list-emails.md): Your workspace's emails of the last 30 days, newest first, with cursor pagination. Needs a key with full permission. - [Reschedule an email](https://charchy.krd/docs/api-reference/reschedule-email.md): Changes `scheduled_at` while the email is still `scheduled`. - [Cancel an email](https://charchy.krd/docs/api-reference/cancel-email.md): Cancels an email that is `scheduled` or `queued`. It is refunded and fires `email.canceled`. - [Upload an image](https://charchy.krd/docs/api-reference/upload-image.md): Hosts an image on files.charchy.krd and returns its permanent public URL, for `` in your emails. PNG, JPEG, GIF or WebP (no SVG), up to 2 MB, up to 200 per workspace. - [Get usage](https://charchy.krd/docs/api-reference/get-usage.md): Where your workspace stands: this term's plan emails, your credits and their expiry, today's cap, the rate limit, and today's test sends. Needs a key with full permission. - [Email events](https://charchy.krd/docs/api-reference/email-event.md): Sent to your endpoint when an email changes state. `type` is one of `email.sent`, `email.delivered`, `email.delivery_delayed`, `email.bounced`, `email.complained`, `email.failed`, `email.suppressed`, `email.expired`, `email.canceled`. One event per recipient for `email.delivered`, `email.delivery_delayed`, `email.bounced`, `email.complained` and `email.suppressed` — `data.recipient` names the address. `email.sent`, `email.failed`, `email.expired` and `email.canceled` come once per email. Emails sent with a test key, and the magic addresses, fire these events too. Signed with the Standard Webhooks spec: verify `webhook-signature` against the raw body, reject timestamps older than 5 minutes, and dedupe by `webhook-id`. Order is not guaranteed. Answer 2xx within 5 seconds; `410 Gone` disables the endpoint. Requests carry `user-agent: Charchy-Webhooks/1.0 (+https://charchy.krd/docs/webhooks)`. - [Domain events](https://charchy.krd/docs/api-reference/domain-event.md): `domain.verified` when a sending domain is verified and ready to send from (again, too, once a domain that lost its records has them back); `domain.failed` when its verification fails — the DKIM records weren't found within 72 hours, or setting the domain up failed — or when a verified domain's records are gone at two daily re-checks a few hours apart. Signed like every event. - [Account events](https://charchy.krd/docs/api-reference/account-event.md): `account.paused` when sending is paused for your workspace (whoever paused it), `account.resumed` when it resumes, and `balance.low` when what you have left falls to 20% of what you had after your last top-up (`used_percent: 80`) and when it reaches zero (`100`) — once each per top-up. A top-up is a plan term starting, or credits added. Signed like every event. - [OpenAPI file](https://charchy.krd/docs/openapi.yaml): the full contract, OpenAPI 3.1 YAML ## Optional - [Charchy Send](https://charchy.krd/docs/ar.md): بريد المعاملات لتطبيقك — رموز تسجيل الدخول، وإعادة تعيين كلمات المرور، والإيصالات، وتحديثات الطلبات — يُرسل من نطاقك الخاص. (العربية) - [أسعار Charchy Send](https://charchy.krd/docs/ar/pricing.md): باقات شهرية تبدأ من ٩ دولارات، أو رصيد مسبق بسعر ٠٫٤٥ دولار لكل ١٬٠٠٠ رسالة. الدفع مسبق. وضع الاختبار مجاني. (العربية) - [اطلب الوصول](https://charchy.krd/docs/ar/request-access.md): Charchy Send بالدعوة فقط. أخبرنا عن تطبيقك؛ نرد خلال يوم عمل. (العربية) - [نامەبەر](https://charchy.krd/docs/ckb.md): ئیمەیڵی مامەڵەیی بۆ ئەپەکەت — کۆدی چوونەژوورەوە، گۆڕینی وشەی نهێنی، پسووڵە و نوێکارییەکانی داواکاری — لە دۆمەینی خۆتەوە دەنێردرێت. (کوردی) - [نرخەکانی نامەبەر](https://charchy.krd/docs/ckb/pricing.md): پلانی مانگانە لە ٩ دۆلارەوە، یان کرێدیت بە ٠٫٤٥ دۆلار بۆ هەر ١٬٠٠٠ ئیمەیڵ. پارەدان پێشوەختەیە. دۆخی تاقیکردنەوە خۆڕاییە. (کوردی) - [داوای دەستگەیشتن](https://charchy.krd/docs/ckb/request-access.md): نامەبەر تەنها بە بانگهێشتە. دەربارەی ئەپەکەت پێمان بڵێ؛ لە ماوەی ڕۆژێکی کاردا وەڵام دەدەینەوە. (کوردی)