Breezy HR

How to integrate Breezy HR with Webflow

Recruiting teams need branded career pages that match their company design while maintaining professional applicant tracking workflows. Breezy HR handles candidate pipelines and application management, while Webflow provides design control and custom layouts. Connecting them lets you display current job openings on your site while routing applications directly into your hiring system.

You can integrate Breezy HR and Webflow through embedded Career Portals, automation platforms that sync data between both APIs, or custom API integrations.

Embed the Career Portal Directly

Breezy HR provides a hosted Career Portal that displays your open positions and handles applications. Access Career Portal settings through Settings > Career Portal in your Breezy HR admin panel. Customize the portal's appearance with your brand colors and logo, then integrate it into Webflow using one of these methods.

Choose your embed approach:

• Direct linking: Add navigation links in Webflow that send visitors to your Breezy HR Career Portal URL (simplest but takes candidates off your domain)
• iFrame embed: Use Webflow's Code Embed element to display the Career Portal within your Webflow page layout (career portal styling is limited; only surrounding Webflow page styling is fully maintained)
• Custom API integration: Fetch job data through the API via automation platforms and display it in Webflow CMS collections for complete design control (requires additional subscription and accepts 2-5 minute sync delays)

The iFrame approach maintains your Webflow page design while Breezy HR handles application processing. Add a Code Embed element to your Webflow page and paste the iFrame code with your Career Portal URL.

Style the container to match your site's design system. This method works for companies that want quick deployment without API complexity, though you'll have limited control over the career portal's internal styling. Note that you must respect rate limits for both platforms when implementing any additional integrations.

Use automation platforms for workflow automation

Automation platforms like n8n and Zoho Flow provide visual workflow builders for connecting Breezy HR and Webflow APIs without writing code. These platforms handle authentication, data transformation, and API polling to sync information between systems. Use them for job posting synchronization, candidate creation from form submissions, and automated status updates between platforms.

Set up workflows for common Webflow + Breezy HR scenarios:

• Sync job postings to Webflow CMS - Poll Breezy HR for new or updated positions using the positions endpoint, then create or update items in your Webflow jobs collection
• Create candidates from form submissions - Trigger on new Webflow form submissions, map fields to Breezy HR candidate properties, and POST to the candidate creation endpoint
• Track application sources - Tag candidates in Breezy HR based on which Webflow page they applied from using custom fields
• Archive closed positions - Remove or draft CMS items when positions are marked as closed in Breezy HR

These platforms require separate subscriptions beyond your Webflow and Breezy HR accounts. Plan for 2-5 minute sync delays since Breezy HR's webhook support is limited to Pro-plan accounts and requires contacting support to enable. Webhooks only cover specific candidate events (candidateAdded, candidateStatusUpdated, candidateDeleted), which is why position updates require polling at regular intervals. Both platforms enforce rate limits, so design workflows that batch operations and avoid excessive polling.

Build with Webflow and Breezy HR APIs

Both platforms provide REST APIs that let you build custom integrations with full control over data flows, validation logic, and user experience. The Breezy HR API uses bearer token authentication with 30-day expiration, while the Webflow API uses site-specific tokens. Generate tokens from each platform's admin interface, store them securely in your backend (never in client-side code), and use them to authenticate API requests.

Build custom logic that automation platforms can't handle, like validating candidate data against your requirements before submission, implementing multi-step application forms with progress saving, or creating dynamic job recommendation engines based on candidate profiles.

Sync job postings from Breezy HR to Webflow CMS

Sync job postings from Breezy HR to Webflow CMS through automation platforms like n8n or Zoho Flow.

Fetch position data from Breezy HR and create or update items in a Webflow CMS collection. This gives you complete design control over job listing pages while keeping Breezy HR as your source of truth for position data. Use the Webflow CMS Collections API to create and update job items programmatically.

Set up your workflow:

