Skip to main content

gRPC

For high-performance applications, you can connect directly to our HTTP/2 gRPC API.

Connection Details

Address
string
api.simpleemailapi.dev:443
Service
string
v1.EmailService
Method
string
SendEmail

Authentication

Pass your api key in the Authorization metadata header.
Authorization: Bearer sea_live_...

Example (buf curl)

Use buf curl to invoke RPCs using the remote schema registry—no manual proto downloads required.
buf curl \
  --schema buf.build/simpleemailapi/public \
  --header "Authorization: Bearer sea_live_..." \
  --data '{
    "from": "[email protected]",
    "to": ["[email protected]"],
    "subject": "Hello gRPC",
    "body": "Sent via direct buf curl!",
    "async": true
  }' \
  https://api.simpleemailapi.dev/v1.EmailService/SendEmail

Protobuf Definitions

You can generate clients for any language (Go, Java, Python, C++, etc.) using our Protobuf definitions available on the Buf Registry (BSR).
# Example: Inspecting the service with reflection
grpcurl \
  -H "Authorization: Bearer sea_live_..." \
  api.simpleemailapi.dev:443 \
  describe v1.EmailService