Connecting Front to Opensense

Overview

This article explains how to connect Front to Opensense using the Front API. Once connected, Opensense can sync your Front teammates, and push managed email signatures directly into their accounts.

Before you start

You need:

• Front admin access, to generate an API token and configure teammate settings
• Opensense admin access, to configure the integration

Step-by-step guide

Step 1: Generate an API token in Front

The API token wizard in Front has four screens. Complete each one in order.

1. Sign in to Front as an admin.

2. Go to Settings, select the Company tab, and then go to Developers > API tokens.

3. Select Create API token.

4. Token details: name the token (for example, “Opensense Integration”), and select Next.

5. Feature access: select both of these, and then select Next:

   • Access Resources: lets the token manage Front API resources, such as inboxes, contacts, and signatures.
   • Auto-provisioning: lets the token manage teammate provisioning through SCIM, so Opensense can sync and manage Front users.

6. Namespace access: select all three namespaces, and then select Next:

   • Global: core API resources, used for directory syncing.
   • Shared: shared inboxes and workspaces. Select the workspaces where teammates should get Opensense signatures.
   • Private: individual user mailboxes. Required for the signature Pusher.

7. Resource permissions: turn on these permissions:

   Resource	Read	Write	Delete
   Signatures	Yes	Yes	Yes
   Teammate groups	Yes	—No	—No
   Teammates	Yes	—No	—No
   Teams	Yes	—No	—No

8. Select Create, and copy the token.

Step 2: Turn on individual API access for teammates

For Opensense to push signatures into individual inboxes, the Allow access to my individual resources via the API setting must be turned on for each teammate in Front.

Sync and push work independently

If this setting isn’t turned on for a teammate, Opensense can still sync that user, but the signature push fails for their account.

1. In Front, go to Settings, and confirm that you’re on the Company tab.
2. Select Teammates in the left sidebar.
3. Select a teammate.
4. Select the Preferences tab, at the top of the teammate’s profile.
5. Turn on Allow access to my individual resources via the API.
6. Repeat for each teammate who should get a managed signature.

Step 3: Add the API token in Opensense

1. Sign in to Opensense as an admin.
2. Go to Manage > Domain Settings > Directory/Sync > Front.
3. Paste your API token into the token field.
4. Turn on Auto-sync users if you want Front teammates to sync into Opensense automatically.
5. Select Save.

Opensense connects to Front, and starts syncing teammates based on your auto-sync setting.

Push to Front

Once users are synced, you can push their assigned Opensense signature directly into their Front account. Opensense writes the signature through the Front API, into the teammate’s signature settings, with no action from the teammate. For a full walkthrough of the Pusher, see Introduction to the Pusher tool.

1. In Opensense, go to Signatures > Pusher.
2. Select New Push.
3. Configure the users in the Pusher wizard.

The signature appears in the teammate’s Front account, in the signature selector in the Front composer.

Sync Front users

If Auto-sync users is turned on, Opensense syncs Front teammates automatically, on a recurring schedule. To start a sync manually:

1. In Opensense, go to Manage > Users.
2. Select Actions.
3. Select Run Sync, and set the source to Front app.

The synced Front teammates appear in your Opensense user list, under Manage > Users.

Troubleshooting

Signatures don't appear in a teammate's Front account after pushing

Confirm that Allow access to my individual resources via the API is turned on in the teammate's Preferences tab in Front. The signature push fails without this permission, even if the user is synced.

To check the fix: push the signature again after you turn on the setting. The signature should appear in the teammate's Front account.

Auto-sync is on, but teammates don't appear in Opensense

Check that the API token has Read turned on for the Teammates resource, and that the token was saved correctly in Manage > Domain Settings > Directory/Sync > Front.

To check the fix: confirm that the teammate appears in the Opensense user list after you save the token.

What’s next

• Adding the Opensense signature block to Front signatures
• Setting up the Front SMTP relay
• Front API: Access to private resources (Front Help Center)

For further help, contact Opensense Support at help@opensense.com.