Bulk Jobs

What Bulk Jobs are for

Bulk Jobs is a tab in the organization admin portal. Instead of adding sync connections or users one at a time, you provide a single list and CalendarBridge creates every item in one run. A job comes in two types:

• Sync connections — create many one‑way calendar syncs (optionally with their reverse direction too) from a list of source → destination calendars.
• User seats — provision many users at once, each with a plan, an access‑control policy, and (optionally) pre‑connected calendar accounts.

You configure the settings once for the whole job, so every row is created consistently. Because large jobs are paced to protect the calendar providers’ rate limits, they run in the background — it’s safe to leave the page while a job runs.

Before you start

• You must be an organization admin, and the domains you use must be authorized domains on your organization. The wizard lists your authorized domains at the top for reference. See Connect Authorized Domains.
• Creating syncs or users consumes seats. If your subscription doesn’t have enough, CalendarBridge will either add them automatically (metered plans) or ask you to authorize the additional seats before the job starts (prepaid plans). See Seats and billing below.

Create a bulk sync job

1. Open Bulk Jobs and click “New bulk job”

   In the organization admin portal, open the Bulk Jobs tab and click New bulk job. Leave the type set to Sync connections.

2. Provide the calendar mappings

   Paste or upload a CSV with one row per sync. Each row has eight columns:

   source email, source type, source timezone, source calendar, dest email, dest type, dest timezone, dest calendar

   • Type is google, office365, or exchange.
   • Timezone and calendar are optional. For the calendar column, use the account’s own email address for Google and Calendar for Microsoft; leave it blank to use the default calendar.

   As you paste, a preview grid validates every row and flags problems (unauthorized domains, unknown types, malformed emails) so you can fix them before the job is created.

3. (Optional) Also create the reverse syncs

   Turn on “Also create reverse syncs” to create the destination → source direction for every row as well. The reverse legs get their own settings panel, so you can, for example, use a different tag or color for events copied back the other way.

4. Choose the sync settings once

   Set the field policy (which event details are copied), the tag appended to copies, the destination color, and any filters. These apply to every row. You can override the tag and color for individual rows right in the preview grid.

5. Create the job, then preflight it

   Click Create job. On the job page, click Check setup to run a pre‑flight: CalendarBridge verifies tenant access for each distinct account and reports any billing shortfall before you commit. Fix any blockers, then click Start.

Create a bulk user‑seats job

1. Click “New bulk job” and choose “User seats”

   In the Bulk Jobs tab, click New bulk job and switch the type to User seats.

2. Provide the user list

   Paste or upload a CSV with one user per row: email, an optional plan, and then any optional connected‑account emails as extra columns.

   • The login email can be on any domain — contractors and personal addresses are fine.
   • To pre‑connect a calendar account for a user, add its exact email as an extra column. CalendarBridge does not guess addresses across domains. If a domain is authorized on both Google and Microsoft, disambiguate with :google or :office365 after the email (for example bob@corp.com:google).
3. Choose the seat settings

   Pick the default plan and the sync field policy (All fields, Free/Busy only, or Custom). You can also check “Block AI assistant & MCP access” to turn off the AI scheduling assistant and the MCP server for every user this job creates.

4. Create, preflight, and start

   Click Create job, then Check setup to validate tenant access and seats, and Start. Each user is created with a login and an invite email, just like adding a user individually.

Watch a job and fix errors

While a job runs, the job page shows a live summary (created, already existed, failed, and — for syncs — how many are still syncing) and a per‑row table with each row’s status. You can pause, resume, or cancel a running job at any time.

• Rows that fail show a specific reason (for example, a tenant permission problem or a calendar that couldn’t be found).
• Click Retry failed to re‑run just the failed rows after you’ve fixed the underlying issue.
• Click Export errors to download a CSV of the failed rows with their error messages. It’s formatted so that, once you’ve corrected the values, you can paste it straight back in as a new job.

Seats and billing

Every sync connection or user created by a job needs a seat, exactly as when you add one individually.

• Metered subscriptions add the needed seats to your subscription automatically as rows are created — you’re only billed for what’s actually created.
• Prepaid subscriptions draw from your seat pool. If a job needs more seats than you have, the pre‑flight reports the shortfall and the Start button becomes “Add N seats & start.” Clicking it purchases exactly the shortfall (billed with proration) and then starts the job. You can also add seats yourself first from the Manage Billing tab.