Access is invite-only during beta. Once invited, create a key to personalize these examples. Production sending requires a separate review.
SDKs
Install a language client from GitHub and call emails.send.
PostShiba ships language clients in postshiba/sdks. Install from GitHub. Mail adapters live in the language package. There is no separate Laravel repo. The API reference stays curl.
Open pull requests on the monorepo. Language repos are one-way mirrors.
Install
- Node.js:
npm install github:postshiba/postshiba-node - Python:
pip install git+https://github.com/postshiba/postshiba-python.git - Ruby:
gem "postshiba", git: "https://github.com/postshiba/postshiba-ruby.git" - PHP: Composer VCS require of
postshiba/postshibafromhttps://github.com/postshiba/postshiba-php - Go:
go get github.com/postshiba/postshiba-go - Java: clone postshiba/postshiba-java and
./mvnw install - Rust:
postshiba = { git = "https://github.com/postshiba/postshiba-rust" } - .NET: clone postshiba/postshiba-dotnet and project-reference
src/PostShiba/PostShiba.csproj - Elixir:
{:postshiba, git: "https://github.com/postshiba/postshiba-elixir.git"} - Dart: git url
https://github.com/postshiba/postshiba-dart.git
Mailers
- Rails:
delivery_method = :postshiba - Laravel:
MAIL_MAILER=postshiba - Django:
EMAIL_BACKEND = "postshiba.django.EmailBackend" - NestJS:
PostShibaModuleandsendMail - Phoenix:
PostShiba.Swoosh.Adapter
Plugins
- WordPress: install from GitHub,
wp_mail
Components
- Convex:
npm install github:postshiba/postshiba-convex - Inngest:
npm install github:postshiba/postshiba-inngest - Trigger.dev:
npm install github:postshiba/postshiba-trigger
Errors and throttling
Failed REST calls return {error, field, message}. Language clients raise a typed error with those fields. A 429 with error throttled is the cluster hourly throttle or 24-hour cap. Do not retry that send immediately. See Errors.