Introducing Verifalia API v2.7: Powerful Team Management Features for Developers

After months of intensive development, we're excited to announce the release of version 2.7 of our email verification API: this major update includes 14 new endpoints and a completely redesigned authorization backend, making it our most significant API enhancement to date. 😉

The centerpiece of this release is comprehensive team management support, enabling you to programmatically create users and browser applications: this feature is perfect for developers who need to segment their Verifalia usage or those building solutions that resell our email verification services.

Let's dive into what's new!

Team Management API

Version 2.7 introduces full CRUD operations for managing administrators, standard users, and browser apps. Also, you can now programmatically adjust configuration settings including:

• authentication methods;
• authorization and access rules;
• CAPTCHA enforcement preferences for email verification requests;
• default settings like data retention policies;
• API request firewall rules;
• rate-limiting settings for email verification jobs;
• trusted HTTP origins enforcement preferences.

Getting started is straightforward! Here's a simple example that demonstrates creating a new user with cURL:

curl -u username:password \
     -H 'Content-Type: application/json' \
     -d '{
       "authentication": {
         "password": {
           "isEnabled": true,
           "username": "heisenberg",
           "password": "c10h15n!"
         }
       },
       "authorization": {
         "rules": [
           "email-verifications:*:own",
           "credits:read-balance"
         ]
       },
       "displayName": "Walter White",
       "isActive": true,
       "type": "Standard"
     }' \
     https://api.verifalia.com/v2.7/users

This example creates a standard user with password authentication, limited to managing their own email verifications and viewing credit balance.

To learn more, please see the detailed documentation on our user management API.

X.509 Client Certificates API

Security-conscious developers will appreciate our new client certificate management capabilities: you can now create, retrieve, and delete X.509 client certificates used for TLS mutual authentication (also known as Client Certificate Authentication). This feature provides the highest level of security when authenticating against our API.

To learn more about our client certificate API, please see the detailed documentation.

Contact Methods API

The new API allows complete management of contact methods for each user. You can create, retrieve, update, list, and delete contact preferences to control notifications from our system, including alerts for expiring client certificates, commercial document updates, and news.

For more information, please see the reference documentation.

Enhanced Authorization System

We've completely redesigned our authorization framework to make permission management more intuitive and flexible. The upgraded system features:

• support for distinct user types (Administrator, Standard and BrowserApp);
• over 50 fine-grained permissions for granular access control;
• customizable user interaction models.

The new authorization system extends to our bearer authentication as well. JWT tokens issued by our authentication endpoint now include custom claims that you can inspect at runtime to determine a user's specific permissions. This enables you to build adaptive frontends that automatically adjust their interface based on the logged-in user's access level.

For more details on our core concepts and authorization system, see the reference documentation.

Wrap Up

We're incredibly excited about these new capabilities and believe they'll significantly enhance your development experience with Verifalia. The team management features open up new possibilities for enterprise integrations, reseller solutions, and complex multi-user applications.

Ready to get started with API v2.7? The new endpoints are available immediately, and our documentation has been updated with comprehensive examples and use cases. Whether you're building the next great SaaS platform or simply need better control over your team's email verification workflows, these features are designed to scale with your needs.

Have questions about the new features or need help implementing them in your project? We'd love to hear from you! Our developer support team is standing by to help you make the most of these powerful new capabilities. Don't hesitate to reach out - we're here to ensure your integration is smooth and successful.