March 2026: Five API Releases, Conditional Logic, and AI Integration

March was Firma.dev's biggest month yet. Five API versions shipped in under four weeks, from v1.8.0 to v1.12.0. Here's what landed.

Smarter Documents

Conditional field logic is the headline feature from v1.10.0. Fields can now be dynamically required or visible based on what signers enter in other fields. A "Spouse Name" field that only appears when someone checks "Married," or a disclosure section that becomes required based on a dropdown selection. Conditions use composable AND/OR logic with 10 comparison operators, and they're enforced server-side so they can't be bypassed.

Anchor tags (v1.11.0) let you auto-place fields on documents using text markers. Embed strings like {{SIGN_HERE}} in your PDF, and Firma.dev converts them into positioned signature fields during creation. Supports up to 100 anchors per request with flexible matching options. If you're generating documents programatically from a CRM or doc tool, this eliminates manual field positioning entirely.

File upload fields are a new field type that lets signers attach files (images or PDFs, up to 10MB) directly during the signing flow. Think ID verification, proof of insurance, or receipts collected alongside a signed agreement. Files are validated by content (magic bytes), not just extension.

Field background colors let you set a hex color on any field to visually highlight it. Useful for color-coding by recipient or drawing attention to fields signers tend to miss.

Document Flexibility

DOCX support landed in v1.10.0. All document upload endpoints now accept Word files alongside PDF. Documents are auto-converted server-side, and no changes are needed for existing PDF-based integrations.

Template document replacement (v1.9.0) lets you swap out a template's PDF or DOCX without losing field placements, signer assignments, or settings. Handy when your legal team updates a contract and you don't want to rebuild the template from scratch.

Security and Verification

Passkey sign-in is live. Users can register up to 10 passkeys (Face ID, Touch ID, Windows Hello, hardware keys) for one-tap login with cloud sync via iCloud Keychain and Google Password Manager.

Signer OTP verification adds an opt-in layer where signers verify their email with a 6-digit code before viewing or signing. Configurable at workspace and signing request level, with a 10-minute expiry and masked email display.

Signature verification frames add a small visual overlay on each signature in completed PDFs showing a truncated signer ID. Configurable at company, workspace, and signing request level. Useful for regulated industries, or you can disable it entirely for white-label scenarios.

Audit trail endpoint (v1.10.0) returns chronological events (created, viewed, signed, declined, downloaded) with timestamps, actor identity, and IP addresses via GET /signing-requests/{id}/audit. Built for compliance reporting and legal evidence packages.

White-Label and Localization

Custom email templates give you full HTML control over all 5 notification emails Firma.dev sends (signing invite, next signer, expired, cancelled, declined). Set them at company or workspace level with dynamic placeholders like {{signer_name}} and {{signing_link}}.

Workspace language settings let you set a default language per workspace to control outgoing emails. Seven languages supported: English, Spanish, Italian, Portuguese, French, German, and Greek.

Developer Tooling

MCP integration (v1.12.0) connects Firma.dev to AI assistants like Claude. Manage templates, create and send signing requests, configure workspaces, and more through natural language. Works with Claude Code, Claude Desktop, and Claude.ai using your existing API key or OAuth. See the MCP integration guide for setup instructions.

Under the Hood

A few more things worth noting from March:

• Legacy captcha fully removed and replaced

• Auto-purchase credit recharge UI refreshed

• Branded expiration pages for expired signing requests

• All new features ship with translations in all 7 supported languages

• Webhook schema now includes consecutive_failures and auto_disabled_at for better observability

• Template GET responses now include inline recipients and fields, reducing extra API calls

• Every release was non-breaking with zero migration required

Coming This Week

PAdES Baseline B-LTA is landing this week. This is a major step for long-term signature validation, giving your signed documents cryptographic proof that remains verifiable for years. More details soon.

Every release since v1.8.0 is fully documented in our API changelog and platform updates. All changes were additive with no breaking changes.

Get started with Firma.dev for free, no credit card required.