1. Create a CMS collection in Webflow with fields for job title, description, location, requirements, and other position metadata
2. Note your Site ID and Collection ID from Webflow site settings
3. Poll Breezy HR's positions endpoint at regular intervals (plan for 2-5 minute delays between updates)
4. For each position, check if a corresponding CMS item exists in Webflow
5. Use POST /v2/sites/:siteid/collections/:collectionid/items to create new items or PATCH /v2/sites/:siteid/collections/:collectionid/items/:item_id to update existing ones

Monitor the X-RateLimit-Remaining header in API responses to avoid hitting rate limits. Implement exponential backoff (progressively longer wait times between retry attempts) when you receive HTTP 429 responses with Retry-After headers. Cache position data to reduce API calls, and only sync when data actually changes.

Send form submissions to Breezy HR as candidates

Capture application data from custom Webflow forms and create candidate records in Breezy HR. This bypasses Webflow's form submission quotas (50-2,000 per month depending on plan) and gives you complete control over validation, error handling, and confirmation messages.

Build the submission flow:

1. Create a form in Webflow with fields for name, email, phone, position interest, and resume upload
2. Add custom JavaScript that intercepts form submission using addEventListener('submit')
3. Validate data client-side before sending to your backend
4. POST form data to your server endpoint (not directly to Breezy HR from the browser, which exposes your API token)
5. Your backend maps Webflow fields to Breezy HR's candidate object structure
6. POST to Breezy HR's candidate creation endpoint with bearer token authentication (note that tokens expire after 30 days and must be refreshed)
7. Return success or error responses to update the Webflow page UI
8. Monitor rate limits to avoid HTTP 429 errors

Handle file uploads separately since they require additional API calls. Resume attachments need their own POST requests to Breezy HR's attachment endpoints. Keep individual files under 10MB as specified in Webflow's file upload documentation.

Update Webflow CMS when candidate status changes

Breezy HR webhooks are available on Pro-plan accounts and require contacting support to enable. There are three candidate events: candidateAdded, candidateStatusUpdated, and candidateDeleted. Configure webhook endpoints through Breezy HR's admin interface, pointing to your server that processes events and updates Webflow.

Process webhook events:

1. Set up a public HTTPS endpoint on your server to receive webhook POSTs
2. Register the endpoint URL in Breezy HR's webhook settings
3. When you receive a candidateStatusUpdated event, extract the candidate ID and new stage information from the payload
4. Find the corresponding CMS item in Webflow
5. Use PATCH /v2/sites/:siteid/collections/:collectionid/items/:item_id to update the status field

Most companies don't sync candidate status to public Webflow sites for privacy reasons. This webhook integration works better for internal dashboards or admin panels built on Webflow. Implement idempotent handlers (code that produces the same result when processing the same webhook multiple times) that can safely process duplicate webhook deliveries.

What you can build

Integrating Breezy HR with Webflow through automation platforms lets you create recruitment experiences that match your brand while maintaining professional applicant tracking workflows. Note that this approach requires middleware automation platforms, involves 2-5 minute data synchronization delays, and requires careful workflow design to respect both platforms' API rate limits.

• Custom-branded career pages with current job listings: Design job listing pages in Webflow CMS that automatically sync with positions in Breezy HR. Create custom layouts with department filters, location search, and salary ranges that match your brand identity.
• Multi-step application forms with validation: Create application experiences that collect candidate information across multiple pages, validating data in real-time before submission. Save progress between steps and let candidates upload multiple documents like resumes, portfolios, and cover letters.
• Department-specific recruiting microsites: Build separate Webflow sites for different departments or locations, each displaying filtered job listings from Breezy HR. Engineering, sales, and operations teams get their own branded recruiting presence.
• Internal hiring dashboards: Create password-protected pages in Webflow that display candidate pipeline metrics, application volume by source, and time-to-hire statistics pulled from Breezy HR's API. Give hiring managers visibility into recruitment performance without requiring separate dashboard tools or direct Breezy HR access.