Technical Documentation for Fibbler

Quick Links

Overview

One of the most common questions we receive is, 'How does your tool Fibbler actually work, what kind of permissions do you need from our CRM, and why?'

Fibbler works in two different ways:

Fibbler in-app Company Insights

  1. Customer Connection:
    • Step 1: The customer connects to LinkedIn and HubSpot or Salesforce through Fibbler.
  2. Data Retrieval:
    • Step 2: Fibbler makes an API request to LinkedIn to retrieve ads data.
    • Step 3: Simultaneously, Fibbler retrieves all deals from HubSpot or Salesforce based on the date range selected by the customer.
  3. Data Matching:
    • Step 4: Fibbler matches the LinkedIn ad company data with the HubSpot or Salesforce company data based on the domain.
How insights works

Fibbler CRM Data Sync

  1. Connect to LinkedIn: The customer connects to LinkedIn.
  2. Connect to CRM: The customer also connects to HubSpot or Salesforce.
  3. Choose Sync Duration: The user selects whether to sync data for 7, 30, or 90 days.
  4. Request LinkedIn Ads Data: Fibbler makes an API request to LinkedIn to retrieve ads data.
  5. Check CRM for Account: Fibbler searches for the account in Salesforce or HubSpot based on the domain from the LinkedIn data to check if the account exists.
  6. Push Data to Salesforce: If the account exists, Fibbler pushes LinkedIn ad clicks, impressions, and engagement data to the corresponding Salesforce or HubSpot account properties for the chosen duration.
Graph on how to connect our datasource sync

It will then continue to update data every Sunday until turned off.

Note: it will only update already existing companies/accounts and not create new ones.

Permissions Required

LinkedIn Ads:

The user needs to have read-only access to your ad account. Additionally, we have write access to your personal member profile solely for retrieving publicly available company logos from LinkedIn.

HubSpot:

Insights view: The user needs to have read-level access to companies and deals.

Data sync: The user also need read/write-level access to company properties

Salesforce:

Insights view: The user needs to have access to Accounts, Opportunity.

Data sync: The user needs to have read-level access to Accounts, Opportunity and read/write-level access to CustomField. To sync data from LinkedIn Ads to Salesforce, we leverage the Salesforce API, which allows access to the current, logged-in user’s account using APIs.

We also have access to the ‘offline_access’ scope because we require a refresh_token for a more secure way to handle your data. Note that we don’t use ‘offline_access’ in any other way.

Are you GDPR compliant?

Yes! We don’t store any information from your LinkedIn Ads account or your HubSpot/Salesforce instance. Instead, we call their respective APIs in real-time.

Data transmitted during API requests between LinkedIn and HubSpot/Salesforce is encrypted using Transport Layer Security (TLS). This means that all API communications occur over HTTPS, ensuring that data in transit is securely encrypted and protected from unauthorized interception.

Offline access tokens are protected and managed through several security measures. Firstly, tokens stored in our database are encrypted using Advanced Encryption Standard (AES), ensuring that even in the event of a data breach, the tokens remain secure. Access to these tokens is tightly controlled, with only authorized services having the ability to read or use them. Regarding your concern about data encryption in API requests: The data coming from an API is usually encrypted during transmission using TLS (HTTPS). While the data itself might not be encrypted once it is received.

Note. We don't have a DPA since there is no personal data being handled. Hence, GDPR does not apply to Fibbler.

Further Questions

Do you have any other questions? Send us a message at support@fibbler.co.