Skip to content
Surhires

In development

In build

Every candidate email on the record, without copying your inbox

The Gmail connector is in active build for Wave 1 and is not connected today; it will file candidate and client mail on the record while leaving personal mail alone.

The Gmail integration is in development for the Wave 1 release and is not available yet. When it ships it will provide two-way sync with threading and reply detection against the candidate record, filing only messages that match a known candidate or client contact rather than mirroring a recruiter's whole mailbox.

By Surhires Editorial · Published · Reviewed

In the product: in build for Wave 1: two-way sync, threading and reply detection against the candidate record

State of this integration

This is a build item. Two-way sync, threading and reply detection against the candidate record are in development for Wave 1, and none of it is available to switch on today. Anything below describing behaviour is describing the planned behaviour.

Email sync is the integration that recruitment teams evaluate most carefully and complain about most loudly, usually because a previous system either missed half the thread or swallowed the recruiter's private correspondence. Both failure modes are avoidable, and the design decisions that avoid them are worth stating before the connector lands.

Only mail that matches a known contact gets filed

The rule is the whole design. A message is filed against a record when one of its participants matches a candidate or a client contact already in your tenant. Everything else is ignored, never read into the product, and never stored.

That means a recruiter's mail to their accountant, their landlord, their union, their doctor and their spouse never enters the recruitment system, because none of those addresses are in your candidate database. Mail to a candidate does, because that address is on a record you already hold.

The alternative approach, which several systems take, is to mirror the mailbox and then filter for display. That puts the whole mailbox into the vendor's storage and leaves the privacy of the recruiter depending on a display rule. We would rather narrow at the point of ingestion.

  • Participant address must match a candidate or client contact record
  • Non-matching mail is not stored, not indexed and not shown
  • Recruiters can exclude specific addresses or domains from matching entirely
  • A filed message can be removed from a record without deleting it from Gmail

The OAuth scopes, and why each one is requested

Connecting will use Google OAuth, and the consent screen will name the scopes. Reading messages is required to file a thread against a record and to detect a reply; sending is required so a message composed in the product leaves from the recruiter's real address rather than a no-reply relay that candidates ignore.

What will not be requested is anything unrelated. No Drive access, no contacts export, no broad account scope. Calendar is a separate connector with its own consent, because interview scheduling and mailbox filing are different jobs and an administrator should be able to approve one without the other.

Access is revocable from the Google account at any time, and revoking it stops the sync without removing what has already been filed on the records.

Threading and reply detection

Threading keeps a conversation as one object rather than a scatter of individual messages. When a candidate replies, the reply attaches to the thread on the record, the sequence step that sent the original stops, and the reply handler classifies interest so the record moves or a task is raised.

Reply detection is what makes cadences safe. The single most damaging thing an email sequence can do is send step three to a candidate who answered step two, and the only reliable defence is a connector that sees the reply as it arrives rather than at the next scheduled poll.

Bounces, out-of-office notices and delivery failures are classified separately so an auto-reply does not stop a cadence and a hard bounce marks the address rather than the candidate.

Sending from the recruiter's own address

Messages composed in Surhires will send through the connected Gmail account, which means they carry the recruiter's real address, the domain's own authentication and the recruiter's signature. Replies land in the recruiter's inbox and on the record at the same time.

Sending this way is materially better for deliverability than a shared relay, because the reputation belongs to your domain and your sending history. It also matters for the candidate experience: a message from a person is answered more often than a message from a system.

As with every channel, opt-out and suppression are checked before a message leaves, and email footers carry the identification and unsubscribe details the campaign relies on.

Keeping personal mail out, deliberately

A recruiter's mailbox is a mix of work and life, and a shared work mailbox is a mix of clients and colleagues. Beyond the matching rule, the planned controls include a personal exclusion list a recruiter maintains themselves, and a per-connection choice of which labels or folders are in scope.

Nothing filed is hidden from the recruiter. Every message that lands on a record is visible with its source, and a recruiter can detach a message from a record without deleting it from Gmail. There is no silent capture, which is the property that makes people trust an email connector.

If a shared mailbox is used for a whole desk, the same rules apply, and the mailbox owner rather than each recruiter grants the consent.

What sync will not do

It will not archive your mailbox. Surhires is not an email retention system and will not become one; filed messages are part of a candidate record with the record's retention window, not a parallel copy of your mail history.

It will not migrate historical mail from before the connection by default. Backfilling a mailbox pulls in a large volume of correspondence with people who have since asked to be forgotten, so a backfill will be a bounded, opt-in operation with a date range rather than a switch that runs on connect.

What you get

Two-way sync

Mail sent from the product appears in Gmail; matching mail from Gmail appears on the record.

Contact matching

Only messages involving a known candidate or client contact are filed.

Non-matching mail ignored

Unmatched correspondence is never stored, indexed or displayed in the product.

Thread integrity

A conversation stays as one threaded object on the record rather than loose messages.

Reply detection

An inbound reply stops the running cadence step before the next message can send.

Reply classification

Interest, objection or availability read from the reply and turned into a task or stage move.

Bounce handling

Hard bounces mark the address; out-of-office replies do not stop a sequence.

Send as yourself

Messages leave from the recruiter's real address with the domain's own authentication.

Narrow OAuth scopes

Mail read and send only; no Drive, no contacts export, no broad account access.

Calendar kept separate

Interview scheduling consent is its own connector and its own permission grant.

Personal exclusion list

A recruiter can exclude addresses or domains from matching entirely.

Label scoping

Choose which Gmail labels are in scope for the connection.

Detach without deleting

Remove a message from a record without touching the copy in Gmail.

Bounded backfill

Historical import is an opt-in operation with a date range, not automatic on connect.

Questions recruiters ask

Is Gmail sync working today?

No. It is in active build for Wave 1: two-way sync, threading and reply detection against the candidate record. There is nothing to connect yet. The state on this page will change from in development to live when the connector ships, and not before.

Will you read all of my email?

No. A message is filed only when one of its participants matches a candidate or client contact already in your tenant. Everything else is ignored at ingestion rather than filtered at display, so unmatched mail is never stored or indexed. You can also exclude specific addresses and domains outright.

Which Google permissions will you ask for?

Mail read and mail send, and nothing else. Reading is needed to file a thread and detect a reply; sending is needed so messages leave from the recruiter's own address. No Drive, no contacts export, no broad account scope. Calendar is a separate connector with a separate consent.

How do I keep my personal mail out of the CRM?

The matching rule does most of the work, since your personal correspondents are not candidate records. Beyond that you will be able to maintain a personal exclusion list and scope the connection to particular labels. Anything that does get filed is visible to you and can be detached without deleting it from Gmail.

Will it import our email history when we connect?

Not by default. A blanket backfill pulls years of correspondence with people who may have since asked to be forgotten. Historical import will be an explicit, bounded operation with a date range that you choose, rather than something that happens automatically the moment the account is authorised.

What happens if a candidate replies mid-sequence?

Reply detection stops the cadence immediately, which is the entire reason this connector matters. The reply is threaded onto the record, classified for interest or objection, and turned into a task or a stage move. Out-of-office notices are classified separately so they do not stop a sequence by mistake.

See it against your own reqs

Bring one live role and three resumes. In twenty minutes you will see the match scores, the shortlist and the placement invoice that comes out the other end.