> ## Documentation Index
> Fetch the complete documentation index at: https://docs.paubox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Install the Paubox Ruby gem and send your first HIPAA-compliant email in minutes.

<Steps>
  <Step title="Install the gem">
    Add to your Gemfile:

    ```ruby theme={null}
    gem 'paubox'
    ```

    Then install:

    ```bash theme={null}
    bundle install
    ```

    Or install directly:

    ```bash theme={null}
    gem install paubox
    ```
  </Step>

  <Step title="Configure credentials">
    ```ruby theme={null}
    require 'paubox'

    Paubox.configure do |config|
      config.api_key  = ENV['PAUBOX_API_KEY']
      config.api_user = ENV['PAUBOX_API_USER']
    end
    ```

    To obtain credentials, see [Authentication](/ruby-sdk/authentication).
  </Step>

  <Step title="Send your first email">
    ```ruby theme={null}
    client = Paubox::Client.new

    message = Paubox::Message.new(
      from:         'sender@yourdomain.com',
      to:           ['recipient@example.com'],
      subject:      'Your first Paubox email',
      text_content: 'This message was sent with the Paubox Ruby SDK.'
    )

    response = client.send_mail(message)

    puts "Sent. Tracking ID: #{response[:source_tracking_id]}"
    ```
  </Step>

  <Step title="Check delivery status">
    ```ruby theme={null}
    tracking_id = response[:source_tracking_id]
    disposition = client.email_disposition(tracking_id)

    disposition.message_deliveries.each do |delivery|
      puts "#{delivery.recipient} → #{delivery.status.delivery_status}"
    end
    ```
  </Step>
</Steps>

## Next steps

* [Email client](/ruby-sdk/email-client): attachments, dynamic templates, error handling
* [Forms client](/ruby-sdk/forms-client): retrieve form schemas and submit responses