> ## 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

> Add the Paubox C# SDK and send your first HIPAA-compliant email in minutes.

<Steps>
  <Step title="Add the DLL reference">
    Download or clone the SDK repository, then add `lib/Paubox.Email.API.dll` as a reference in your project.

    In Visual Studio: right-click your project → **Add** → **Reference** → **Browse** → select `Paubox.Email.API.dll`.

    Or in your `.csproj`:

    ```xml theme={null}
    <ItemGroup>
      <Reference Include="Paubox.Email.API">
        <HintPath>lib\Paubox.Email.API.dll</HintPath>
      </Reference>
    </ItemGroup>
    ```
  </Step>

  <Step title="Instantiate the client">
    Pass your API key and username directly to the constructor:

    ```csharp theme={null}
    using Paubox;

    var emailLib = new EmailLibrary("YOUR_API_KEY", "YOUR_USERNAME");
    ```

    For ASP.NET Core applications, see [Authentication](/csharp-sdk/authentication) for the `IConfiguration` approach.
  </Step>

  <Step title="Send your first email">
    ```csharp theme={null}
    var message = new Message
    {
        Recipients = new[] { "recipient@example.com" },
        Header = new Header
        {
            From    = "sender@yourdomain.com",
            Subject = "Your first Paubox email"
        },
        Content = new Content
        {
            PlainText = "This message was sent with the Paubox C# SDK."
        }
    };

    SendMessageResponse response = emailLib.SendMessage(message);

    Console.WriteLine("Sent. Tracking ID: " + response.SourceTrackingId);
    ```
  </Step>

  <Step title="Check delivery status">
    ```csharp theme={null}
    GetEmailDispositionResponse disposition =
        emailLib.GetEmailDisposition(response.SourceTrackingId);

    foreach (var delivery in disposition.Data.Message.MessageDeliveries)
    {
        Console.WriteLine($"{delivery.Recipient} → {delivery.Status.DeliveryStatus}");
    }
    ```
  </Step>
</Steps>

## Next steps

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