To connect the Blogs API, grant secure access using OAuth 2.0 with the scope emails/builder.readonly. Store tokens securely and rotate credentials regularly to maintain a trusted connection.
Authorize NationBuilder to communicate with the Blogs API by completing the OAuth flow, selecting required scopes, and securely storing access tokens for automated syncing.
Core endpoints covered include: GET emails/builder, POST emails/builder, POST /emails/builder/data, DELETE /emails/builder/:locationId/:templateId, GET emails/schedule, GET /blogs/posts/url-slug-exists, GET /blogs/categories, GET /blogs/authors, GET /blogs/categories, blogs/post.write, POST /blogs/posts, PUT /blogs/posts/:postId, GET /blogs/posts/url-slug-exists, GET /blogs/authors
Trigger: Created or updated email templates in NationBuilder.
Actions: Create or update email templates in Blogs API via POST /emails/builder and keep templates in sync.
POST /emails/builder
templateId, name, subject, htmlBody
Trigger: New or updated blog posts in NationBuilder.
Actions: Create posts in Blogs API with POST /blogs/posts; update with PUT /blogs/posts/:postId.
POST /blogs/posts
title, slug, content, authorId, categoryIds, status
Trigger: Slug validation is required before publish.
Actions: Validate slug via GET /blogs/posts/url-slug-exists; assign categories via GET /blogs/categories and author via GET /blogs/authors.
GET /blogs/posts/url-slug-exists
slug, postId
Faster setup with drag-and-drop workflows and automated data sync.
Unified data across platforms enables richer analytics and reporting.
No coding required to automate common publishing and email tasks.
This section defines the data elements, triggers, actions, and processes used to connect the Blogs API with NationBuilder, including endpoints, fields, and mappings.
An interface that lets two systems exchange data and commands.
A URL-friendly string derived from a post title used for SEO and linking.
A specific URL and function you can call in an API to perform an action.
A real-time notification mechanism that fires a payload to another app when an event occurs.
Obtain OAuth credentials, authorize the connection, and securely store tokens.
Map NationBuilder events to Blogs API endpoints such as GET emails/builder, POST /blogs/posts, and GET /blogs/posts/url-slug-exists.
Run end-to-end tests, verify mappings, monitor logs, and deploy.
Authentication requires setting up OAuth credentials for both Blogs API and NationBuilder, choosing the scope emails/builder.readonly, and securely storing tokens. Follow the on-screen prompts to authorize the connection and test the link before going live. If permissions are missing, update your app settings and reauthorize.
This integration supports core endpoints such as GET emails/builder, POST /emails/builder, POST /emails/builder/data, GET /blogs/posts/url-slug-exists, GET /blogs/categories, GET /blogs/authors. Additional endpoints like PUT /blogs/posts/:postId and DELETE /emails/builder/:locationId/:templateId can be used for updates and cleanup. Review the endpoint list to map your workflows.
Yes. You can set up automated publishing and content syncing so that new or updated posts in NationBuilder flow to Blogs API without manual steps. Use triggers and actions to keep content in sync and published on schedule.
Email templates can be created, updated, and synced between NationBuilder and Blogs API. Use the POST /emails/builder endpoint to push templates and the GET /emails/schedule for scheduling sends.
Slug existence can be checked with GET /blogs/posts/url-slug-exists. If the slug exists, you can adjust the title or slug and retry. This prevents duplicate URLs and keeps SEO intact.
End users can map authors and categories using GET /blogs/authors and GET /blogs/categories. You can assign posts to authors and categories during creation or updates via PUT /blogs/posts/:postId.
Logs and errors are surfaced in the connected app’s dashboard and can be exported. Enable webhook notifications and review error messages to diagnose and fix issues quickly.
Due to high volume, we will be upgrading our server soon!
Complete Operations Catalog - 126 Actions & Triggers
