.NET

dotnet add package Formable

using Formable;

using var formable = new FormableClient(Environment.GetEnvironmentVariable("FORMABLE_API_KEY"));

var created = await formable.Templates.CreateAsync(
    "nda.docx",
    [
        new TemplateSignerRole("Client", 0),
        new TemplateSignerRole("Witness", 1),
    ]);

string templateId = created.TemplateId;

// Mint a fresh edit URL later (expires after 1 day)
var edit = await formable.Templates.CreateEditUrlAsync(templateId);

// Formable emails each signer a signing link
var request = await formable.SignatureRequests.CreateAsync(
    new CreateSignatureRequest(
        templateId,
        [
            new Signer("jane@example.com", "Jane Doe", "Client"),
            new Signer("bob@example.com", "Bob Smith", "Witness"),
        ]));

// Embedded flow: mint signing URLs to embed in an iframe yourself
var embedded = await formable.SignatureRequests.CreateEmbeddedAsync(
    new CreateSignatureRequest(
        templateId,
        [new Signer("jane@example.com", "Jane Doe", "Client")],
        TestMode: true));

var signer = embedded.Signers[0];
var signing = await formable.SignatureRequests.CreateSigningUrlAsync(signer.RecipientSignatureId);

// Track progress
var current = await formable.SignatureRequests.GetAsync(embedded.SignatureRequestId);
var all = await formable.SignatureRequests.ListAsync(DateTimeOffset.Parse("2026-01-01T00:00:00Z"));
var events = await formable.SignatureRequests.GetEventsAsync(embedded.SignatureRequestId);

// Download the signed document once completed
var envelope = await formable.SignatureRequests.GetSignedEnvelopeAsync(embedded.SignatureRequestId);

var created = await formable.RedlineRequests.CreateAsync(
    new CreateRedlineRequest(
        templateId,
        [
            new RedlineMember("us@example.com", "John Doe", RedlineMemberRole.DisclosingParty),
            new RedlineMember("them@example.com", "Jane Smith", RedlineMemberRole.ReceivingParty),
        ],
        Metadata: new RedlineRequestMetadata("Mutual NDA")));

string redlineRequestId = created.RedlineRequestId;

// Mint a redline URL for a member (embed in an iframe)
var url = await formable.RedlineRequests.CreateUrlAsync(redlineRequestId, "them@example.com");

// Manage members and track progress
await formable.RedlineRequests.UpdateMembersAsync(
    redlineRequestId,
    [new RedlineMember("counsel@example.com", "Counsel", RedlineMemberRole.ReceivingCounsel)]);
var redline = await formable.RedlineRequests.GetAsync(redlineRequestId);
var events = await formable.RedlineRequests.GetEventsAsync(redlineRequestId);

var billing = await formable.BillingAsync();
var health = await formable.HealthAsync();

try
{
    await formable.SignatureRequests.GetAsync("missing-id");
}
catch (FormableException error)
{
    Console.Error.WriteLine($"{error.Status} {error.Message}");
}

using Formable;

using var formable = new FormableClient(
    new FormableOptions
    {
        ApiKey = Environment.GetEnvironmentVariable("FORMABLE_API_KEY"),
        BaseUrl = "https://api.formabledocs.com/v1",
        Timeout = TimeSpan.FromSeconds(60),
        HttpClient = httpClient,
    });