# Send emails with Sinatra

Use the Ruby SDK from Sinatra routes or background jobs.

## Install

After RubyGems publishing is available:

```bash
gem install sinatra opensend
```

Until then, build and install the OpenSend gem from `packages/ruby-sdk` in this repository.

## Example

```ruby
require "json"
require "opensend"
require "sinatra"

OpenSend.api_key ENV.fetch("OPENSEND_API_KEY")
OpenSend.base_url ENV.fetch("OPENSEND_BASE_URL", OpenSend::DEFAULT_BASE_URL)

post "/send" do
  content_type :json
  body = JSON.parse(request.body.read)
  email_address = body["email"]

  halt 400, { error: "email is required" }.to_json unless email_address

  email = OpenSend.emails.send(
    from: "OpenSend <onboarding@updates.example.com>",
    to: email_address,
    subject: "Hello from Sinatra",
    html: "<p>Sinatra queued this email.</p>"
  )

  { id: email.fetch("id") }.to_json
end
```

## Notes

- Keep the API key server-side.
- Use a background job library for sends that should not block the request.
- Use idempotency keys when routes can be retried by proxies or clients.