We’re thrilled to announce the official launch of NationBuilder API v2! After months of fine-tuning in a closed beta, this new API version is ready to empower developers, integrators, and creators like never before. Built on the JSON:API framework, API v2 is designed to provide you with unmatched flexibility, security, and efficiency, making it easier than ever to build powerful integrations and applications on the NationBuilder platform.
Flexibility at Your Fingertips
With API v2, you’re not just interacting with data—you’re mastering it. The ability to append filters as URL parameters allows you to pinpoint exactly the data you need, without wading through irrelevant results. Need to focus on a specific segment of your supporters? Simply append the appropriate filters to your API request, and retrieve only what’s necessary.
Moreover, sparse field definition in API v2 means you can keep it simple by specifying which fields are returned in your response. This ensures your applications remain lightweight and responsive, as you’re only handling the data you actually need.
Unlocking New Levels of Integration
API v2 is more than an upgrade; it’s a reimagining of what’s possible. With Sideposting, you can now interact with multiple objects in a single request. For instance, if your membership platform needs to add a new person, their membership details, and a donation record, you can do it all in one seamless request. Sideloading enhances your data retrieval process by allowing you to gather related objects simultaneously. Imagine pulling a list of people and their logged contacts in one go—now that’s efficiency.
These features aren’t just about saving time; they’re about unlocking new integration possibilities that were previously out of reach. Whether you’re building a comprehensive dashboard, automating workflows, or syncing complex datasets, API v2 equips you with the tools to make it happen.
Efficient, Scalable, and Secure
Handling large datasets? API v2 introduces several improvements to ensure your applications are both efficient and scalable. Flexible filtering and the ability to return count totals both help to reduce the amount of API requests you need to send in order to get the needed information.
Sorting capabilities have also been enhanced, giving you control over how your data is presented. Whether you need results ordered alphabetically by last name, sorted by the most recently updated records, or by some other attribute, API v2 has you covered.
Security is at the forefront of API v2, with the introduction of v2 API tokens that expire every 24 hours. This not only ensures that access to your data remains secure but also introduces a new standard in API security with a refresh flow that allows you to systematically renew tokens.
Expanding the Horizon of What’s Possible
API v2 isn’t just about doing what you’ve always done—better. It’s about enabling new ways to work with NationBuilder. With new endpoints for previously inaccessible objects like paths, path journeys, signup taggings, relationships, automations and more, the possibilities are endless. These enhancements make even familiar endpoints more powerful and versatile, providing you with a solid foundation for innovation.
The Future of the NationBuilder API
This launch is just the beginning. Our commitment to continuous improvement means that we’ll be developing new API endpoints alongside feature development, ensuring that API v2 evolves in step with the NationBuilder platform. Where there is an equivalent v2 API endpoint, the v1 endpoint is no longer under maintenance and our focus is to make the API v2 as flexible and performant as possible. A new documentation system will auto-document these endpoints, making it easier for you to stay up-to-date with the latest capabilities and features. To learn about how to migrate existing v1 tokens to v2 tokens, read more here.
We can’t wait to see what you build with NationBuilder API v2. The future of your integrations and applications starts now—let’s unlock it together.
