iOS 16 and iOS 17 support ends late July 2026. Update your device to iOS 18.0 or later to continue receiving Cerby app updates.
Ctrlk
CerbyDeveloper PortalSupportWeMakeCerby
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Manage secondary identity sources for your business hub

This article describes how to manage secondary identity sources for your business hub to let Cerby route user invites to a secondary email address.

Who can use this feature?

  • Business hub Owners

  • Only supported using the Cerby web app

With Cerby's identity source setting, you can control which email address to use when sending invitations to users for a business hub. Each hub can be configured to use either the user's primary email (the default) or their secondary email: a separate, managed email address stored on the user's Cerby profile to represent their identity on a specific platform. As a business hub Owner, you can configure this setting per integration to ensure invitations are routed to the correct identity.

This feature is designed for integrations such as Google Ads and Google Analytics, where users access platform accounts under a client-owned or IT-managed Google identity. For example, a media buyer might log in to Cerby with user@agency.com but manage a Google Ads account under user@client.com. Setting the identity source to Secondary ensures invitations reach the correct identity and are accepted without manual intervention.

The following are the key benefits of using a secondary identity source:

  • Accurate invitation routing: Invitations reach the managed identity associated with the platform, preventing provisioning failures caused by mismatched accounts.

  • Flexible per-hub configuration: Each business hub is configured independently. You can route one hub's invitations to secondary emails while keeping another on primary, within the same workspace.

  • Safe fallback behavior: If a user has no secondary email associated, Cerby automatically falls back to their primary email address. Provisioning is not blocked by a missing value.

IMPORTANT: Secondary email addresses are only populated in Cerby via SCIM provisioning from the organization's identity provider (IdP). Contact your IT admin to verify the address being synced to user profiles.

Set up a secondary identity source for a business hub

To set up a secondary identity source for a business hub, you must complete the following steps:

  1. Log in to your Cerby workspace.

  2. Select the Business Hubs option from the left menu. The Business Hubs page is displayed.

  3. Click the corresponding business hub. The business hub details page is displayed.

  4. Expand the Settings section, further down the page.

  5. Click the Update button in the Identity source field. The Update the invitation email source dialog box is displayed.

  6. Select the Secondary option from the Identity source drop-down menu.

  7. Click the Save button. The dialog box closes, and a success message box is displayed.

NOTE: This setting applies to the individual business hub where you made the change. Other business hubs for the same app are not affected.

Now you are done.

Last updated

Was this helpful?