Firma.dev API v1.5.0: Email Validation Warnings

Firma.dev API v1.5.0 is now live. This patch release introduces Email Validation Warnings, a small addition that helps you catch bad email addresses before they cause delivery failures.

What's New

When you create or update a signing request, the API now checks recipient email addresses for potentially invalid formats. If something looks off, you'll get a warning in the response.

The request still succeeds. You just get a heads-up.

Affected endpoints:

Example response:

{
  "signing_request": { ... },
  "warnings": [
    "Recipient email 'user@compny' may have an invalid format"
  ]
}

{
  "signing_request": { ... },
  "warnings": [
    "Recipient email 'user@compny' may have an invalid format"
  ]
}

{
  "signing_request": { ... },
  "warnings": [
    "Recipient email 'user@compny' may have an invalid format"
  ]
}

The validation catches common issues like unusual TLDs, missing dots, and obvious typos. It won't block legitimate edge cases, but it will flag the ones most likely to bounce.

Why This Matters

Email typos are one of the most common reasons signing requests fail to reach recipients. A missing letter, a swapped domain, a copy-paste error. The document gets sent, nothing happens, and someone opens a support ticket asking why their customer never received it.

With email validation warnings, you can surface these issues to your users before the request goes out. Display the warning in your UI, prompt them to double-check, and avoid the back-and-forth.

Migration Guide

No breaking changes. Email validation warnings are purely additive. If you're already integrated with Firma.dev, your code will continue to work exactly as before. The warnings field simply appears in responses when applicable.

To take advantage of the feature, check for the warnings array (or warning field on PATCH) in your response handling and surface any messages to your users.

Get Started

If you're already using Firma.dev, you're all set. The feature is live on all signing request endpoints.

New to Firma.dev? You can get your API key and start building in minutes. Pay-as-you-go pricing at $0.029 per envelope, no contracts or minimums.

Get started for free

For the full changelog, see the API documentation.