Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.tightknit.ai/llms.txt

Use this file to discover all available pages before exploring further.

The Tightknit Salesforce integration is available as an add-on to the Enterprise plan.

Install the Managed Package

Salesforce sandbox orgs are not supported. The OAuth flow from the Tightknit Studio does not work with sandbox orgs. Connect a production org instead. See Known Issues.
PropertyValue
PackageTightknit Analytics
Namespacetightknit
Subscriber Package Version Id04tdM000000TminQAC
Version1.4.0.3
API Version65.0
Installation PasswordNone (no installation key required)
Installation URLInstall Link
Install the Tightknit Analytics managed package using one of the following methods:
Salesforce managed package install screen with Install for Admins Only selected
We recommend choosing Install for Admins Only. It is the safest option and the Salesforce-recommended default, since it limits initial access to system administrators while you finish configuring the integration. Once setup is complete, you can grant access to other users by assigning them the Tightknit permission sets.

Configure the Connection in Salesforce

1

Assign yourself the Tightknit Admin permission set

After install, the Tightknit and Tightknit Setup apps aren’t visible in the App Launcher until your user is assigned the Tightknit Admin permission set. Managed packages can only grant Lightning app visibility through permission sets — profile customizations don’t ship in 2GP managed packages, so even system administrators need this assignment.
  1. In Salesforce, navigate to Setup → Permission Sets.
  2. Click Tightknit Admin.
  3. Click Manage Assignments, then Add Assignment.
  4. Select your user, click Next, then click Assign.
Refresh the App Launcher (or sign out and back in) for the assignment to take effect.
2

Open the Tightknit Setup app

Launch the Tightknit Setup app from the Salesforce App Launcher.
Salesforce App Launcher with Tightknit typed into the search field and Tightknit Setup highlighted in the Apps list
3

Run the setup wizard

Follow the wizard to configure your integration user with the correct permission set. We recommend creating a dedicated Salesforce user for the Tightknit integration.

Grant Your IT Admin Access to the Studio

If your Salesforce administrator is not already a Studio user, you need to invite them and assign the Integrations Manager role so they can manage the Salesforce connection.
1

Invite the user

Navigate to Settings > Workspace > Users and invite your IT admin via their email address.
The email used for the invitation must exactly match the email associated with their Slack profile. If the emails don’t match, the user will be unable to log in.
2

Assign the Integrations Manager role

Once the user has been added, assign them the Integrations Manager role. This grants access to manage integration settings (including Salesforce), webhooks, and API keys, without exposing other administrative areas of the Studio.
For more details on Studio access and available roles, see Access the Studio.

Configure the Connection in Tightknit

1

Open the Salesforce integration settings

Navigate to Settings > Integrations > Salesforce in the Tightknit Admin Studio.
Salesforce integration settings page in the Studio with Salesforce highlighted in the sidebar and the Connect button highlighted
2

Connect to Salesforce from the Tightknit App

Connect to your Salesforce org

Ensure you are already authenticated (in another tab) as the integration user you set up in the previous section, or be ready to log in as that user. Click Connect to authorize the connection.

Verify the managed package

Click the Verify Managed Package button to confirm the package is correctly installed in Salesforce.

Configure and Start the Sync

After connecting your Salesforce org, the settings page presents a three-step timeline wizard: Connect, Configure, and Backfill. You can adjust every sync option before starting the sync for the first time.
1

Connect

Complete the Salesforce OAuth connection as described above. Once connected, this step is marked complete and the Configure step becomes active.
2

Configure sync settings

Set your preferred sync options before starting the sync. Available settings include:
  • Create Contacts — create a new Salesforce Contact for any community member that cannot be matched by email.
  • Activity Metadata — include additional metadata fields on synced Activity records.
  • Matching field — the Contact field used to match community members (default: email).
  • Sync interval — how frequently incremental syncs run (for example, every 5 minutes).
You can change these settings at any time, even after the initial sync is running.
3

Review and start the sync

Click Start Sync to open the review dialog. The dialog displays your chosen configuration and asks you to verify the Managed Package installation. Once verified, confirm to activate the integration and begin the initial backfill in a single step.The backfill imports your existing historical data and may take several minutes depending on the size of your community. Progress is displayed on the page and refreshes automatically.
Once the backfill completes, the incremental sync runs automatically at your configured interval. All three steps are marked complete, and a pause/resume toggle appears so you can temporarily suspend syncing without disconnecting.
To view your Salesforce sync history, click the Sync History tab at the top of the Salesforce integration settings page.

Disconnect the Salesforce Integration

Disconnecting requires two separate actions in the Studio: one to tear down the integration connection, and one to revoke the underlying Salesforce OAuth account.
1

Disconnect the integration connection

Navigate to Settings > Integrations > Salesforce and scroll to the Connection section. Click the ··· overflow menu to the right of Connection and select Disconnect. This reveals the connection widget below.
Salesforce connection settings with the Disconnect option highlighted in the overflow menu
2

Disconnect the Salesforce account

On the newly revealed connection widget, click the ··· overflow menu next to the connection status and select Disconnect account. This revokes the OAuth authorization to your Salesforce org.
Connection widget with Disconnect account option highlighted in the overflow menu
3

Refresh the page

Click the refresh button next to the connection widget to confirm the disconnection and update the page state.

Additional Salesforce Customization

LWC Components

The managed package includes sample page layouts and custom Lightning Web Components that you can add to your Salesforce pages using Lightning App Builder. We recommend exploring the following components:
ComponentLWC NameTarget PageDescription
Account Community Activity SummarytightknitAccountCommunityActivitySummaryAccount Record Detail PageDisplays a summary of community activity for contacts associated with an Account.
Activity InfotightknitCommunityActivityInfoActivity Record Detail PageDisplays detailed information about a single Activity record including related members and community.
Community Activity SummarytightknitCommunityActivitySummaryCommunity Record Detail PageDisplays a summary of member activity for a single Community.
Community ProfiletightknitCommunityProfileContact Record Detail PageDisplays Tightknit community profile information based on the contact’s email.
Contact Member Activity LogtightknitContactMemberActivityLogContact Record Detail PageDisplays a list of recent Tightknit activities for a Contact or Lead by matching their email to Member records.
Member Activity LogtightknitMemberActivityLogMember Record Detail PageDisplays a list of recent Tightknit activities for a Member record.
View in TightknittightknitViewInStudioButtonMember Record Detail Page, Contact Record Detail PageButton to open the member’s profile page in the Tightknit Admin Studio.
Permissions required to view LWC components. Users who view a record page containing a Tightknit LWC must be assigned the Tightknit Admin or Tightknit Integration User permission set. These permission sets grant access to the underlying Apex controllers and to the Community, Member, and Activity custom objects.