Blog

How to onboard agents to your brokerage platform in one link

· SyncYak team

  • platforms
  • onboarding
  • brokerage

Every new agent costs a brokerage a setup call. Someone asks for a CRM API key, walks the agent through finding it, pastes it into a form, then does the same for their email. Agents rarely read setup guides, and a key sent over chat or email ends up in places it should not be.

You can cut that to two links per agent. This post walks through an onboarding flow built on invite links for CRM sync and a hosted connect page for email, what to track afterward, and what it costs at different team sizes.

What agents actually need to hand over

A platform or brokerage usually wants three things from each agent:

  1. Their lead history and current pipeline, from whatever CRM they use.
  2. Access to their inbox, so follow-ups come from their own address and replies are detected.
  3. A way to write brokerage data, such as a lead score, back into their CRM.

The usual blocker is credentials. Agents use different CRMs, and asking them for API keys turns your team into a help desk. The better pattern is to let each agent authenticate themselves on a page that shows who is asking and what for, and to never see the secret at all.

SyncYak CRM connects Follow Up Boss, Lofty, BoldTrail, CINC, HighLevel, Cloze, Brivity and KW Command to a Postgres or MySQL database you own, or to a Google Sheet for smaller teams.

For onboarding, the useful part is the invite link:

  • You create it in your account and choose the connection name and the table mode.
  • The agent opens it without a SyncYak login. The page shows which account asked, lets them pick their CRM, and tests the credentials before connecting.
  • A link connects one CRM and then closes. Each link expires in 1 to 30 days, and you can revoke it at any time.

Because the agent types their own credentials into the page, your team never handles their keys. Set the expiry to match your onboarding window. Seven days works for most welcome sequences, and a link that goes unused simply lapses.

Pick the table mode up front. Shared tables put every agent in the same tables, with ids prefixed per connection and a column for the CRM and connection. One table per connection keeps each agent's data separate. Shared tables suit company-wide reporting, and per-connection tables suit cases where each team owns its data.

SyncYak Mail handles the second link. Each agent connects Gmail or Microsoft 365 on a hosted connect page. If you pass their address as a login hint, they land directly on Google's or Microsoft's consent screen, and that screen is the only one they see. The consent screen shows your platform's OAuth apps, so the agent sees your brand rather than ours. Agents do not need SyncYak accounts.

If an agent's mailbox is not on Google or Microsoft, the page detects the provider from the address and asks for an app password. It tests that against IMAP and SMTP before saving anything.

When the agent finishes, their grant id comes back to your redirect URI. Store it against the agent's profile in your platform. From then on you can send follow-up templates from their address and receive replies as webhooks.

Step 3: Listen for connection changes

Onboarding is not finished when the agent clicks through. Credentials expire, passwords change, and agents leave. Mail sends your platform three events you can act on:

  • grant.created when an agent connects.
  • grant.updated when they reconnect with the same grant id.
  • grant.expired when the provider refuses the credentials.

The expired event is the one to wire up first. When it fires, send the agent a fresh connect link before leads go unanswered. A silent broken mailbox is worse than a visible disconnected one, because the agent assumes follow-ups are going out.

On the CRM side, each connection has its own status, backlog and request log, so a support person can see whether a sync is healthy without asking the agent anything.

Step 4: Use the data the same day

Once both links are done, the data is useful immediately:

  • Reporting. In SQL, the _flat view has the same core columns for every CRM: name, emails, phones, address, source, stage, assignedTo and last communication date. A report across eight CRMs becomes one query.
  • Enrichment. Map a column in the from_syncyak_ table to a CRM field, and changed rows are written back. Write-back works for Follow Up Boss, Lofty, HighLevel and Cloze.
  • Routing. For portal leads that arrive by email, SyncYak Parse can match a lead to an agent from your roster sheet by zip code, listing or source before it is delivered.

What it costs by team size

All numbers come from the pricing page, so check it for current prices.

Module Free Hobby Pro Business
CRM connections 1 2 ($29/mo) 5 ($99/mo) 15 ($299/mo)
Mailboxes 3 10 ($12/mo) 50 ($49/mo) 250 ($199/mo)

Extra CRM connections are $15 a month each, and extra mailboxes are $1.25 a month each. Larger rosters add connections and mailboxes one at a time, or move to Enterprise for custom limits and volume pricing.

Start on Free with a pilot team of two or three agents. Free covers one CRM connection and three mailboxes, which is enough to test the whole flow before you decide on a plan.

How SyncYak helps

SyncYak gives a platform both halves of onboarding with no custom OAuth or CRM connector work on your side. Real estate CRM sync covers the invite-link flow and the shared data model, and agent email integration covers the inbox side. The platforms page shows how the pieces fit together, and pricing lists every limit.

To try it with your first agent, create a free account and send yourself an invite link.

Start free with SyncYak · All posts