# AI Copilot Quickstart
Source: https://docs.superjoin.ai/ai-copilot-quickstart
Let's help you install and start using Superjoin's AI Copilot in under a minute!
Here's the step-by-step guide to Install Superjoin's AI Copilot on Google Sheets.
Open from Google Drive or type `sheets.new` in a new Google Chrome tab.Click on `Extensions` from the Google Sheets menu.
Select `Add-ons` and choose `Get add-ons`. This action will redirect you to the Google Workspace Marketplace.
In the Google Workspace Marketplace pop-up window, search for "Superjoin".
Open the `AI Copilot – Use GPT / Gemini on Google Sheets` listing and click the blue `Install` button. Approve the permissions to finish.
**Note:** For the best experience, install Superjoin where there's only a single account is logged in the Chrome profile.
Once installed, navigate back to the `Extensions` menu tab in Google Sheets.
Hover over `AI Copilot – Use GPT / Gemini on Google Sheets` and click `Launch Superjoin AI`.
Superjoin now runs as a side panel on the right of your screen. Type a request to get started.
In cases where only "Help" is visible after clicking on `Extensions`, refresh your Google Sheet and wait for some time. Sometimes it takes
over a minute to load. If you are still facing the issue, email us at [support@superjoin.ai](mailto:support@superjoin.ai).
If you're looking to import or export data, try out our [Data Connectors](quickstart) to sync live data between your Spreadsheets and 40+ sources.
## What you can do with AI Copilot
Skip the manual work — just describe what you need in plain English and let the AI Copilot handle it right inside your Spreadsheets!
Describe what you want in plain English and let Copilot write complex formulas for you.
Fix date formats, standardize values, and tidy up messy data in seconds.
Turn raw data into dashboards, charts, and trackers automatically.
Ask questions about your data and get instant answers and insights.
# What you can do with Superjoin
Source: https://docs.superjoin.ai/common-usecases
With Superjoin, you can transform your Spreadsheets into a powerful data-driven tool, giving you real-time insights and enabling efficient decision-making.
## Here are some key ways to leverage Superjoin:
### Pull HubSpot Data and ensure proper data hygeine in your CRM
* Use Superjoin’s integration to regularly import HubSpot data and ensure all records are accurate, up to date, and cleansed of any inconsistencies.
* Maintain a high level of data quality, ensuring that all stakeholders have access to reliable and actionable data.
### Discover the Best-Performing Campaigns
* Combine data from **HubSpot** and **Salesforce** using VLOOKUP and other spreadsheet formulas to analyze which marketing campaigns are generating the most valuable opportunities.
* Track the performance of these campaigns over time without having to manually rebuild reports.
### Track Performance and Compare Live Data Against Your Targets
* Compare **Salesforce** data with your business targets to see how you're pacing.
* Use spreadsheet formulas to track whether your **Sales Development Representatives (SDR)** are on track to hit opportunity goals.
* Automate Slack notifications to alert SDR managers if their team is falling behind on goals, so action can be taken immediately.
### Capture Customer Health Scores and Trigger Alerts for At-Risk Customers
* Import data from your CRM and databases, combining customer success interactions with overall trends.
* Set up Superjoin notifications with spreadsheet formulas to automatically trigger alerts when a customer’s health score drops below a set threshold.
* Use these insights to take proactive steps to retain customers and increase satisfaction.
### Build Real-Time Dashboards for Presentations
* Easily create real-time charts, graphs, and pivot tables from **Salesforce** data and embed them directly into **Google Slides** or **PowerPoint**.
* Keep your leadership, customers, and board members up to date with the most current data in one place, with dynamic, real-time updates.
### Create a 360-Degree Dashboard of Your Pipeline with Slack Alerts
* Import data from various sources like Salesforce, HubSpot, and databases.
* Use dynamic filters, VLOOKUPs, and notifications for key events such as **Closed-Won Opportunities** or deals over **50K**.
* Build live dashboards to track progress towards your goals, with real-time updates.
* Set up Slack alerts to notify teams whenever key milestones or thresholds are reached, ensuring you stay proactive.
***
Superjoin provides a seamless experience for combining data from multiple sources, applying dynamic filtering, and keeping your team informed with real-time insights and notifications. Transform your spreadsheets into a real-time operational hub and improve your decision-making with Superjoin.
### Why use Superjoin as a Data Connector?
We've meticulously organized the data points to ensure easy accessibility in a format you're already familiar with.
Get a sneak peek of your data. Select columns, apply filters & limits as per your need before importing.
Enjoy one-click refreshes or schedule regular updates to ensure your sheets are always up to date.
Benefit from Google Sheets' and Microsoft Excel's collaborative data analysis & other powerful capabilities.
# Model Control Protocol (MCP) for Copilot
Source: https://docs.superjoin.ai/copilot/CopilotMCP
Discover how to integrate and use the Model Control Protocol (MCP) with your Copilot, enabling seamless interaction with external tools and services.
Only available on Google Sheets
# Superjoin MCP Integration Guide
Unlock the power of AI agents with the Model Control Protocol (MCP)! 🚀 MCP is an open standard that enables AI models to securely connect with external tools, APIs, and data sources. With MCP, your Copilot can perform complex tasks, access real-time information, and interact with various services directly from your workflow.
## Overview
Superjoin's Sheets Copilot supports Model Context Protocol (MCP) integration, allowing you to connect to external data sources and services directly from Google Sheets. This powerful feature enables you to pull data, perform complex analysis, and execute operations without leaving your spreadsheet environment.
## Getting Started
### Step 1: Install Superjoin
Follow the quickstart guide to Install and Launch Superjoin 🚀
Install Superjoin in under a minute and start pulling your data instantly.
### Step 2: Access Sheets Copilot
1. Open your Google Sheets document
2. Navigate to **Extensions** in the menu bar
3. Select **Superjoin** from the extensions list
4. The Sheets Copilot interface will open
## Setting Up MCP Connections
### Step 3: Add a New Connection
1. In the Copilot interface, look for the `Toolbox` icon
2. Click on **Plugins** or the connection management area
3. Select **Add Connection** tab
4. You'll see a connection setup form
### Step 4: Configure Connection Details
Fill in the required connection information:
#### Server Name
* Enter a descriptive name for your connection (e.g., "paypal", "salesforce", "github")
* This name will help you identify the connection later
#### Server URL
* Enter the complete MCP server URL
* Example: `https://mcp.paypal.com/sse`
* Ensure the URL is correct and accessible
#### Authentication
Choose from multiple authentication methods:
We also allow connecting to servers which support OAuth 2.1 authentication
methods
### Step 5: Connect to Server
1. After filling in all required fields, click **Connect Server**
2. The system will attempt to establish a connection - In case of Oauth, it may redirect you to a different page.
3. Upon successful connection, you'll see a green indicator next to your connection
4. Your connection will appear in the **Connections** tab with its status
### Step 6: Managing Connections
* **View Connections**: Switch to the **Connections** tab to see all active connections
* **Connection Status**: Green dot indicates active connection
* **Delete Connection**: Use the trash icon to remove connections you no longer need
* **Multiple Connections**: You can connect to multiple MCP servers simultaneously
## Using MCP in Your Workflow
### Practical Example: PayPal Transaction Data
### Advanced Usage Patterns
#### Multi-Source Data Integration
```
"Pull sales data from Salesforce and payment data from PayPal, then create a reconciliation report"
```
#### Real-time Analysis
```
"Get the latest customer support tickets from Zendesk and analyze sentiment trends"
```
#### Automated Reporting
```
"Fetch monthly revenue data from Stripe and create a financial dashboard with charts"
```
## Security
* **Never share connection credentials**: Each user should set up their own connections
* **Use least privilege**: Only grant necessary permissions when setting up OAuth
* **Regular cleanup**: Remove unused connections to maintain security hygiene
## Troubleshooting
### Common Connection Issues
* Verify the server URL is correct and accessible - Check authentication
credentials - Ensure your network allows connections to the MCP server
* Verify API keys or tokens are valid and not expired - Check if the service
requires specific scopes or permissions - For OAuth, try re-authorizing the
connection
* Confirm the MCP server supports the requested operation - Check if you
have necessary permissions to access the requested data - Verify the query
syntax matches the server's expected format
## Conclusion
Superjoin's MCP integration transforms Google Sheets into a powerful data analysis and operations center. By connecting to external services through MCP, you can build sophisticated workflows without complex integrations or leaving your familiar spreadsheet environment.
The combination of natural language queries, multiple authentication methods, and real-time data access makes it an ideal solution for teams that need flexible, powerful data tools with minimal technical overhead.
# Derived Columns Date Functions
Source: https://docs.superjoin.ai/features/derived-columns/date-functions
This section covers date-related functions for calculating time differences, extracting date components, and working with the current date. These functions are useful for managing billing cycles, tracking subscription durations, and analyzing transaction trends over time.
### **DATEDIF (Start Date, End Date, Unit)**
* **Syntax**: **`DATEDIF(start_date, end_date, "unit")`**
* **About**: Calculates the difference between two dates in days, months, or years.
* **Example**: To find out how many months a subscription has been active, use **`DATEDIF(activated_at, today(), "M")`** to get the total number of months between the start date and today.
### **EOMONTH (Start Date, Months)**
* **Syntax**: **`EOMONTH(start_date, months)`**
* **About**: Returns the last day of the month a specified number of months away from the start date.
* **Example**: To find the end date of the current billing cycle, use **`EOMONTH(today(), 0)`** to get the last day of the current month.
### **MONTH (Date)**
* **Syntax**: **`MONTH(date)`**
* **About**: Extracts the month from a given date as a number between 1 (January) and 12 (December).
* **Example**: To categorize transactions by month, use **`MONTH(transaction_date)`** to convert a date to a month number.
### **YEAR (Date)**
* **Syntax**: **`YEAR(date)`**
* **About**: Extracts the year from a given date as a four-digit number.
* **Example**: To filter data from the current year, compare **`YEAR(due_date)`** with **`YEAR(today())`** to check if the years match.
### **TODAY (Current Date)**
* **Syntax**: **`today()`**
* **About**: Returns the current date, with no time component.
* **Example**: To check if a subscription is due today, compare **`today()`** with the **`next_billing_at`** date to trigger an alert if they match.
# Derived Columns Examples
Source: https://docs.superjoin.ai/features/derived-columns/examples
Explore practical examples of using derived columns to solve common data challenges, such as adjusting MRR with discounts, categorizing customers based on subscription duration, and identifying overdue invoices. These examples demonstrate how to apply mathematical, string, and date functions to derive actionable insights from your data.
### **Calculating Adjusted MRR**
* **Objective**: Adjust the Monthly Recurring Revenue (MRR) based on a given discount percentage.
* **Formula**: **`MRR * (1 - discount_percentage)`**
* **Example**: If a subscription with an **`MRR`** of **`$1200`** has a **`10%`** discount, the formula **`1200 * (1 - 0.10)`** calculates the adjusted MRR as **`$1080`**.
### **Segmenting Customers by Subscription Date**
* **Objective**: Categorize customers based on how long they have been subscribed.
* **Formula**: **`if(diff_days(today(), activated_at) > 365, "Long-term", "New")`**
* **Example**: This will label customers who have been active for more than a year as "Long-term" and others as "New".
### **Finding Overdue Invoices**
* **Objective**: Identify invoices that are past the due date.
* **Formula**: **`if(diff_days(due_date, today()) > 0, "Overdue", "On Time")`**
* **Example**: If **`due_date`** is **`2023-06-01`** and today is **`2024-02-20`**, **`diff_days(2023-06-01, today())`** would label the invoice as "Overdue".
### **Calculating Subscription Age**
* **Formula**: **`diff_days(today(), activated_at)`**
* **Description**: Calculate the number of days since a subscription was activated.
* **Usage**: To find out how long a customer has been active, use the **`activated_at`** column which contains the activation date of each subscription.
* **Example**: **`diff_days(today(), A2)`** where A2 contains the **`activated_at`** date for a subscription.
### **Categorizing Subscriptions Based on MRR**
* **Formula**: **`if(MRR >= 1000, "Enterprise", "SMB")`**
* **Description**: Categorize subscriptions into "Enterprise" or "SMB" based on MRR.
* **Usage**: To segment your customers based on their MRR, you can set a threshold that defines "Enterprise" level MRR.
* **Example**: **`if(B2 >= 1000, "Enterprise", "SMB")`** where B2 contains the **`MRR`** for a subscription.
# Derived Columns Logical Functions
Source: https://docs.superjoin.ai/features/derived-columns/logical-functions
Utilize logical functions to apply conditional logic, handle null values, and manage errors in your derived columns. These functions, such as CASE, IF, and COALESCE, enable dynamic data categorization, error handling, and flexible data transformation, allowing you to tailor data outputs based on specific conditions and scenarios.
### **CASE (Conditional Logic)**
* **Syntax**: **`case(when(yesno_arg, value_if_yes), ...)`**
* **About**: Executes a series of conditions and returns a corresponding value for the first true condition.
* **Example**: To categorize customers based on MRR, **`case(when(MRR > 1000, "Enterprise"), when(MRR > 500, "Mid-market"), "SMB")`** labels customers as "Enterprise" or "Mid-market" based on their MRR, or "SMB" by default.
### **COALESCE (First Non-Null Value)**
* **Syntax**: **`coalesce(value_1, value_2, ...)`**
* **About**: Returns the first non-null value from a list of columns.
* **Example**: To ensure a display name is always shown, **`coalesce(first_name, username)`** would use **`first_name`** if it’s not null, otherwise **`username`**.
### **IF (Conditional Statement)**
* **Syntax**: **`if(yesno_expression, value_if_yes, value_if_no)`**
* **About**: Evaluates an expression and returns one value if true, and another if false.
* **Example**: To check if a subscription is active, **`if(status = "Active", "Yes", "No")`** returns "Yes" if the status is active, "No" otherwise.
### **IS\_NULL (Null Check)**
* **Syntax**: **`is_null(value)`**
* **About**: Tests if a value is null.
* **Example**: To verify if a customer's last payment date is recorded, **`is_null(last_payment_at)`** would return Yes if it's null, indicating a missing payment date.
### **IFERROR (Error Handling)**
* **Syntax**: **`iferror(value, value_if_error)`**
* **About**: Returns the value unless it's an error, in which case it returns an alternative.
* **Example**: When calculating an average, **`iferror(total_payments / number_of_payments, 0)`** would prevent division by zero errors by returning 0 if **`number_of_payments`** is zero.
### **IFNA (Handle #N/A Errors)**
* **Syntax**: **`ifna(value, value_if_na)`**
* **About**: Evaluates a value and returns it unless it’s an #N/A error, in which case it returns an alternative.
* **Example**: To handle missing MRR values, **`ifna(MRR, 0)`** could replace #N/A with 0 in revenue calculations.
### **IFS (Multiple Conditions)**
* **Syntax**: **`ifs(condition1, value1, condition2, value2, ...)`**
* **About**: Tests multiple conditions and returns the corresponding value for the first true condition.
* **Example**: To classify subscriptions by tenure, **`ifs(diff_months(activated_at, today()) > 12, "Yearly", diff_months(activated_at, today()) > 1, "Monthly", "New")`** categorizes them as "Yearly," "Monthly," or "New" based on how long ago they were activated.
### **SWITCH (Match Cases)**
* **Syntax**: **`switch(expression, case1, value1, [default or case2, value2, ...])`**
* **About**: Compares an expression against a list of cases and returns the corresponding value for the first match.
* **Example**: To translate a subscription status code to a text status, `switch(status_code, 1, "Active", 2, "Paused", 3, "Cancelled", "Unknown")` **`switch(status_code, 1, "Active", 2, "Paused", 3, "Cancelled", "Unknown")`** would return "Active," "Paused," or "Cancelled" based on the code, or "Unknown" if there's no match.
# Derived Columns Mathematical Functions
Source: https://docs.superjoin.ai/features/derived-columns/mathematical-functions
Learn about a variety of mathematical functions available for creating derived columns, including operations like rounding, logarithmic calculations, trigonometric functions, and more. These functions allow for sophisticated data transformations in subscription and financial models, helping you derive meaningful insights from your datasets.
### **ABS (Absolute Value)**
* **Syntax**: **`abs(value)`**
* **About**: Calculates the absolute (positive) value of a number, discarding the sign.
* **Example**: If a Chargebee invoice has a negative adjustment value, you can use **`abs(-150)`** to ensure you're working with positive values in calculations.
### **CEILING (Round Up)**
* **Syntax**: **`ceiling(value)`**
* **About**: Rounds a number up to the nearest integer or multiple of significance.
* **Example**: To estimate the ceiling value for the number of user licenses, use **`ceiling(250.75)`** to round up to the next whole number.
### **EXP (Exponential Function)**
* **Syntax**: **`exp(value)`**
* **About**: Calculates *e* (Euler's number) raised to the power of a given number.
* **Example**: For exponential growth predictions of MRR, **`exp(0.5)`** might represent an increase factor.
### **FLOOR (Round Down)**
* **Syntax**: **`floor(value)`**
* **About**: Rounds a number down to the nearest integer or multiple of significance.
* **Example**: To calculate the maximum discount level on a Chargebee subscription, use **`floor(discount_percentage)`** to get a whole number.
### **LN (Natural Logarithm)**
* **Syntax**: **`ln(value)`**
* **About**: Computes the natural logarithm (base *e*) of a number.
* **Example**: To analyze the rate of growth of a subscription metric, apply **`ln(MRR)`** to the monthly recurring revenue.
### **LOG (Logarithm)**
* **Syntax**: **`log(value)`**
* **About**: Calculates the logarithm of a number to a specified base, commonly base 10.
* **Example**: To determine order of magnitude changes in usage statistics, **`log(subscription_quantity)`** can be applied.
### **MOD (Modulus)**
* **Syntax**: **`mod(value, divisor)`**
* **About**: Returns the remainder after division of one number by another.
* **Example**: Find the remainder of subscription months after dividing by 12 to calculate leftover months: **`mod(total_months, 12)`**.
### **POWER (Exponentiation)**
* **Syntax**: **`power(base, exponent)`**
* **About**: Raises a base number to the power of the exponent.
* **Example**: To calculate the power of growth over time, use **`power(MRR, growth_factor)`**.
### **RAND (Random Number)**
* **Syntax**: **`rand()`**
* **About**: Generates a random number between 0 and 1.
* **Example**: Randomly select a subset of users for a survey from Chargebee subscriptions by assigning **`rand()`** and picking the lowest values.
### **ROUND (Round to Decimals)**
* **Syntax**: **`round(value, num_decimals)`**
* **About**: Rounds a number to a specified number of decimal places.
* **Example**: To standardise financial reporting, round the MRR to two decimal places: **`round(MRR, 2)`**.
### **SQRT (Square Root)**
* **Syntax**: **`sqrt(value)`**
* **About**: Calculates the square root of a number.
### **SIN (Sine Function)**
* **Syntax**: **`sin(value)`**
* **About**: Returns the sine of a value (angle) in radians.
### **COS (Cosine Function)**
* **Syntax**: **`cos(value)`**
* **About**: Returns the cosine of a value (angle) in radians.
### **TAN (Tangent Function)**
* **Syntax**: **`tan(value)`**
* **About**: Returns the tangent of a value (angle) in radians.
### **TRUNC (Truncate)**
* **Syntax**: **`trunc(value)`**
* **About**: Truncates a number to an integer by removing the fractional part of the number.
* **Example**: To display only the integer part of a revenue figure, use **`trunc(MRR)`**.
### **SIGN (Sign Function)**
* **Syntax**: **`sign(value)`**
* **About**: Determines if a number is negative, zero, or positive by returning -1, 0, or 1 respectively.
* **Example**: To categorize change in MRR as increased, unchanged, or decreased, **`sign(MRR_change)`** could be used.
# Derived Columns Operators
Source: https://docs.superjoin.ai/features/derived-columns/operators
An overview of the operators used in derived columns, including arithmetic, comparison, logical, and constant operators. These operators allow users to perform a variety of operations, from basic arithmetic calculations to logical evaluations, enabling dynamic data manipulation.
| **Operator** | **Syntax** | **Purpose** |
| -------------------------- | --------------------- | ---------------------------------------------------------------------------------------------------- |
| + | value\_1 + value\_2 | Adds value\_1 and value\_2. |
| - | value\_1 - value\_2 | Subtracts value\_2 from value\_1. |
| \* | value\_1 \* value\_2 | Multiplies value\_1 and value\_2. |
| / | value\_1 / value\_2 | Divides value\_1 by value\_2. |
| **Any data type** | | |
| = | value\_1 = value\_2 | Returns Yes if value\_1 is equal to value\_2, and No otherwise. |
| != | value\_1 != value\_2 | Returns Yes if value\_1 is not equal to value\_2, and No otherwise. |
| **Numbers, Dates, String** | | |
| > | value\_1 > value\_2 | Returns Yes if value\_1 is greater than value\_2, and No otherwise. |
| \< | value\_1 \< value\_2 | Returns Yes if value\_1 is less than value\_2, and No otherwise. |
| >= | value\_1 >= value\_2 | Returns Yes if value\_1 is greater than or equal to value\_2, and No otherwise. |
| \<= | value\_1 \<= value\_2 | Returns Yes if value\_1 is less than or equal to value\_2, and No otherwise. |
| **Logical** | | |
| AND | value\_1 AND value\_2 | Returns Yes if both value\_1 and value\_2 are Yes, and No otherwise. |
| OR | value\_1 OR value\_2 | Returns Yes if either value\_1 or value\_2 is Yes, and No otherwise. |
| NOT | NOT value | Returns Yes if value is No, and No otherwise. |
| **Constant** | **Meaning** | |
| yes | TRUE | |
| no | FALSE | |
| null | No value | |
| ^ | value\_1^value\_2 | Caret symbol (^) is used to represent the exponentiation operator, which raises a number to a power. |
# Derived Columns
Source: https://docs.superjoin.ai/features/derived-columns/overview
Derived columns are custom columns that you create within your Superjoin reports by applying formulas to your existing data. They allow you to manipulate and transform your data without altering the original dataset, enabling dynamic calculations and insights.
## **Benefits of Derived Columns**
Tailor your metrics to meet specific business needs.
Enhance your data by combining columns or applying calculations.
Perform calculations in real-time as your data updates.
Ensure that everyone in your organization uses the same formulae and calculations for uniform reporting.
## Steps to create calculated fields / derived columns ✨
Ensure Superjoin is installed and working before following the rest of the guide.
If you already have your desired source connected:
* Go to the `Sources` tab.
* Click on the desired source.
* After clicking on the desired source, if you get an option to import / export the data, choose `Import`.
If you need to setup a new integration, please follow the integration guide for the integration of your choice. You can find the guides for various integrations on the sidebar or on the integrations summary page.
Now you should see the `data preview` screen.
Derived columns is only supported in our Chargebee and HubSpot Data Connector. If you wish to use this feature in any other integration, please write to us at [support@superjoin.ai](mailto:support@superjoin.ai).
Click on the `Add or Modify Fields` button. This will open a sidebar where you can add / modify fields, and create calculated field(s) (derived columns).
* Click on `Create calculated field` button.
* Enter the `Field name`, this will be the name for the newly generated column.
* Write a formula in the `Formula` section. You can use the `Fields` & `Functions` tab to search for and select the fields and functions, respectively.
* Once ready, click on `Add Field`.
After adding the field, the derived column would be visible as the last column in the preview.
You can add more derived columns.
* In the `Add Fields` section, click on `Your Calculated Fields` to expand it if not already.
* Hover over the desired derived column title under the `Your Calculated Fields` to see an Edit option (Pencil Icon).
* Click on the Edit option (Pencil icon) to edit the formula.
You can click `Delete` to delete the calculated field.
* Modify the formula as per needed.
* Click `Update` to update the derived column.
* Click `Delete` to delete the derived column.
The calculated field should now have updated.
The column will no longer exist if you chose to `Delete` the column.
Click on `Import` to import the data to a Google Sheet along with the derived column.
## **Formula Glossary**
Explore a comprehensive list of operators and functions to enhance your derived columns. The glossary includes essential mathematical, string, date, and logical functions, along with examples to help you create powerful formulae in Superjoin.
# Derived Columns String Functions
Source: https://docs.superjoin.ai/features/derived-columns/string-functions
Explore a set of string manipulation functions that allow you to perform operations like concatenation, substring extraction, text replacement, and case conversion. These functions are useful for cleaning, formatting, and analyzing textual data in customer and transactional records, ensuring consistency and accuracy in your dataset.
### **CONCAT (Concatenate)**
* **Syntax**: **`concat(value_1, value_2, ...)`**
* **About**: Joins two or more text strings into one continuous string.
* **Example**: Combine first and last names in Chargebee data with **`concat(first_name, " ", last_name)`**.
### **CONTAINS (Text Contains)**
* **Syntax**: **`contains(string, search_string)`**
* **About**: Checks if the first string contains the second string.
* **Example**: To check if a transaction description contains the word "refund", use **`contains(description, "refund")`**.
### **LENGTH (String Length)**
* **Syntax**: **`length(string)`**
* **About**: Returns the number of characters in a string.
* **Example**: Measure the length of a customer comment with **`length(comment)`**.
### **LOWER (Convert to Lowercase)**
* **Syntax**: **`lower(string)`**
* **About**: Converts a text string to all lowercase letters.
* **Example**: Standardize email addresses for comparison with **`lower(email)`**.
### **POSITION (Find Substring)**
* **Syntax**: **`position(string, search_string)`**
* **About**: Finds the starting position of a substring within a string.
* **Example**: Locate the position of "@" in an email address with **`position(email, "@")`**.
### **REPLACE (Replace Substring)**
* **Syntax**: **`replace(string, old_string, new_string)`**
* **About**: Replaces occurrences of a specified substring within a string with a new substring.
* **Example**: Correct a common misspelling in customer feedback with **`replace(feedback, "recieved", "received")`**.
### **SUBSTRING (Extract Substring)**
* **Syntax**: **`substring(string, start_position, length)`**
* **About**: Extracts a substring from a string starting at a specified position for a certain length.
* **Example**: To extract a product code from a string, use **`substring(product_info, 4, 8)`** where the code starts at the 4th character and is 8 characters long.
### **UPPER (Convert to Uppercase)**
* **Syntax**: **`upper(string)`**
* **About**: Converts a text string to all uppercase letters.
* **Example**: For a Chargebee invoice reference to be displayed in uppercase, use **`upper(invoice_ref)`**.
### **FIND (Find Text Position)**
* **Syntax**: **`FIND(search_for, text_to_search, [starting_at])`**
* **About**: Returns the position at which a string is first found within another string.
* **Example**: To find where a customer's country code appears in an address, **`FIND("US", address)`** might be used. Returns the position of US in Address column string.
### **TRIM (Trim Spaces)**
* **Syntax**: **`TRIM(text)`**
* **About**: Removes any leading and trailing spaces from a text string.
* **Example**: Trim excess spaces from customer-entered names with **`TRIM(customer_name)`**.
# What's your Export goal?
Source: https://docs.superjoin.ai/features/exports
Based on the usecase you're trying to achieve with Superjoin Exports, choose one of the options below
### Insert new data into your HubSpot
Available only on Google Sheets
### Make changes to existing HubSpot data
Available only on Google Sheets
### Insert new data into your HubSpot and make changes to existing HubSpot data at the same time
Available only on Google Sheets
### Associate data from one HubSpot object to another
Available only on Google Sheets
### Dissociate data of one HubSpot object from another
Available only on Google Sheets
### Delete data from your HubSpot
Available only on Google Sheets
# Flashbacks
Source: https://docs.superjoin.ai/features/flashbacks
Superjoin’s Flashbacks feature allows you to automate the creation of static data sheets on a weekly or monthly basis. This tool refreshes your data and stores it in a new static sheet according to your schedule. Follow the steps to configure and schedule Flashbacks to ensure your data is continuously updated and organized, making your data management and reporting tasks more efficient and systematic.
Only available on Google Sheets
## Follow the quickstart guide to get started with Superjoin 🚀
Install Superjoin in under a minute and start pulling your data instantly.
We've listed down common issues that you might face & how to fix it.
## Steps to create a flashback ✨
Ensure Superjoin is installed and working before following the rest of the
guide.
Click on the `Queries` tab. This will open the queries page in the sidebar.
Click on the desired query which you wish to create a flashback for.
You can use the Queries tab in the documentation to set-up queries.
Click on `+ New` button in the `Flashback` card.
* You can choose to create a flashback on a `weekly` or `monthly` basis.
* If `weekly`, select the desired `day of the week` and `time of the day`.
* If `monthly`, select the desired `date of the month` and `time of the day`.
**Advanced option (Optional):**
* Refresh mode provides the option to `append` or `replace` the data.
* **Append:** Appends the modified and new rows to the existing sheet.
* **Replace:** Replaces the modified rows and adds new rows to the existing sheet.
* Click on `Schedule` to schedule the flashback using the desired config.
* New schedule will be displayed in the `Flashbacks` card.
# Formula Auto Filldown
Source: https://docs.superjoin.ai/features/formulae-filldown
Only available on Google Sheets
### Introduction
Formula filldown automatically populates any formulas that you have in the spreadsheet in the immediate right columns of the imported data every time you refresh the data.
This saves you the time (and hassle) of manually going into your spreadsheet and copying your formula(s) down the row(s) manually.
## How to use Formula filldown
Use Superjoin to import data from your preferred source. Navigate to the `Sources` tab in the Superjoin sidebar, and connect to your
desired data source (e.g., HubSpot, Salesforce, etc). Click on import data (in data preview) and wait for your data to be populated on
Google sheet.
Open the sheet where you'd like to import data. Ensure that any formulas you want to apply to imported data are in the columns immediately
next to the imported data.
When you refresh the data, the formula you placed in the immediate next column will automatically populate down the rows of your imported
data during every refresh. No need to manually copy formulas anymore!
**Note:** Ensure the column with the formula is directly adjacent to the imported data, as the filldown only works for immediate
columns.
To automatically refresh your data and keep your formulas updated, you can schedule a refresh in Superjoin. Navigate to the `Schedule`
option and set a daily, weekly, or monthly refresh. Make sure to keep the Formula Auto-filldown mode on.
##
After the refresh, verify that your formulas have populated correctly in the new rows of the data, ensuring your spreadsheet stays up to
date.
***
## Frequently Asked Questions
**Q. Can I write formula on a column which is not the immediate column?**
No, if there is a gap between the imported data and the column with the formula, the formula will not be applied. Formulae filldown only works for columns immediately adjacent to the imported data.
**Q. Will it work if the formula is not on the first row of the data?**
Yes, the formula will still be applied even if it’s not in the first row. As long as the formula is in the column immediately next to the imported data, it will fill down through all the rows below it.
**Q. What happens when I have multiple columns that have formula?**
Superjoin will fill down all formulas in the immediate adjacent columns. If there are multiple formulas in the columns directly next to the data, they will all be applied during the refresh, maintaining the order of your data structure.
**Q. What is the behaviour when I setup a refresh schedule?**
You have the functionality to choose whether you wish to activate Formula filldown with the refresh schedule when you step up a schedule. With Formula filldown, all adjacent formulas will populate automatically with each data refresh, ensuring that your formulas always stay up-to-date.
# Create custom SQL queries
Source: https://docs.superjoin.ai/features/queries/create-queries
Learn how to create custom queries in Superjoin with a comprehensive guide. This section covers various methods, including writing SQL queries, using the Visual SQL Builder, and generating queries with AI. Follow the step-by-step instructions to import and manage your data effectively, ensuring a smooth setup and optimal data analysis.
Only available on Google Sheets
## Follow the quickstart guide to get started with Superjoin 🚀
Install Superjoin in under a minute and start pulling your data instantly.
We've listed down common issues that you might face & how to fix it.
## Steps to create queries ✨
Ensure Superjoin is installed and working before following the rest of the
guide.
Click on the `Sources` tab. This will open the sources page in the sidebar.
Click on the desired source which you wish to create a query for.
You can use the [Integrations](/integrations/summary) tab in the documentation to set-up an integration.
Click on `Create new import` button.
Choose between three query methods through which you would like to import your data.
* Click on `Custom Query` to use the custom query method.
* Enter the desired SQL query in the text area.
* Click on `Run Query` to preview the data.
* Click on `Visual SQL Builder` to use the visual SQL builder.
* Select a table and its desired columns to import.
Here, you can use a combination of columns from different tables to get the desired output.
E.g., Here we are trying to use the `id` from the `account` columns to fetch the `email` and `amount` from the
`account` and `investment` columns, respectively.
* Click on `Generate Query with AI` to generate a query for your data using AI.
* In the text area, type the desired prompt to generate a query for your data.
* Click on `Generate Query`.
* Click on `Run Query` to run the generated query.
Click on `Import` to import the data and wait for the data to be imported (optionally, create a refresh schedule).
* Click on the `3 dots` button on the top right corner of the desired query.
* Click on `Save Query`.
Fill in the `Name` and `Description (Optional)` of the query.
Click on the `Save Query` button to save the query.
# Share custom SQL queries
Source: https://docs.superjoin.ai/features/queries/share-queries
Easily share your custom queries with team members using Superjoin. This guide walks you through the process of sharing saved queries, including inviting users by email and managing access. Follow the steps to ensure your queries are accessible to your team, facilitating collaboration and efficient data analysis.
Only available on Google Sheets
## Follow the quickstart guide to get started with Superjoin 🚀
Install Superjoin in under a minute and start pulling your data instantly.
We've listed down common issues that you might face & how to fix it.
## Steps to share queries ✨
Ensure Superjoin is installed and working before following the rest of the
guide.
In the `Queries` tab, click on the `Saved Queries` button.
* Click on the `3 dots` button on the top right corner of the desired query.
* Click on `Share Query`.
* Enter the email addresses of the users you wish to share the query with.
* After entering the email addresses, click on the `Invite` button to add the users to the list.
* You can manage the access of the users by selecting the option next to their email address.
Available options:
* `Edit`: Can only run and see output of query and edit the saved query itself.
User in `Edit` mode will receive Full-Access to the underlying database if not already.
* `Run`: Can only run and see output of query.
User in `Run` mode will receive Limited-Access to the underlying database if not already.
Click the `Remove` button to remove a user from the list.
Click on the `Save Changes` button to invite users to the query.
# Add Refresh Button in Sheets
Source: https://docs.superjoin.ai/features/refresh-button
Only available on Google Sheets
## Motivation
You can share the Google Sheet with your customers or team members, and they can refresh the data themselves by simply clicking the refresh button. They do not need to register for Superjoin or manage an API key on their own. All the logic and API authentication are handled within the sample Apps Script function, making the process seamless for anyone using the sheet.
This feature allows you to:
* Maintain control over the API key.
* Ensure that customers can always access the latest data without needing to manually update it.
* Avoid the need for additional Superjoin registrations for each customer.
The refresh functionality applies only to sheets where only the initial data pull was done using Superjoin's Google Sheet Add on. Once data has been imported into a sheet via Superjoin, anyone the spreadsheet is shared with can refresh that data using the API key provided by the owner, ensuring easy and seamless updates.
## Step by Step Guide
To use this feature, you need to obtain an API key from Superjoin, by contacting us at [support@superjoin.ai](mailto:contact@superjoin.ai).
To store your API key:
1. Open your target spreadsheet in Google Sheets
2. Navigate to Extensions > Apps Script
3. In the Apps Script editor, click the Settings icon in the left panel
4. Scroll down to the Script Properties section
5. Click "Add script property"
6. Set the property name as "API\_KEY"
7. Set the value to the API key provided by Superjoin support
This securely stores your API key for use in the refresh function.
In this step, we will create a function to refresh the data in the active Google Sheet.
The `sheetId` used in this function refers to the ID of the active sheet where the Apps Script editor is opened. This means the function will refresh data for the currently active sheet. If you're working on a specific sheet in the editor, the refresh will be applied to that sheet alone.
```javascript Refresh Data for Active Sheet theme={null}
function refreshData() {
try {
const apiKey = PropertiesService.getScriptProperties().getProperty('API_KEY');
if (!apiKey) {
Logger.log("Missing API Key");
return;
}
const spreadsheetId = SpreadsheetApp.getActiveSpreadsheet().getId();
const sheetId = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet().getSheetId();
const BASE_URL = "https://api.superjoin.ai/public/v1";
const options = {
method: "post",
headers: {
authorization: `Api-Key ${apiKey}`,
},
contentType: 'application/json',
payload: JSON.stringify({
spreadsheetId,
sheetId,
metadata: {
userEmailAddress: Session.getActiveUser().getEmail(),
identifier: "EXTRA_IDENTIFIER"
}
})
};
const response = UrlFetchApp.fetch(`${BASE_URL}/import/refresh-data`, options);
if (response.getResponseCode() === 200) {
Logger.log("Data refresh initiated");
}
} catch (error) {
Logger.log(`Error while refreshing data: ${error.message}`);
}
}
```
In case you want to refresh multiple sheets, with a single click, you can use the follow the below instructions:
Execute the below function to get all the sheet IDs along with their names, and then replace the sheetIds array with the sheet IDs you want to refresh in the `refreshDataForMultipleSheets` function.
```javascript Get All Sheet IDs theme={null}
function getAllSheetIds() {
var sheets = SpreadsheetApp.getActiveSpreadsheet().getSheets();
for (var i = 0; i < sheets.length; i++) {
var sheet = sheets[i];
Logger.log(sheet.getSheetName() + ": " + sheet.getSheetId());
}
}
```
Now paste the remaining code in the Apps Script editor:
```javascript Refresh Data for Multiple Sheets theme={null}
function refreshDataForMultipleSheets() {
const sheetIds = ["SHEET_ID_1", "SHEET_ID_2", ...]; // Replace with your sheet IDs
const apiKey = PropertiesService.getScriptProperties().getProperty('API_KEY');
if (!apiKey) {
Logger.log("Missing API Key");
return;
}
const spreadsheetId = SpreadsheetApp.getActiveSpreadsheet().getId();
for (let sheetId of sheetIds) {
refreshData(apiKey, spreadsheetId, sheetId);
}
}
function refreshData(apiKey, spreadsheetId, sheetId) {
try {
const BASE_URL = "https://api.superjoin.ai/public/v1";
const options = {
method: "post",
headers: {
authorization: `Api-Key ${apiKey}`,
},
contentType: 'application/json',
payload: JSON.stringify({
spreadsheetId,
sheetId,
metadata: {
userEmailAddress: Session.getActiveUser().getEmail(),
}
})
};
const response = UrlFetchApp.fetch(`${BASE_URL}/import/refresh-data`, options);
if (response.getResponseCode() === 200) {
Logger.log(`Data refresh initiated for Sheet ID: ${sheetId}`);
}
} catch (error) {
Logger.log(`Error while refreshing data for Sheet ID ${sheetId}: ${error.message}`);
}
}
```
Do not forget to save the Apps Script file after making the changes, using the Floppy icon.
Go to the Insert menu of the same spreadsheet. Select Drawing from the dropdown options. In the drawing editor, create a rectangle and add text, such as "Refresh Data". You can customize the appearance as per your preference.
After inserting the button, click on the three dots in the top-right corner of the button and select Assign Script. In the dialog box that appears, enter the name of the function (e.g., `refreshData`). Click OK to assign the function to the button.
In case, you are refreshing multiple sheets, use the script name as `refreshDataForMultipleSheets`
Run the script throught the button you created in the first step, by clicking on it, and you will see the data is refreshed, in a few seconds or minutes (depends on the size of the data you have).
If you need more help, you can always contact us at [support@superjoin.ai](mailto:support@superjoin.ai).
# Scheduled Data Imports
Source: https://docs.superjoin.ai/features/scheduled-refresh
Scheduled Imports in Superjoin automates the process of keeping your data up-to-date by creating new static sheets on a regular basis—hourly, daily, weekly, or monthly. This feature helps ensure that your data remains current without manual intervention, allowing you to focus on analysis rather than data management.
Only available on Google Sheets
## Follow the quickstart guide to get started with Superjoin 🚀
Install Superjoin in under a minute and start pulling your data instantly.
We've listed down common issues that you might face & how to fix it.
## Steps to create a scheduled Imports ✨
Ensure Superjoin is installed and working before following the rest of the guide.
### **Scheduled refreshes can be created in 2 ways:**
Import the data after configuring the query.
Click on the `Import` button to import the data.
A scheduled Imports can be created in the last step of creating a custom SQL query. Follow the guide to create a custom SQL query [here](/features/queries/create-queries).
After a successful import, a drawer will open up with the option to create a scheduled refresh.
* You can choose to create a scheduled Imports right away or click `I'll do this later` to skip it.
* You can choose to creata a scheduled Imports on an `hourly`, `daily`, `weekly` or `monthly` basis.
* If `hourly`, select the desired `time interval` (Available intervals are `{6, 8, 12} hours`).
* If `daily`, select the desired `time of the day`.
* If `weekly`, select the desired `day of the week` and `time of the day`.
* If `monthly`, select the desired `date of the month` and `time of the day`.
**Advanced option (Optional):**
* Refresh mode provides the option to `append` or `replace` the data.
* **Append:** Appends the modified and new rows to the existing sheet.
* **Replace:** Replaces the modified rows and adds new rows to the existing sheet.
You can also create a `Flashback`, learn more about it [here](/features/flashbacks).
* Click on `Schedule` to schedule the Imports using the desired config.
* New schedule will be displayed in the `Automatic Refreshes` card.
Click on the `Queries` tab. This will open the queries page in the sidebar.
Click on the desired query which you wish to create a flashback for.
You can use the `Queries` tab in the documentation to set-up queries.
Click on `Create Schedule` button in the `Automatic Refreshes` card.
* You can choose to creata a scheduled Imports on an `hourly`, `daily`, `weekly` or `monthly` basis.
* If `hourly`, select the desired `time interval` (Available intervals are `{6, 8, 12} hours`).
* If `daily`, select the desired `time of the day`.
* If `weekly`, select the desired `day of the week` and `time of the day`.
* If `monthly`, select the desired `date of the month` and `time of the day`.
**Advanced option (Optional):**
* Refresh mode provides the option to `append` or `replace` the data.
* **Append:** Appends the modified and new rows to the existing sheet.
* **Replace:** Replaces the modified rows and adds new rows to the existing sheet.
You can also create a `Flashback`, learn more about it [here](/features/flashbacks).
* Click on `Schedule` to schedule the refresh using the desired config.
* New schedule will be displayed in the `Automatic Refreshes` card.
# Share Connection with Your Teammates
Source: https://docs.superjoin.ai/features/share-source-connection
Sharing a source connection in Superjoin allows you to collaborate with others by granting access to your data sources. This feature is useful for teams or projects where multiple users need to interact with the same data sources.
## How Team Sharing Works
Unlike traditional user management systems (like HubSpot or Intercom), Superjoin doesn't have centralized account management. **Each teammate is an independent user** with their own Superjoin installation.
When you share a connection, you're granting access to that resource within their own instance—not adding them to a shared account.
**Workspaces & Visibility**
Users with the same email domain (e.g., `@company.com`) are automatically grouped into the same workspace.
**Key Point:** Being in the same workspace lets you **see** teammates' queries on shared sheets, but you **cannot interact with them** (refresh, edit, or export) unless the source connection is explicitly shared with you.
👀 Visibility ≠ Access
**Prerequisites Before Sharing**
Your teammates must have:
1. Superjoin installed on Google Sheets or Microsoft Excel
2. Launched Superjoin at least once to set up their account
Without these, they won't be able to access shared connections.
## Permission Levels
Choose the right access level based on what your teammate needs to do:
| Action | Read-Only | Read-Write | Full/Admin |
| -------------- | --------- | ---------- | ---------- |
| Refresh only | ✓ | ✓ | ✓ |
| Edit an import | ⛔ | ⛔ | ✓ |
| Export only | ⛔ | ✓ | ✓ |
| Edit an export | ⛔ | ⛔ | ✓ |
## Steps to share source connection ✨
Ensure Superjoin is installed and working before following the rest of the guide.
Go to the `Sources` page by clicking on the `Sources` button in the `Get Started` section or by clicking on the `Sources` tab on the bottom of the sidebar.
* Click on the `3 dots` button on the top right corner of the desired source.
* Click on `Share`.
* Enter the email addresses of the users you wish to share the source connection with.
* After entering the email addresses, click on the `Invite` button to add the users to the list.
Select the access level for each user from the dropdown next to their email address:
* **Admin** — Full access to create, modify, and run imports/exports
* **Read-Write** — Can refresh imports and run exports (no editing)
* **Read-Only** — Can only refresh existing imports
You can click `Remove` to revoke access for any user.
Click `Save Changes` to finalize and share the connection with your teammates.
Ensure Superjoin is installed and working before following the rest of the guide.
Go to the `Sources` page by clicking on the `Sources` button in the `Get Started` section or by clicking on the `Sources` tab on the bottom of the sidebar.
Click on the `Share` logo that's on the right side of your desired connection.
* Enter the email addresses of the users you wish to share the source connection with.
* After entering the email addresses, click on the `Invite` button to add the users to the list.
Select the access level for each user from the dropdown next to their email address:
* **Full** — Can create, modify, and run imports/exports
* **Limited** — Can only refresh existing imports
You can click `Remove` to revoke access for any user.
Click `Save Changes` to finalize and share the connection with your teammates.
***
## Related Resources
Learn how to share saved custom SQL queries with teammates.
New to Superjoin? Get started in under a minute.
# How to Acquire Airtable Credentials?
Source: https://docs.superjoin.ai/integrations/Airtable/credentials
Proceed with the outlined steps to acquire Airtable credentials.
## Step-by-step walkthrough: How to obtain Airtable API Keys
Go to [https://airtable.com/create/tokens](https://airtable.com/create/tokens) to create new token.
Add following scopes: data.records:read, data.recordComments:read, schema.bases:read
Select required bases or allow access to all available and press the Create Token button.
Save token from the popup window.
For more details, use Airtable Documentation: [https://airtable.com/developers/web/guides/personal-access-tokens](https://airtable.com/developers/web/guides/personal-access-tokens)
## Setting up Airtable
Head over to the Airtables Overview page to get a step by step guide to connect.
# Connect your Airtable to Google Sheets
Source: https://docs.superjoin.ai/integrations/Airtable/overview
Effortlessly link your Airtable data to Google Sheets for streamlined reporting and analysis.
Please note that the Airtable integration is in beta at the moment. If you face any issues, please reach out to us at [support@superjoin.ai](mailto:support@superjoin.ai)
and we will help you asap!
### Why use Superjoin’s Google Sheets-Airtable Integration?
We've meticulously organized the data points to ensure easy accessibility in a format you're already familiar with.
Get a sneak peek of your data. Select columns, apply filters & limits as per your need before importing.
Enjoy one-click refreshes or schedule regular updates to ensure your sheets are always up to date.
Benefit from Google Sheets' collaborative data analysis & other powerful capabilities.
## Step-by-step walkthrough: How to connect Airtable to Google Sheets.
Select `Add-ons` and choose `Get Add-ons`. This action will redirect you to the Google Workspace Marketplace.
In the Google Workspace Marketplace pop-up window, search for "Superjoin".
Click on `Extensions` from the Google Sheets menu.
**Note:** For the best experience, install Superjoin where there's only a single account is logged in the Chrome profile.
Once installed, navigate back to the `Extensions` menu tab in Google Sheets. Launch Superjoin from here. You should now see Superjoin running as a side panel on the right side of your screen.
Select Airtable from the list of available data sources.
Connect your Airtable account. Go through all the directions and prompts to connect your Airtable account to Google Sheets.
Now select the objects from the list you want to import from.
Select the filters that you want to apply in order to filter down the data that you want to work on.
Select the items that you want to sort.
Now simply Enter the Limit of rows you want to write on Google Sheet.
Now simply click on the "import" button to bring this selected data into your Google Sheets.
Superjoin lets you refresh your imported data instantly with one click or set it to auto-refresh on a pre-set schedule. This way, you won’t need to manually update your Airtable data in Google Sheets to reflect changes from the source.
# Frequently faced issues during Attio Connect
Source: https://docs.superjoin.ai/integrations/Attio/common-issues
We have listed down some common issues that our customers usually face while trying to authenticate Attio using Superjoin.
## Solution
Go back to `Sources` in Superjoin and click on `Connect` again to restart the authorization flow with Attio.
Make sure you are signed in to the correct Attio workspace and that you have access to the records you want to import. Workspace admins can review member access from Attio's workspace settings.
If you are still facing the same issue, reach out to [support@superjoin.ai](mailto:support@superjoin.ai) and we will help you.
## Solution
Only objects available in your Attio workspace will show up. Custom objects appear once they've been created in Attio.
You will only see records you have access to in Attio. Ask a workspace admin to grant access if records are missing.
Not sure what to do next? Reach out to us at [support@superjoin.ai](mailto:support@superjoin.ai). We will respond immediately.
# Delete Connected Attio Account
Source: https://docs.superjoin.ai/integrations/Attio/delete-connection
Step by Step guide to delete your Attio account from Superjoin
Please note that deleting an Attio connection from Superjoin is permanent. You may not be able to recover it again.
Launch Superjoin and navigate to `Sources` from the bottom navigation pane.
Click on the 3-dot menu of the Attio account you wish to delete. Click on `Delete` and confirm it.
When you delete a connection on Superjoin, all associated imports will also be deleted & the associated import
schedules will be stopped. Your imported sheets however will not be impacted due to a deletion of an object.
# How to import data from Attio to Spreadsheets
Source: https://docs.superjoin.ai/integrations/Attio/import
Step-by-step guide to import data from Attio to Google Sheets or Microsoft Excel
After connecting your account, a data preview window will appear, allowing you to select an `Object` to import and apply various `Filters` to refine your data.
Add/modify the data fields you want to import. The `Fields` you selected should start showing up in the data preview section. You may need to click `Refresh Preview` to see the changes.
Optionally, select the fields you want to sort your data by before importing.
Optionally, enter the limit of rows you want to write into your Google Sheet.
After previewing the data, click on `Import` and wait for a few seconds. This action transfers the selected data from your Attio workspace into Google Sheets.
You can schedule a `Refresh` to automatically update your data hourly, daily, weekly, or monthly at a specific time. This way, you won't need to manually update your Attio data in Google Sheets to reflect changes from the source.
Learn more about how to set up auto-refresh schedules here.
##### Hope this guide helped you import your data from Attio to Google Sheets using Superjoin.
##### If you have any questions or need further assistance, please don't hesitate to reach out to our support team at [support@superjoin.ai](mailto:support@superjoin.ai). Thank you!
After connecting your account, a data preview window will appear, allowing you to select an `Object` to import and apply various `Filters` to refine your data.
Add/modify the data fields you want to import. The `Fields` you selected should start showing up in the data preview section. You may need to click `Refresh Preview` to see the changes.
Optionally, select the fields you want to sort your data by before importing.
Optionally, enter the limit of rows you want to write into your Excel worksheet.
After previewing the data, click on `Import` and wait for a few seconds. This action transfers the selected data from your Attio workspace into Microsoft Excel.
The desired data has been successfully written on to your Excel sheet. Now whenever you want fresh data, just click on the `Pull Latest Data` button.
##### Hope this guide helped you import your data from Attio to Microsoft Excel using Superjoin.
##### If you have any questions or need further assistance, please don't hesitate to reach out to our support team at [support@superjoin.ai](mailto:support@superjoin.ai). Thank you!
# Attio Data Connector for Spreadsheets
Source: https://docs.superjoin.ai/integrations/Attio/overview
Welcome to the Attio Data Connector's Support Documentation page.
The Attio connector currently supports **importing data from Attio into Google Sheets and Microsoft Excel**. Two-way sync
(syncing changes back to Attio) is not available yet.
Still can't find answers here? Email us at [support@superjoin.ai](mailto:support@superjoin.ai) and we will help you asap!
### Getting Started
Connect your Attio account to start importing data into Google Sheets or Microsoft Excel.
Address issues that you might face while connecting your Attio a/c.
Step-by-step guide to import data from Attio to Google Sheets or Microsoft Excel
### Attio Objects
A list of supported Attio Objects for Import.
### Data Management
Steps to delete/erase your Attio account from Superjoin
# Connect your Attio account to Spreadsheets
Source: https://docs.superjoin.ai/integrations/Attio/quickstart
Effortlessly connect Attio to Google Sheets or Microsoft Excel to import your CRM data using Superjoin in a few clicks.
We've meticulously organized the data points to ensure easy accessibility in a format you're already familiar
with.
Get a sneak peek of your data. Select columns, apply filters & limits as per
your need before importing.
Enjoy one-click refreshes or schedule regular updates to ensure your sheets
are always up to date.
Benefit from Google Sheets' collaborative data analysis & other powerful
capabilities.
## Step-by-step walkthrough: How to connect Attio to Google Sheets
Head over to `Extensions`, select `Add-ons` and choose `Get Add-ons`. This action will redirect you to the
Google Workspace Marketplace.
In the Google Workspace Marketplace pop-up window, search for "Superjoin".
Click on the `Install` button to install Superjoin.
**Note:** For the best experience, install Superjoin where there's only a single account logged in the
Chrome profile.
Once installed, navigate back to the `Extensions` menu tab in Google Sheets. Launch Superjoin from here. You
should now see Superjoin running as a side panel on the right side of your screen.
Navigate to `Sources`, select `Connect to a new source` and search for `Attio`.
Click on the `Connect` button and follow the on-screen instructions to authorize Superjoin to access your Attio workspace.
In case you belong to multiple Attio workspaces, choose the one you want to import the data from.
After connecting your account, a data preview window will appear, allowing you to pick an `Object` and apply
various `Filters` to refine your data.
Once connected, head over to the card below for a detailed guide on importing your data.
Step-by-step guide to import data from Attio to Google Sheets
We've meticulously organized the data points to ensure easy accessibility in a format you're already familiar
with.
Get a sneak peek of your data. Select columns, apply filters & limits as per
your need before importing.
Enjoy one-click refreshes to ensure your sheets are always up to date.
Benefit from Microsoft Excel's powerful data analysis & visualization capabilities.
## Step-by-step walkthrough: How to connect Attio to Microsoft Excel
Click on `Add-ins` on the right side of the Excel toolbar.
Click on the searchbar and type "Superjoin". The results would show our add-in under the `More search results` section.
Once Superjoin launches as a side panel, just click on `Sign in with Microsoft` and follow the steps to authenticate your Microsoft Office account with Superjoin.
You should now see Superjoin running as a side panel on the right side of your screen.
Navigate to `Sources`, select `Connect to a new source` and search for `Attio`.
Click on the `Connect` button and follow the on-screen instructions to authorize Superjoin to access your Attio workspace.
In case you belong to multiple Attio workspaces, choose the one you want to import the data from.
After connecting your account, a data preview window will appear, allowing you to pick an `Object` and apply
various `Filters` to refine your data.
Once connected, head over to the card below for a detailed guide on importing your data.
Step-by-step guide to import data from Attio to Microsoft Excel
# Supported Attio Objects
Source: https://docs.superjoin.ai/integrations/Attio/supported-objects
Attio Objects supported for Importing Data using Superjoin
These objects are supported for **importing** into Google Sheets and Microsoft Excel. Two-way sync (syncing changes back
to Attio) is not available yet.
| Section | Object | Description |
| -------------------- | -------------- | -------------------------------------------------------- |
| **Standard Objects** | People | Individual people you're engaging with |
| | Companies | Organizations you're working with |
| | Deals | Sales opportunities |
| | Users | Users of your product, linked to people and workspaces |
| | Workspaces | Customer workspaces or accounts within your product |
| **Custom Objects** | Custom Objects | Any custom object you've defined in your Attio workspace |
| **Collaboration** | Lists | Records grouped into Attio lists |
| | Notes | Notes attached to your records |
| | Tasks | To-do items linked to your records |
# How to acquire Freshsales Credentials?
Source: https://docs.superjoin.ai/integrations/Freshsales/credentials
Proceed with the outlined steps to acquire Freshsales credentials.
## Step-by-step walkthrough: How to obtain Freshsales credentials
Click the Profile icon and select Settings. The Personal Settings page appears.
Click the `API SETTINGS` tab.
You can find the API key provided to you in the field Your API key. Click Copy to copy the key to your clipboard.
For more details, use Freshsales Documentation:
[https://crmsupport.freshworks.com/en/support/solutions/articles/50000002503-how-to-find-my-api-key-](https://crmsupport.freshworks.com/en/support/solutions/articles/50000002503-how-to-find-my-api-key-)
## Setting up Freshsales
Head over to the Freshsales overview page to get a step by step guide to connect.
# Connect your Freshsales to Spreadsheets
Source: https://docs.superjoin.ai/integrations/Freshsales/overview
Seamlessly integrate your Freshsales CRM data into Google Sheets or Microsoft Excel for streamlined sales reporting and analytics.
Please note that the Freshsales integration is in beta at the moment. If you face any issues, please reach out to us at
[support@superjoin.ai](mailto:support@superjoin.ai) and we will help you asap!
### Why use Superjoin's Google Sheets-Freshsales Integration?
We've meticulously organized the data points to ensure easy accessibility in a format you're already familiar with.
Get a sneak peek of your data. Select columns, apply filters & limits as per your need before importing.
Enjoy one-click refreshes or schedule regular updates to ensure your sheets are always up to date.
Benefit from Google Sheets' collaborative data analysis & other powerful capabilities.
## Step-by-step walkthrough: How to connect Freshsales to Google Sheets.
Select `Add-ons` and choose `Get Add-ons`. This action will redirect you to the Google Workspace Marketplace.
In the Google Workspace Marketplace pop-up window, search for "Superjoin".
Click on `Extensions` from the Google Sheets menu.
**Note:** For the best experience, install Superjoin where there's only a single account is logged in the Chrome profile.
Once installed, navigate back to the `Extensions` menu tab in Google Sheets. Launch Superjoin from here. You should now see Superjoin running as a side panel on the right side of your screen.
Select Freshsales from the list of available data sources.
Connect your Freshsales account. Go through all the directions and prompts to connect your Freshsales account to Google Sheets.
Now select the objects from the list you want to import from.
Select the filters that you want to apply in order to filter down the data that you want to work on.
Select the items that you want to sort.
Now simply Enter the Limit of rows you want to write on Google Sheet.
Now simply click on the "import" button to bring this selected data into your Google Sheets.
Superjoin lets you refresh your imported data instantly with one click or set it to auto-refresh on a pre-set schedule. This way, you won't need to manually update your Freshsales data in Google Sheets to reflect changes from the source.
### Why use Superjoin's Excel-Freshsales Integration?
We've meticulously organized the data points to ensure easy accessibility in a format you're already familiar
with.
Get a sneak peek of your data. Select columns, apply filters & limits as per
your need before importing.
Enjoy one-click refreshes to ensure your sheets are always up to date.
Benefit from Microsoft Excel's powerful data analysis & visualization capabilities.
## Step-by-step walkthrough: How to connect Freshsales to Microsoft Excel
Click on `Add-ins` on the right side of the Excel toolbar.
Click on the searchbar and type "Superjoin". The results would show our add-in under the `More search results` section.
Once Superjoin launches as a side panel, just click on `Sign in with Microsoft` and follow the steps to authenticate your Microsoft Office account with Superjoin.
You should now see Superjoin running as a side panel on the right side of your screen.
To begin, you can navigate to `Queries`, choose to `Create new query`.
Navigate to `Sources`, select `Connect to a new source` and search for `Freshsales`.
Click on the `Connect` button and follow the on-screen instructions to link your Freshsales account.
After connecting your account, you'll be prompted to select the objects from the list you want to import data from.
Select the filters that you want to apply to narrow down the data you want to work with.
Select the items that you want to sort your data by.
Enter the limit of rows you want to import into your Excel worksheet.
Click on the "Import" button to bring your selected Freshsales data into Microsoft Excel.
Your data has been imported successfully! You can refresh your data at any time by clicking the refresh button in the Superjoin panel.
##### Hope this guide helped you connect Freshsales to your spreadsheet using Superjoin.
##### If you have any questions or need further assistance, please don't hesitate to reach out to our support team at [support@superjoin.ai](mailto:support@superjoin.ai). Thank you!
# Connect your Google Ads to Spreadsheets
Source: https://docs.superjoin.ai/integrations/GoogleAds/overview
Effortlessly connect your Google Ads data to Google Sheets or Microsoft Excel for unified ads reporting and analysis.
### Why use Superjoin's Google Sheets-Google Ads Integration?
We've meticulously organized the data points to ensure easy accessibility in a format you're already familiar with.
Get a sneak peek of your data. Select columns, apply filters & limits as per your need before importing.
Enjoy one-click refreshes or schedule regular updates to ensure your sheets are always up to date.
Benefit from Google Sheets' collaborative data analysis & other powerful capabilities.
## Step-by-step walkthrough: How to connect Google Ads to Google Sheets.
Select `Add-ons` and choose `Get Add-ons`. This action will redirect you to the Google Workspace Marketplace.
In the Google Workspace Marketplace pop-up window, search for "Superjoin".
Click on `Extensions` from the Google Sheets menu.
**Note:** For the best experience, install Superjoin where there's only a single account logged in the Chrome profile.
Once installed, navigate back to the `Extensions` menu tab in Google Sheets. Launch Superjoin from here. You should now see Superjoin running as a side panel on the right side of your screen.
Click on "Connect new Source" and select Google Ads from the list of available data sources.
Follow the prompts to connect your Google Ads account.
Select the campaigns, ad groups, and metrics that you want to include in your report.
Apply any necessary filters to narrow down the data you want to work with.
Now simply click on the "Import" button to bring this selected data into your Google Sheets.
Superjoin lets you refresh your imported data instantly with one click or set it to auto-refresh on a pre-set schedule. This way, you won't need to manually update your Google Ads data in Google Sheets to reflect changes from the source.
### Why use Superjoin's Excel-Google Ads Integration?
We've meticulously organized the data points to ensure easy accessibility in a format you're already familiar with.
Get a sneak peek of your data. Select columns, apply filters & limits as per your need before importing.
Enjoy one-click refreshes to ensure your sheets are always up to date.
Benefit from Microsoft Excel's collaborative data analysis & other powerful capabilities.
## Step-by-step walkthrough: How to connect Google Ads to Microsoft Excel
Click on `Add-ins` on the right side of the Excel toolbar.
Click on the searchbar and type "Superjoin". The results would show our add-in under the `More search results` section.
Once Superjoin launches as a side panel, just click on `Sign in with Microsoft` and follow the steps to authenticate your Microsoft Office account with Superjoin.
You should now see Superjoin running as a side panel on the right side of your screen.
Navigate to `Sources`, click on "Connect new Source" and select Google Ads from the list of available data sources.
Follow the prompts to connect your Google Ads account.
Select the campaigns, ad groups, and metrics that you want to include in your report.
Apply any necessary filters to narrow down the data you want to work with.
Now simply click on the "Import" button to bring this selected data into your Microsoft Excel spreadsheet.
Superjoin lets you refresh your imported data instantly with one click. This way, you won't need to manually update your Google Ads data in Excel to reflect changes from the source.
##### Hope this guide helped you pull data from your Google Ads to your spreadsheet.
##### If you have any further doubts, please don't hesitate to reach out to our support team at [support@superjoin.ai](mailto:support@superjoin.ai). Thank you!
# Connect your Google Analytics to Spreadsheets
Source: https://docs.superjoin.ai/integrations/GoogleAnalytics/overview
Effortlessly connect your Google Analytics data to Google Sheets or Microsoft Excel for unified reporting and analysis.
### Why use Superjoin's Google Sheets-Google Analytics Integration?
We've meticulously organized the data points to ensure easy accessibility in a format you're already familiar with.
Get a sneak peek of your data. Select columns, apply filters & limits as per your need before importing.
Enjoy one-click refreshes or schedule regular updates to ensure your sheets are always up to date.
Benefit from Google Sheets' collaborative data analysis & other powerful capabilities.
## Step-by-step walkthrough: How to connect Google Analytics to Google Sheets.
Select `Add-ons` and choose `Get Add-ons`. This action will redirect you to the Google Workspace Marketplace.
In the Google Workspace Marketplace pop-up window, search for "Superjoin".
Click on `Extensions` from the Google Sheets menu.
**Note:** For the best experience, install Superjoin where there's only a single account logged in the Chrome profile.
Once installed, navigate back to the `Extensions` menu tab in Google Sheets. Launch Superjoin from here. You should now see Superjoin running as a side panel on the right side of your screen.
Click on "Connect new Source" and select Google Analytics from the list of available data sources.
Select the filters that you want to apply to filter down the data that you want to work on.
Now simply click on the "Import" button to bring this selected data into your Google Sheets.
Superjoin lets you refresh your imported data instantly with one click or set it to auto-refresh on a pre-set schedule. This way, you won't need to manually update your Google Analytics data in Google Sheets to reflect changes from the source.
### Why use Superjoin's Excel-Google Analytics Integration?
We've meticulously organized the data points to ensure easy accessibility in a format you're already familiar
with.
Get a sneak peek of your data. Select columns, apply filters & limits as per
your need before importing.
Enjoy one-click refreshes to ensure your sheets are always up to date.
Benefit from Microsoft Excel's powerful data analysis & visualization capabilities.
## Step-by-step walkthrough: How to connect Google Analytics 4 to Microsoft Excel
Click on `Add-ins` on the right side of the Excel toolbar.
Click on the searchbar and type "Superjoin". The results would show our add-in under the `More search results` section.
Once Superjoin launches as a side panel, just click on `Sign in with Microsoft` and follow the steps to authenticate your Microsoft Office account with Superjoin.
You should now see Superjoin running as a side panel on the right side of your screen.
To begin, you can navigate to `Queries`, choose to `Create new query`.
Navigate to `Sources`, select `Connect to a new source` and search for `Google Analytics`.
Click on the `Connect` button and follow the on-screen instructions to link your Google Analytics account.
Select your Google Analytics 4 property and view that you want to import data from.
After connecting your account, a data preview window will appear, allowing you to select metrics and dimensions, apply date ranges, and set various filters to refine your Google Analytics data.
Once you've configured your data selection, click the "Import" button to bring your Google Analytics data into Microsoft Excel.
Your data has been imported successfully! You can refresh your data at any time by clicking the refresh button in the Superjoin panel.
##### Hope this guide helped you pull data from your Google Analytics to your spreadsheet.
##### If you have any further doubts, please don't hesitate to reach out to our support team [support@superjoin.ai](mailto:support@superjoin.ai). Thank you!
# Connect Intercom to Google Sheets
Source: https://docs.superjoin.ai/integrations/Intercom
Seamlessly sync your Intercom customer engagement data into Google Sheets for comprehensive reporting.
Please note that the Intercom integration is in beta at the moment. If you face any issues, please reach out to us at
[support@superjoin.ai](mailto:support@superjoin.ai) and we will help you asap!
### Why use Superjoin’s Google Sheets-Intercom Integration?
We've meticulously organized the data points to ensure easy accessibility in a format you're already familiar with.
Get a sneak peek of your data. Select columns, apply filters & limits as per your need before importing.
Enjoy one-click refreshes or schedule regular updates to ensure your sheets are always up to date.
Benefit from Google Sheets' collaborative data analysis & other powerful capabilities.
## Step-by-step walkthrough: How to get Intercom API token
Log in to your Intercom account and navigate to the Developer Hub.
Click Your apps in the top-right corner, then click New app.
Choose an App name, select your Workspace from the dropdown, and click Create app.
To set the appropriate permissions, from the Authentication tab, click Edit in the top right corner and check the permissions you want to grant to the app. We recommend only granting read permissions (not write). Click Save when you are finished.
Under the Access token header, you will be prompted to regenerate your access token. Follow the instructions to do so, and copy the new token.
For more details, use Intercom Documentation:
[https://developers.intercom.com/docs/build-an-integration/learn-more/authentication/#access-tokens](https://developers.intercom.com/docs/build-an-integration/learn-more/authentication/#access-tokens)
# Connect Linkedin account to Google Sheets
Source: https://docs.superjoin.ai/integrations/LinkedinAds
Easily link your LinkedIn account to Google Sheets with Superjoin for seamless data integration and automatic updates.
## Step-by-step walkthrough: How to connect Linkedin Ads to Google Sheets
Select `Add-ons` and choose `Get Add-ons`. This action will redirect you to the Google Workspace Marketplace.
In the Google Workspace Marketplace pop-up window, search for "Superjoin".
Click on `Extensions` from the Google Sheets menu.
**Note:** For the best experience, install Superjoin where there's only a single account is logged in the Chrome profile.
Once installed, navigate back to the `Extensions` menu tab in Google Sheets. Launch Superjoin from here. You should now see Superjoin running as a side panel on the right side of your screen.
Select Linkedin Ads from the list of available data sources.
Connect your Linkedin Ads account. Go through all the directions and prompts to connect your Linkedin Ads account to Google Sheets.
Now select the Ad Account along with the metrics and pivots that you wish to apply to bring into Google Sheets.
Select the filters that you want to apply in order to filter down the data that you want to work on.
Now simply click on the "import" button to bring this selected data into your Google Sheets.
Superjoin lets you refresh your imported data instantly with one click or set it to auto-refresh on a pre-set schedule. This way, you won’t need to manually update your Linkedin Ads data in Google Sheets to reflect changes from the source.
### Why use Superjoin’s Google Sheets-Linkedin Integration?
We've meticulously organized the data points to ensure easy accessibility in a format you're already familiar with.
Get a sneak peek of your data. Select columns, apply filters & limits as per your need before importing.
Enjoy one-click refreshes or schedule regular updates to ensure your sheets are always up to date.
Benefit from Google Sheets' collaborative data analysis & other powerful capabilities.
# How to acquire MailChimp Credentials?
Source: https://docs.superjoin.ai/integrations/Mailchimp/credentials
Proceed with the outlined steps to acquire MailChimp credentials.
## Step-by-step walkthrough: How to obtain Mailchimp API token
Click your profile icon and choose Profile.
Click the Extras drop-down then choose API keys.
In the Your API Keys section, click Create A Key.
Name your key as Superjoin-readonly. Keep in mind that you'll see only this name and the first 4 key digits on your list of API keys. Click Generate Key.
Once Mailchimp generates your key, click Copy Key to Clipboard. Save your key someplace secure, you won't be able to see or copy it again.
For more details, use Mailchimp Documentation: [https://mailchimp.com/help/about-api-keys/#api+key+security](https://mailchimp.com/help/about-api-keys/#api+key+security)
## Setting up Mailchimp
Head over to the Mailchimp overview page to get a step by step guide to connect.
# Connect your Mailchimp to Spreadsheets
Source: https://docs.superjoin.ai/integrations/Mailchimp/overview
Quickly sync your Mailchimp email marketing data into Google Sheets or Microsoft Excel for enhanced reporting and analytics.
Please note that the Mailchimp integration is in beta at the moment. If you face any issues, please reach out to us at
[support@superjoin.ai](mailto:support@superjoin.ai) and we will help you asap!
### Why use Superjoin's Google Sheets-Mailchimp Integration?
We've meticulously organized the data points to ensure easy accessibility in a format you're already familiar with.
Get a sneak peek of your data. Select columns, apply filters & limits as per your need before importing.
Enjoy one-click refreshes or schedule regular updates to ensure your sheets are always up to date.
Benefit from Google Sheets' collaborative data analysis & other powerful capabilities.
## Step-by-step walkthrough: How to connect Mailchimp to Google Sheets.
Select `Add-ons` and choose `Get Add-ons`. This action will redirect you to the Google Workspace Marketplace.
In the Google Workspace Marketplace pop-up window, search for "Superjoin".
Click on `Extensions` from the Google Sheets menu.
**Note:** For the best experience, install Superjoin where there's only a single account is logged in the Chrome profile.
Once installed, navigate back to the `Extensions` menu tab in Google Sheets. Launch Superjoin from here. You should now see Superjoin running as a side panel on the right side of your screen.
Select Mailchimp from the list of available data sources.
Connect your Mailchimp account. Go through all the directions and prompts to connect your Mailchimp account to Google Sheets.
Now select the objects from the list you want to import from.
Select the filters that you want to apply in order to filter down the data that you want to work on.
Select the items that you want to sort.
Now simply Enter the Limit of rows you want to write on Google Sheet.
Now simply click on the "import" button to bring this selected data into your Google Sheets.
Superjoin lets you refresh your imported data instantly with one click or set it to auto-refresh on a pre-set schedule. This way, you won't need to manually update your Mailchimp data in Google Sheets to reflect changes from the source.
### Why use Superjoin's Excel-Mailchimp Integration?
We've meticulously organized the data points to ensure easy accessibility in a format you're already familiar
with.
Get a sneak peek of your data. Select columns, apply filters & limits as per
your need before importing.
Enjoy one-click refreshes to ensure your sheets are always up to date.
Benefit from Microsoft Excel's powerful data analysis & visualization capabilities.
## Step-by-step walkthrough: How to connect Mailchimp to Microsoft Excel
Click on `Add-ins` on the right side of the Excel toolbar.
Click on the searchbar and type "Superjoin". The results would show our add-in under the `More search results` section.
Once Superjoin launches as a side panel, just click on `Sign in with Microsoft` and follow the steps to authenticate your Microsoft Office account with Superjoin.
You should now see Superjoin running as a side panel on the right side of your screen.
To begin, you can navigate to `Queries`, choose to `Create new query`.
Navigate to `Sources`, select `Connect to a new source` and search for `Mailchimp`.
Click on the `Connect` button and follow the on-screen instructions to link your Mailchimp account.
After connecting your account, select the objects from the list that you want to import data from.
Select the filters you want to apply to refine the data you'll be working with.
Select the items you want to sort by to organize your Mailchimp data.
Enter the limit of rows you want to import into Microsoft Excel.
Once you've configured your data selection, click the "Import" button to bring your Mailchimp data into Microsoft Excel.
Your data has been imported successfully! You can refresh your data at any time by clicking the refresh button in the Superjoin panel.
##### Hope this guide helped you connect Mailchimp to your spreadsheet using Superjoin.
##### If you have any questions or need further assistance, please don't hesitate to reach out to our support team [support@superjoin.ai](mailto:support@superjoin.ai). Thank you!
# Outreach [Soon]
Source: https://docs.superjoin.ai/integrations/Outreach
Connect Outreach to Google Sheets in a few clicks
We're working hard in getting this integration up and running. Please drop us an email at [support@superjoin.ai](mailto:support@superjoin.ai) and join the waitlist,
we'll ship it even soon. Promise.
### Why use Superjoin’s Google Sheets-Outreach Integration?
We've meticulously organized the data points to ensure easy accessibility in a format you're already familiar with.
Get a sneak peek of your data. Select columns, apply filters & limits as per your need before importing.
Enjoy one-click refreshes or schedule regular updates to ensure your sheets are always up to date.
Benefit from Google Sheets' collaborative data analysis & other powerful capabilities.
# How to acquire Pipedrive Credentials?
Source: https://docs.superjoin.ai/integrations/Pipedrive/credentials
Proceed with the outlined steps to acquire Pipedrive credentials.
## Step-by-step walkthrough: How to obtain Pipedrive credentials
Click on Profile icon on top-right side and select Company Settings
Choose Personal preferences and then select API
Copy the API key and use it in Superjoin.
For more details, use Pipedrive Documentation: [https://pipedrive.readme.io/docs/how-to-find-the-api-token](https://pipedrive.readme.io/docs/how-to-find-the-api-token)
## Setting up Pipedrive
Head over to the Pipedrive page to get a step by step guide to connect.
# Connect your Pipedrive to Spreadsheets
Source: https://docs.superjoin.ai/integrations/Pipedrive/overview
Effortlessly connect your Pipedrive CRM data to Google Sheets or Microsoft Excel for unified sales pipeline management and reporting.
### Why use Superjoin's Google Sheets-Pipedrive Integration?
We've meticulously organized the data points to ensure easy accessibility in a format you're already familiar with.
Get a sneak peek of your data. Select columns, apply filters & limits as per your need before importing.
Enjoy one-click refreshes or schedule regular updates to ensure your sheets are always up to date.
Benefit from Google Sheets' collaborative data analysis & other powerful capabilities.
## Step-by-step walkthrough: How to connect Pipedrive to Google Sheets.
Select `Add-ons` and choose `Get Add-ons`. This action will redirect you to the Google Workspace Marketplace.
In the Google Workspace Marketplace pop-up window, search for "Superjoin".
Click on `Extensions` from the Google Sheets menu.
**Note:** For the best experience, install Superjoin where there's only a single account is logged in the Chrome profile.
Once installed, navigate back to the `Extensions` menu tab in Google Sheets. Launch Superjoin from here. You should now see Superjoin running as a side panel on the right side of your screen.
Select Pipedrive from the list of available data sources.
Connect your Pipedrive account. Go through all the directions and prompts to connect your Pipedrive account to Google Sheets.
Now select the objects from the list you want to import from.
Select the filters that you want to apply in order to filter down the data that you want to work on.
Select the items that you want to sort.
Now simply Enter the Limit of rows you want to write on Google Sheet.
Now simply click on the "import" button to bring this selected data into your Google Sheets.
Superjoin lets you refresh your imported data instantly with one click or set it to auto-refresh on a pre-set schedule. This way, you won't need to manually update your Pipedrive data in Google Sheets to reflect changes from the source.
### Why use Superjoin's Excel-Pipedrive Integration?
We've meticulously organized the data points to ensure easy accessibility in a format you're already familiar
with.
Get a sneak peek of your data. Select columns, apply filters & limits as per
your need before importing.
Enjoy one-click refreshes to ensure your sheets are always up to date.
Benefit from Microsoft Excel's powerful data analysis & visualization capabilities.
## Step-by-step walkthrough: How to connect Pipedrive to Microsoft Excel
Click on `Add-ins` on the right side of the Excel toolbar.
Click on the searchbar and type "Superjoin". The results would show our add-in under the `More search results` section.
Once Superjoin launches as a side panel, just click on `Sign in with Microsoft` and follow the steps to authenticate your Microsoft Office account with Superjoin.
You should now see Superjoin running as a side panel on the right side of your screen.
To begin, you can navigate to `Queries`, choose to `Create new query`.
Navigate to `Sources`, select `Connect to a new source` and search for `Pipedrive`.
Click on the `Connect` button and follow the on-screen instructions to link your Pipedrive account.
After connecting your account, you'll be prompted to select the objects from the list you want to import data from.
Select the filters that you want to apply to narrow down the data you want to work with.
Select the items that you want to sort your data by.
Enter the limit of rows you want to import into your Excel worksheet.
Click on the "Import" button to bring your selected Pipedrive data into Microsoft Excel.
Your data has been imported successfully! You can refresh your data at any time by clicking the refresh button in the Superjoin panel.
##### Hope this guide helped you connect Pipedrive to your spreadsheet using Superjoin.
##### If you have any questions or need further assistance, please don't hesitate to reach out to our support team at [support@superjoin.ai](mailto:support@superjoin.ai). Thank you!
# Connect Recurly to Google Sheets
Source: https://docs.superjoin.ai/integrations/Recurly
Easily link your Recurly account to Google Sheets with Superjoin for seamless data integration and automatic updates.
Please note that the Recurly integration is in beta at the moment. If you face any issues, please reach out to us at
[support@superjoin.ai](mailto:support@superjoin.ai) and we will help you asap!
### Why use Superjoin’s Google Sheets-Recurly Integration?
We've meticulously organized the data points to ensure easy accessibility in a format you're already familiar with.
Get a sneak peek of your data. Select columns, apply filters & limits as per your need before importing.
Enjoy one-click refreshes or schedule regular updates to ensure your sheets are always up to date.
Benefit from Google Sheets' collaborative data analysis & other powerful capabilities.
## Step-by-step walkthrough: How to obtain Recurly API keys
Navigate to Integrations > API Credentials -: as a User assigned a Role that includes the Integration permission.
Scroll to the bottom and select Add Private API Key.
Assign a name - Superjoin-readonly to your API key and specify the third-party application it's intended for - Superjoin.
Confirm by clicking Save Changes. You can copy the keys now.
For more details, use Recurly Documentation: [https://docs.recurly.com/docs/api-keys#section-find-or-generate-your-api-key](https://docs.recurly.com/docs/api-keys#section-find-or-generate-your-api-key)
# Connect your Snowflake data warehouse to Google Sheets
Source: https://docs.superjoin.ai/integrations/Snowflake
Quickly link your Snowflake data warehouse to Google Sheets for hassle-free data integration.
## Step-by-step walkthrough: How to connect Snowflake to Google Sheets
Select `Add-ons` and choose `Get Add-ons`. This action will redirect you to the Google Workspace Marketplace.
Click on `Extensions` from the Google Sheets menu. **Note:** For the best experience, install Superjoin where there's only a single account is logged in the Chrome profile.
Once installed, navigate back to the `Extensions` menu tab in Google Sheets. Launch Superjoin from here. You should now see Superjoin running as a side panel on the right side of your screen.
Go to sources and click on "Connect new Source"
Type Snowflake in the search bar and click on Snowflake
Connect to your Snowflake account using your account, username, private key and\
warehouse name.
Login to your Snowflake account and click on `View account details` as shown in the screenshot below.
In the modal window, copy the account subdomain (highlighted in the screenshot).
Example: `https://{subdomain}.snowflakecomputing.com`
You may also note the User name.
Once you are done filling up `Account`, `User`, and `Warehouse`, You can begin authorization. Click on `Configure` under Private Key.
Snowflake supports RSA certificate for authorization.
Superjoin provides you 2 ways of authorization:
* **Create Key Pair** - Superjoin will create a key pair for you. We save the private key securely and provide you the public key. This public key has to be used in the Snowflake account.
* **Upload Private Key** - You can upload your private key file. We support both `encrypted` and `unencrypted` private keys. We will generate a public key which you can use in the Snowflake account.
When uploading an encrypted private key, you will need to provide the passphrase.
All your credentials will be encrypted with the highest industry standards. Learn more
Once you have decided on the way you want to authorize, you will be presented with a public key.
This will allow us to communicate with your Snowflake account. You may copy the public key and add it to your Snowflake account.
After copying the public key, you can add it to your Snowflake account. Head over to Snowflake. Here you may create a new SQL Workspace. Then in the code editor, you can paste the public key. Make sure to replace `` with your actual user name.
Once the query execution is successful, you can return to Superjoin. Clicking `Next` will close the modal window.
And you are all set to go! Click on `Authorize` to complete the process.
# How to get Stripe API key?
Source: https://docs.superjoin.ai/integrations/Stripe/credentials
Here are the steps to acquire API key from Stripe.
## Step-by-step walkthrough: How to get Stripe API Key
Click `Developers` in the bottom left corner in Stripe Dashboard Page.
In the top-left corner, click API keys.
Click on the "+ Create restricted key" button.
Select 3rd party access and click on Continue.
Enter Superjoin's details and check the "Customise permissions for this key" checkbox and click on "Create Restricted Key".
Choose a Key name, and select permissions based on what data you need to access. Below is a suggested set of permissions that will work well with Superjoin, but you can customize these based on exactly what data you want to integrate.
### Recommended Permissions Table
Below is a comprehensive table of suggested permissions for your Stripe Restricted API key. You can adjust these based on what specific data you want to access through Superjoin.
> **Note:** Most resources are set to "Read" permission to allow accessing data while maintaining security by not allowing write operations. Resources marked as "None" are typically not needed for data integration purposes.
| Category | Resource Type | Permissions |
| :---------------------- | :-------------------------------- | :---------- |
| **Core Resources** | | |
| Core | Apple Pay Domains | Read |
| Core | Balance | Read |
| Core | Balance transaction sources | Read |
| Core | Balance Transfers | Read |
| Core | Charges | Read |
| Core | Confirmation token | None |
| Core | Confirmation token (client) | None |
| Core | Customers | Read |
| Core | Customer session | Read |
| Core | Disputes | Read |
| Core | Ephemeral keys | None |
| Core | Events | None |
| Core | Files | None |
| Core | Funding Instructions | None |
| Core | Payment Intents | None |
| Core | Payment Methods | Read |
| Core | Payment Method Domains | Read |
| Core | Payouts | Read |
| Core | Products | Read |
| Core | Setup Intents | None |
| Core | Shipping Rates | Read |
| Core | Sources | Read |
| Core | Test clocks | None |
| Core | Tokens | None |
| **Billing Resources** | | |
| Billing | Coupons | Read |
| Billing | Promotion Codes | Read |
| Billing | Credit notes | Read |
| Billing | Customer portal | Read |
| Billing | Invoices | Read |
| Billing | Prices | Read |
| Billing | Subscriptions | Read |
| Billing | Quote | Read |
| Billing | Tax IDs | Read |
| Billing | Tax Rates | Read |
| Billing | Usage Records | Read |
| Billing | Meter Events | Read |
| Billing | Meter Event Adjustments | Read |
| **Checkout Resources** | | |
| Checkout | Checkout Sessions | Read |
| **Connect Resources** | | |
| Connect | Application Fees | None |
| Connect | Login Links | None |
| Connect | Account Links | None |
| Connect | Top-ups | None |
| Connect | Transfers | None |
| **Orders Resources** | | |
| Orders | Orders | Read |
| Orders | SKUs | Read |
| **Reporting Resources** | | |
| Reporting | Report Runs and Report Types | Read |
| **Tax Resources** | | |
| Tax | Tax Calculations and Transactions | Read |
| Tax | Tax Settings and Registrations | Read |
| **Issuing Resources** | | |
| Issuing | Authorizations | None |
| Issuing | Cardholders | None |
| Issuing | Cards | None |
| Issuing | Disputes | None |
| Issuing | Tokens | None |
| Issuing | Token Network Data | None |
| Issuing | Transactions | None |
| Issuing | Issuing Settlement | None |
| **Other Resources** | | |
| Sigma | Sigma API Permission | None |
| Financial Connections | Financial Connections | None |
| Identity | Verification Sessions and Reports | None |
| All Webhook | Webhook Endpoints | None |
| Stripe CLI | Debugging tools | None |
| Payment Links | Payment Links | None |
| Terminal | Configurations | None |
| Terminal | Locations | None |
| Terminal | Readers | None |
| Terminal | Connection Tokens | None |
| Radar | Reviews | None |
| Climate | Climate Orders | None |
Click on Create key. You may be prompted to enter a confirmation code sent to your mobile or email address.
The permissions table above provides a suggested configuration that works well for most Superjoin integrations with Stripe. You can modify these permissions based on what specific data you want to access through your integration. In general, Read-only permissions are safest and sufficient for data integration purposes.
For more details, use Stripe Documentation: [https://docs.stripe.com/keys](https://docs.stripe.com/keys)
## Setting up Stripe
Head over to the Stripe overview page to get a step by step guide to connect.
# Connect your Stripe to Google Sheets
Source: https://docs.superjoin.ai/integrations/Stripe/overview
Quickly sync your Stripe payment data into Google Sheets for streamlined financial tracking and reporting.
Please note that the Stripe integration is in beta at the moment. If you face any issues, please reach out to us at [support@superjoin.ai](mailto:support@superjoin.ai)
and we will help you asap!
### Why use Superjoin’s Google Sheets-Stripe Integration?
We've meticulously organized the data points to ensure easy accessibility in a format you're already familiar with.
Get a sneak peek of your data. Select columns, apply filters & limits as per your need before importing.
Enjoy one-click refreshes or schedule regular updates to ensure your sheets are always up to date.
Benefit from Google Sheets' collaborative data analysis & other powerful capabilities.
## Step-by-step walkthrough: How to connect Stripe to Google Sheets.
Select `Add-ons` and choose `Get Add-ons`. This action will redirect you to the Google Workspace Marketplace.
In the Google Workspace Marketplace pop-up window, search for "Superjoin".
Click on `Extensions` from the Google Sheets menu.
**Note:** For the best experience, install Superjoin where there's only a single account is logged in the Chrome profile.
Once installed, navigate back to the `Extensions` menu tab in Google Sheets. Launch Superjoin from here.
Go to `Sources` and click on "Connect new Source". Select Stripe from the list of available data sources.
Enter your Stripe API Key and click on "Authorize".
You need to create a `Rectricted API Key` with a specific set of permissions in order to authorize your Stripe account in Superjoin.
Head over to this page to get a detailed explanation on it.
Now select an Object from the list you want to import from.
Select the filters that you want to apply in order to filter down the data that you want to work on.
Enter the Limit of rows you want to write on Google Sheet.
Now simply click on the "Import" button to bring this selected data into your Google Sheets.
Superjoin lets you refresh your imported data instantly with one click or set it to auto-refresh on a pre-set schedule. This way, you won’t need to manually update your Stripe data in Google Sheets to reflect changes from the source.
# Connect your Xero to Google Sheets
Source: https://docs.superjoin.ai/integrations/Xero/overview
Effortlessly connect your Xero accounting data to Google Sheets for unified reporting and analysis.
### Why use Superjoin's Google Sheets-Xero Integration?
We've meticulously organized your accounting data to ensure easy accessibility in a format you're already familiar with.
Get a sneak peek of your financial data. Select invoices, contacts, accounts, and more before importing.
Enjoy one-click refreshes or schedule regular updates to ensure your financial reports are always up to date.
Combine Xero's robust accounting capabilities with Google Sheets' collaborative analysis features.
## Step-by-step walkthrough: How to connect Xero to Google Sheets.
Select `Add-ons` and choose `Get Add-ons`. This action will redirect you to the Google Workspace Marketplace.
In the Google Workspace Marketplace pop-up window, search for "Superjoin".
Click on `Extensions` from the Google Sheets menu.
**Note:** For the best experience, install Superjoin where there's only a single account logged in the Chrome profile.
Once installed, navigate back to the `Extensions` menu tab in Google Sheets. Launch Superjoin from here. You should now see Superjoin running as a side panel on the right side of your screen.
Click on "Connect new Source" and select Xero from the list of available data sources.
Choose the type of data you want to import (Invoices, Contacts, Accounts, Bank Transactions, etc.) and apply any filters to narrow down your selection.
Now simply click on the "Import" button to bring this selected data into your Google Sheets.
Superjoin lets you refresh your imported data instantly with one click or set it to auto-refresh on a pre-set schedule. This way, you won't need to manually update your Xero data in Google Sheets to reflect changes from the source.
##### Hope this guide helped you pull data from your Xero to Google Sheets.
##### If you have any further doubts, please don't hesitate to reach out to our support team [support@superjoin.ai](mailto:support@superjoin.ai). Thank you!
# How to get Zendesk API key?
Source: https://docs.superjoin.ai/integrations/Zendesk/credentials
Here are the steps to acquire API key from Zendesk.
## Step-by-step walkthrough: How to get Zendesk API
Log in to your Zendesk account. Click the Zendesk Products icon (four squares) in the top-right corner, then select Admin Center
In the left navbar, click Apps and Integrations, then select APIs > Zendesk API.
In the Settings tab, toggle the option to enable token access.
Click the Add API token button. You may optionally provide a token description.
For more details, use Zendesk Documentation:
[https://support.zendesk.com/hc/en-us/articles/4408889192858-Managing-access-to-the-Zendesk-API#topic\_bsw\_lfg\_mmb](https://support.zendesk.com/hc/en-us/articles/4408889192858-Managing-access-to-the-Zendesk-API#topic_bsw_lfg_mmb)
## Setting up Zendesk
Head over to the Zendesk overview page to get a step by step guide to
connect.
# Connect your Zendesk to Spreadsheets
Source: https://docs.superjoin.ai/integrations/Zendesk/overview
Easily integrate your Zendesk customer service data into Google Sheets or Microsoft Excel for centralized reporting and analysis.
Please note that the Zendesk integration is in beta at the moment. If you face
any issues, please reach out to us at [support@superjoin.ai](mailto:support@superjoin.ai) and we will help
you asap!
### Why use Superjoin's Google Sheets-Zendesk Integration?
We've meticulously organized the data points to ensure easy accessibility in a format you're already familiar with.
Get a sneak peek of your data. Select columns, apply filters & limits as per
your need before importing.
Enjoy one-click refreshes or schedule regular updates to ensure your sheets
are always up to date.
Benefit from Google Sheets' collaborative data analysis & other powerful
capabilities.
## Step-by-step walkthrough: How to connect Zendesk to Google Sheets.
Select `Add-ons` and choose `Get Add-ons`. This action will redirect you to the Google Workspace Marketplace.
In the Google Workspace Marketplace pop-up window, search for "Superjoin".
Click on `Extensions` from the Google Sheets menu.
**Note:** For the best experience, install Superjoin where there's only a single account is logged in the Chrome profile.
Once installed, navigate back to the `Extensions` menu tab in Google Sheets. Launch Superjoin from here. You should now see Superjoin running as a side panel on the right side of your screen.
Select Zendesk from the list of available data sources.
Connect your Zendesk account. Go through all the directions and prompts to connect your Zendesk account to Google Sheets.
Now select the objects from the list you want to import from.
Select the filters that you want to apply in order to filter down the data that you want to work on.
Select the items that you want to sort.
Now simply Enter the Limit of rows you want to write on Google Sheet.
Now simply click on the "import" button to bring this selected data into your Google Sheets.
Superjoin lets you refresh your imported data instantly with one click or set it to auto-refresh on a pre-set schedule. This way, you won't need to manually update your Zendesk data in Google Sheets to reflect changes from the source.
### Why use Superjoin's Excel-Zendesk Integration?
We've meticulously organized the data points to ensure easy accessibility in a format you're already familiar
with.
Get a sneak peek of your data. Select columns, apply filters & limits as per
your need before importing.
Enjoy one-click refreshes to ensure your sheets are always up to date.
Benefit from Microsoft Excel's powerful data analysis & visualization capabilities.
## Step-by-step walkthrough: How to connect Zendesk to Microsoft Excel
Click on `Add-ins` on the right side of the Excel toolbar.
Click on the searchbar and type "Superjoin". The results would show our add-in under the `More search results` section.
Once Superjoin launches as a side panel, just click on `Sign in with Microsoft` and follow the steps to authenticate your Microsoft Office account with Superjoin.
You should now see Superjoin running as a side panel on the right side of your screen.
To begin, you can navigate to `Queries`, choose to `Create new query`.
Navigate to `Sources`, select `Connect to a new source` and search for `Zendesk`.
Click on the `Connect` button and follow the on-screen instructions to link your Zendesk account.
After connecting your account, you'll be prompted to select the objects from the list you want to import data from.
Select the filters that you want to apply to narrow down the data you want to work with.
Select the items that you want to sort your data by.
Enter the limit of rows you want to import into your Excel worksheet.
Click on the "Import" button to bring your selected Zendesk data into Microsoft Excel.
Your data has been imported successfully! You can refresh your data at any time by clicking the refresh button in the Superjoin panel.
##### Hope this guide helped you connect Zendesk to your spreadsheet using Superjoin.
##### If you have any questions or need further assistance, please don't hesitate to reach out to our support team at [support@superjoin.ai](mailto:support@superjoin.ai). Thank you!
# Connect your Zoho CRM to Spreadsheets
Source: https://docs.superjoin.ai/integrations/Zoho/overview
Seamlessly sync data between your Zoho CRM and Google Sheets or Microsoft Excel with just a few steps.
### Why use Superjoin's Google Sheets-Zoho CRM Integration?
We've meticulously organized the data points to ensure easy accessibility in a format you're already familiar
with.
Get a sneak peek of your data. Select columns, apply filters & limits as per
your need before importing.
Enjoy one-click refreshes or schedule regular updates to ensure your sheets
are always up to date.
Benefit from Google Sheets' collaborative data analysis & other powerful
capabilities.
## Step-by-step walkthrough: How to connect Zoho CRM to Google Sheets.
Select `Add-ons` and choose `Get Add-ons`. This action will redirect you to the Google Workspace Marketplace.
In the Google Workspace Marketplace pop-up window, search for "Superjoin".
Click on `Extensions` from the Google Sheets menu.
**Note:** For the best experience, install Superjoin where there's only a single account is logged in the
Chrome profile.
Once installed, navigate back to the `Extensions` menu tab in Google Sheets. Launch Superjoin from here. You
should now see Superjoin running as a side panel on the right side of your screen.
Select Zoho CRM from the list of available data sources.
* Select the `Region` where your Zoho CRM account is hosted.
* Click on the `Authorize` button.
* You will be redirected to the Zoho CRM sign-in page.
* Sign-in to your Zoho CRM account using credentials or other providers.
* Click on the `Accept` button to allow to allow Superjoin to access your Zoho CRM data.
* You will see a success screen once the authorization is successful.
Now select the objects from the list you want to import from.
Select the items that you want to filter. These filters depend on the type of object you have selected. For
example,
| **Object Type** | **Filter Name** |
| ---------------- | --------------- |
| User | Type |
| User Territories | Config |
| Modules | Status |
Optionally, enter the Limit of rows you want to write on Google Sheet, default is 50,000.
Now simply click on the `Import` button to bring this selected data into your Google Sheets.
This will pull the data and then start importing it into your Google Sheet.
Superjoin lets you refresh your imported data instantly with one click or set it to auto-refresh on a pre-set
schedule. This way, you won't need to manually update your Zoho CRM data in Google Sheets to reflect changes
from the source.
Learn more about how to set up auto-refresh schedules here.
### Why use Superjoin's Excel-Zoho CRM Integration?
We've meticulously organized the data points to ensure easy accessibility in a format you're already familiar
with.
Get a sneak peek of your data. Select columns, apply filters & limits as per
your need before importing.
Enjoy one-click refreshes to ensure your sheets are always up to date.
Benefit from Microsoft Excel's powerful data analysis & visualization capabilities.
## Step-by-step walkthrough: How to connect Zoho CRM to Microsoft Excel
Click on `Add-ins` on the right side of the Excel toolbar.
Click on the searchbar and type "Superjoin". The results would show our add-in under the `More search results` section.
Once Superjoin launches as a side panel, just click on `Sign in with Microsoft` and follow the steps to authenticate your Microsoft Office account with Superjoin.
You should now see Superjoin running as a side panel on the right side of your screen.
To begin, you can navigate to `Queries`, choose to `Create new query`.
Navigate to `Sources`, select `Connect to a new source` and search for `Zoho CRM`.
* Select the `Region` where your Zoho CRM account is hosted.
* Click on the `Authorize` button.
* You will be redirected to the Zoho CRM sign-in page.
* Sign-in to your Zoho CRM account using credentials or other providers.
* Click on the `Accept` button to allow Superjoin to access your Zoho CRM data.
* You will see a success screen once the authorization is successful.
After connecting your account, you'll be prompted to select the objects from the list you want to import data from.
Select the items that you want to filter. These filters depend on the type of object you have selected. For example:
| **Object Type** | **Filter Name** |
| ---------------- | --------------- |
| User | Type |
| User Territories | Config |
| Modules | Status |
Optionally, enter the limit of rows you want to import into your Excel worksheet. The default is 50,000.
Click on the "Import" button to bring your selected Zoho CRM data into Microsoft Excel.
This will pull the data and then start importing it into your Excel worksheet.
Your data has been imported successfully! You can refresh your data at any time by clicking the refresh button in the Superjoin panel.
You can set up one-click refreshes to ensure your Excel data stays up-to-date with your Zoho CRM.
##### Hope this guide helped you connect Zoho CRM to your spreadsheet using Superjoin.
##### If you have any questions or need further assistance, please don't hesitate to reach out to our support team at [support@superjoin.ai](mailto:support@superjoin.ai). Thank you!
# Connect your BigQuery to Google Sheets
Source: https://docs.superjoin.ai/integrations/bigquery/overview
Effortlessly connect your BigQuery data to Google Sheets for simplified reporting and analysis.
### Why use Superjoin’s Google Sheets-BigQuery Integration?
We've meticulously organized the data points to ensure easy accessibility in a format you're already familiar with.
Get a sneak peek of your data. Select columns, apply filters & limits as per your need before importing.
Enjoy one-click refreshes or schedule regular updates to ensure your sheets are always up to date.
Benefit from Google Sheets' collaborative data analysis & other powerful capabilities.
## Step-by-step walkthrough: How to connect BigQuery to Google Sheets.
Select `Add-ons` and choose `Get Add-ons`. This action will redirect you to the Google Workspace Marketplace.
In the Google Workspace Marketplace pop-up window, search for "Superjoin".
Click on the `Install` button to install Superjoin.
**Note:** For the best experience, install Superjoin where there's only a single account logged in the Chrome profile.
Once installed, navigate back to the `Extensions` menu tab in Google Sheets. Launch Superjoin from here. You should now see Superjoin running as a side panel on the right side of your screen.
To begin, you can navigate to `Queries` , choose to `Create new query`.
Navigate to `Sources`, select `Connect to a new source` and search for BigQuery.
Enter your `Project ID`, which is the GCP project ID associated with the BigQuery dataset.
Once this is done click on `Authorize` to allow Superjoin to access your BigQuery data.
Choose between three query methods through which you would like to import.
Enter you SQL query and click `Run query` and then you can preview your data.
Once you have previewed the data select `Import` and wait for a few seconds. This action pulls all your data from BigQuery to Google Sheets.
The data from your BigQuery account is now available in Google Sheets. If needed, schedule the data to refresh daily, weekly, or monthly at a particular time.
# How to find API key in Chargebee
Source: https://docs.superjoin.ai/integrations/chargebee/create-key
Step-by-step guide to obtain or generate Chargebee API key
On the left side menu, Go to settings and choose Configure Chargebee
Scroll down in Settings and select `API Keys` under `API Keys and Webhooks`.
Select a read-only key and name the key for eg `superjoin-key`. Click on `Create Key`.
Obtain the site-name from the top right section of your chargebee dashboard. In the screenshot, it is `superjoindxw-test`. It can also be found in your site URL, which is the part of the URL before `.chargebee.com`.
Here's the official Chargebee Documentation to get API keys
# Connect your Chargebee to Spreadsheets
Source: https://docs.superjoin.ai/integrations/chargebee/overview
Effortlessly connect Chargebee to Google Sheets or Microsoft Excel in a few clicks using Superjoin
### Why use Superjoin's Google Sheets-Chargebee Integration?
We've meticulously organized the data points to ensure easy accessibility in a format you're already familiar with.
Get a sneak peek of your data. Select columns, apply filters & limits as per
your need before importing.
Enjoy one-click refreshes or schedule regular updates to ensure your sheets
are always up to date.
Benefit from Google Sheets' collaborative data analysis & other powerful
capabilities.
## Step-by-step walkthrough: How to connect Chargebee to Google Sheets
Head over to `Extensions` , select `Add-ons` and choose `Get Add-ons`. This action will redirect you to the Google Workspace Marketplace.
In the Google Workspace Marketplace pop-up window, search for "Superjoin".
Click on the `Install` button to install Superjoin.
**Note:** For the best experience, install Superjoin where there's only a single account is logged in the Chrome profile.
Once installed, navigate back to the `Extensions` menu tab in Google Sheets. Launch Superjoin from here. You should now see Superjoin running as a side panel on the right side of your screen.
To begin, you can navigate to `Queries` , choose to `Create new query`.
Navigate to `Sources`, select `Connect to a new source` and search for `Chargebee`.
Click on the `Connect` button and follow the on-screen instructions to link your account. Your site name should be the part of the URL before `.chargebee.com`.
Step-by-step guide to obtain or generate Chargebee API key
After connecting your account, a data preview window will appear, allowing you to modify your `Objects` and apply various `Filters` to refine your data. You can also select a `Drilldown` if needed.
Drilldown allows you to fetch more granular data contained within each of the selected object.
Add/modify the data fields you want to import, the `Fields` you selected should start showing up in the data preview section.
After previewing the data, click on `Import` and wait for a few seconds. This action transfers all data from your Chargebee account into Google Sheets.
You can schedule a `Refresh` to automatically update your data daily, weekly, or monthly at a specific time.
### Why use Superjoin's Excel-Chargebee Integration?
We've meticulously organized the data points to ensure easy accessibility in a format you're already familiar
with.
Get a sneak peek of your data. Select columns, apply filters & limits as per
your need before importing.
Enjoy one-click refreshes to ensure your sheets are always up to date.
Benefit from Microsoft Excel's powerful data analysis & visualization capabilities.
## Step-by-step walkthrough: How to connect Chargebee to Microsoft Excel
Click on `Add-ins` on the right side of the Excel toolbar.
Click on the searchbar and type "Superjoin". The results would show our add-in under the `More search results` section.
Once Superjoin launches as a side panel, just click on `Sign in with Microsoft` and follow the steps to authenticate your Microsoft Office account with Superjoin.
You should now see Superjoin running as a side panel on the right side of your screen.
To begin, you can navigate to `Queries`, choose to `Create new query`.
Navigate to `Sources`, select `Connect to a new source` and search for `Chargebee`.
Click on the `Connect` button and follow the on-screen instructions to link your account. Your site name should be the part of the URL before `.chargebee.com`.
Step-by-step guide to obtain or generate Chargebee API key
After connecting your account, a data preview window will appear, allowing you to modify your `Objects` and apply various `Filters` to refine your data. You can also select a `Drilldown` if needed.
Drilldown allows you to fetch more granular data contained within each of the selected object.
Add/modify the data fields you want to import, the `Fields` you selected should start showing up in the data preview section.
After previewing the data, click on `Import` and wait for a few seconds. This action transfers all data from your Chargebee account into Microsoft Excel.
Your data has been imported successfully! You can refresh your data at any time by clicking the refresh button in the Superjoin panel.
##### Hope this guide helped you connect Chargebee to your spreadsheet using Superjoin.
##### If you have any questions or need further assistance, please don't hesitate to reach out to our support team at [support@superjoin.ai](mailto:support@superjoin.ai). Thank you!
# How to Connect any API to your Spreadsheet
Source: https://docs.superjoin.ai/integrations/customapi/overview
Easily integrate data from any API directly into Google Sheets or Microsoft Excel with a simple setup process.
In today's data-driven environment, businesses require swift, reliable access to data from diverse sources to drive decision-making and operational efficiency. Recognizing this need, Superjoin is thrilled to introduce Custom API, a flexible connector that integrates any API with your preferred spreadsheet environment.
## Step-by-step walkthrough: How to connect APIs to Google Sheets
Click on `Extensions` and select `Add-ons` and choose `Get Add-ons`. This action will redirect you to the Google Workspace Marketplace.
In the Google Workspace Marketplace pop-up window, search for `Superjoin`.
Click on the `Install` button to install Superjoin.
**Note:** For the best experience, install Superjoin where there's only a single account logged in the Chrome profile.
Once installed, navigate back to the `Extensions` menu tab in Google Sheets. Launch Superjoin from here. You should now see Superjoin running as a side panel on the right side of your screen.
To begin, you can navigate to `Queries` , choose to `Create new query`.
Navigate to `Sources`, select `Connect to a new source` and search for `Custom API`.
Authorization in API interactions ensures that only authorized users can access specific functions or data. It acts as a gatekeeper, verifying credentials before allowing access to API resources.
Superjoin's CustomAPI supports three distinct types of authorization to cater to different access needs:
| Auth type | Description |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| No Authorization | Ideal for public APIs where no sensitive data is involved. Access is granted without requiring any credentials, simplifying the connection process. |
| Basic Authorization | Utilizes a username and password to grant access. These credentials are encoded and included in the request header, providing a straightforward method to authenticate users. |
| Beaer Authorization | Involves a token included in the request header that represents the user’s access permissions. This token is verified by the API server to grant access, offering a token-based approach to handle user sessions and requests. |
| OAuth2.0 Authorization | Employs an authorization framework that allows third-party applications to access a user's resources without exposing their credentials. Requires a client ID, client secret, scopes, access token URL, and refresh token URL. Users authenticate with the API provider, which then grants the application an access token. This token is used in subsequent requests to access resources on behalf of the user, ensuring secure and delegated access |
Based on the selected authorization type, you'll be further prompted to enter details.
The request method determines how data is sent or requested from a server, playing a pivotal role in the interaction with various web services. Superjoin supports two primary HTTP request methods:
| Method | Description |
| ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| GET | Used primarily for retrieving data. This method requests data from a specified resource, and does not usually requires a `body`, unless specified in the API's configuration. Most common method for fetching data. |
| POST | Also used for retrieving data, but when you need to pass on some details along with the request in the form of a `body`. |
Specifies the address of your server, basically where your API requests are sent.
You can also add in query parameters in your URL such as: [https://api.example.com?itemId=20](https://api.example.com?itemId=20)
Headers play a crucial role in conveying additional information about the request or the response between the client and the server. Some APIs might require or support additional headers that control or modify the operation of the request.
In Superjoin's CustomAPI, headers are formatted as key-value pairs that can be easily added to your API requests.
In the above image we have added a header with key as `API_KEY` and value as `1kjvwda321wuro`.
You cannot add a new header without filling both key and value fields for the previous header.
The "body" of a request is crucial when using POST methods, as it contains the data you send to the server. For effective data exchange and customization in API requests through Superjoin's CustomAPI, understanding how to format and use the body is key.
Superjoin supports two flexible ways to add content to the body of your API requests, accommodating various API specifications and user preferences:
| Supported types | Description |
| --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| JSON Editor | This tool allows you to directly input or modify JSON formatted data. The editor provides a clear, structured way to view and edit JSON, ensuring that the data is both valid and precisely structured as the API expects. |
| Key value pairs | For simpler or flatter data structures, adding body content as key-value pairs is straightforward and intuitive. This approach is user-friendly, especially for those who may not be as familiar with JSON syntax. |
Click "Connect” to establish the connection with the API. Superjoin will open the Data Preview upon successful creation, allowing you to preview your data.
## Step-by-step walkthrough: How to connect APIs to Microsoft Excel
Click on `Add-ins` on the right side of the Excel toolbar.
Click on the searchbar and type "Superjoin". The results would show our add-in under the `More search results` section.
Once Superjoin launches as a side panel, just click on `Sign in with Microsoft` and follow the steps to authenticate your Microsoft Office account with Superjoin.
You should now see Superjoin running as a side panel on the right side of your screen.
To begin, you can navigate to `Queries`, choose to `Create new query`.
Navigate to `Sources`, select `Connect to a new source` and search for `Custom API`.
Authorization in API interactions ensures that only authorized users can access specific functions or data. It acts as a gatekeeper, verifying credentials before allowing access to API resources.
Superjoin's CustomAPI supports three distinct types of authorization to cater to different access needs:
| Auth type | Description |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| No Authorization | Ideal for public APIs where no sensitive data is involved. Access is granted without requiring any credentials, simplifying the connection process. |
| Basic Authorization | Utilizes a username and password to grant access. These credentials are encoded and included in the request header, providing a straightforward method to authenticate users. |
| Beaer Authorization | Involves a token included in the request header that represents the user’s access permissions. This token is verified by the API server to grant access, offering a token-based approach to handle user sessions and requests. |
| OAuth2.0 Authorization | Employs an authorization framework that allows third-party applications to access a user's resources without exposing their credentials. Requires a client ID, client secret, scopes, access token URL, and refresh token URL. Users authenticate with the API provider, which then grants the application an access token. This token is used in subsequent requests to access resources on behalf of the user, ensuring secure and delegated access |
Based on the selected authorization type, you'll be further prompted to enter details.
The request method determines how data is sent or requested from a server, playing a pivotal role in the interaction with various web services. Superjoin supports two primary HTTP request methods:
| Method | Description |
| ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| GET | Used primarily for retrieving data. This method requests data from a specified resource, and does not usually requires a `body`, unless specified in the API's configuration. Most common method for fetching data. |
| POST | Also used for retrieving data, but when you need to pass on some details along with the request in the form of a `body`. |
Specifies the address of your server, basically where your API requests are sent.
You can also add in query parameters in your URL such as: [https://api.example.com?itemId=20](https://api.example.com?itemId=20)
Headers play a crucial role in conveying additional information about the request or the response between the client and the server. Some APIs might require or support additional headers that control or modify the operation of the request.
In Superjoin's CustomAPI, headers are formatted as key-value pairs that can be easily added to your API requests.
In the above image we have added a header with key as `API_KEY` and value as `1kjvwda321wuro`.
You cannot add a new header without filling both key and value fields for the previous header.
The "body" of a request is crucial when using POST methods, as it contains the data you send to the server. For effective data exchange and customization in API requests through Superjoin's CustomAPI, understanding how to format and use the body is key.
Superjoin supports two flexible ways to add content to the body of your API requests, accommodating various API specifications and user preferences:
| Supported types | Description |
| --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| JSON Editor | This tool allows you to directly input or modify JSON formatted data. The editor provides a clear, structured way to view and edit JSON, ensuring that the data is both valid and precisely structured as the API expects. |
| Key value pairs | For simpler or flatter data structures, adding body content as key-value pairs is straightforward and intuitive. This approach is user-friendly, especially for those who may not be as familiar with JSON syntax. |
Click "Connect” to establish the connection with the API. Superjoin will open the Data Preview upon successful creation, allowing you to preview your data.
## Setup Pagination
Head over to the Pagination page to get a detailed explanation on it.
# Setup Pagination
Source: https://docs.superjoin.ai/integrations/customapi/pagination
How to Setup Pagination Inside Custom API Connector of Superjoin
Pagination is an essential feature in API integration, allowing you to handle large datasets by breaking them into smaller, more manageable parts. This approach ensures efficient data processing and prevents overloading both the API and your application with excessive data at once.
In Superjoin's Custom API, we support three types of pagination: **offset-based pagination, cursor-based pagination, and page-based pagination.** These methods enable incremental data retrieval without loading everything at once and can be configured under the `data preview` section.
## Configuring Offset Based Pagination
When setting up offset-based pagination in Superjoin’s Custom API, you’ll encounter a few specific fields that help define how data is fetched in segmented ways.
Here’s a simplified explanation of each field to help you understand and configure pagination efficiently, even if you’re not deeply familiar with API mechanics:
| Field | Required | Description |
| ----------------------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| Offset should be set through | yes | Choose where the offset value will be included in your API request. You can insert it in the query parameters, headers, or body of the request. |
| Offset should be set as the property name | yes | Define the exact parameter name that will carry the offset in your API request, such as offset, start, or skip. |
## Configuring Page Based Pagination
Page-based pagination is a straightforward approach, perfect for scenarios where users need to access specific pages directly. This method divides data into pages, making navigation intuitive and user-friendly.
Here’s a simplified explanation of each field to help you understand and configure pagination efficiently, even if you’re not deeply familiar with API mechanics:
| Field | Required | Description |
| --------------------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| Page number should be set through | yes | Choose where the page number will be included in your API request. It can be placed in the query parameters, headers, or body of the request. |
| Page number should be set with the name | yes | Define the exact parameter name that will carry the page number in your API request, such as page or page\_number. |
| Starting page number | yes | Specify the starting page number for pagination, typically set to 0 or 1, depending on your system's requirements. |
## Configuring Cursor Based Pagination
Page-based pagination is a straightforward approach, perfect for scenarios where users need to access specific pages directly. This method divides data into pages, making navigation intuitive and user-friendly.
Here’s how to configure page-based pagination with the relevant fields:
| Field | Required | Description |
| -------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| Path | yes | Define the JSON path in the API response where the cursor is located, such as data.nextCursor. |
| Property | yes | Specify the name of the field that will hold the cursor value in your API request, typically labeled as cursor or a similar identifier. |
| Injection Into | yes | Choose where to inject the cursor value in the API request. Options include placing it in the query parameters, headers, or body of the request. |
### Understanding Path Levels:
**Nested Level**: Used when data is organized within multiple layers in the JSON response.
For example:
```
{
"data": {
"pagination": {
"next_cursor": ""
}
}
}
```
**Root Level**: Used when data is directly accessible at the top level of the JSON response.
For example:
```
{
"next_cursor": ""
}
```
# Connect your Meta Ads to Spreadsheets
Source: https://docs.superjoin.ai/integrations/facebook/overview
Effortlessly connect your Meta Ads account to Google Sheets or Microsoft Excel for unified reporting and analysis.
### Why use Superjoin's Google Sheets-Meta Ads Integration?
We've meticulously organized the data points to ensure easy accessibility in a format you're already familiar with.
Get a sneak peek of your data. Select columns, apply filters & limits as per your need before importing.
Enjoy one-click refreshes or schedule regular updates to ensure your sheets are always up to date.
Benefit from Google Sheets' collaborative data analysis & other powerful capabilities.
## Step-by-step walkthrough: How to connect Facebook Ads to Google Sheets
Head over to `Extensions`, select `Add-ons` and choose `Get Add-ons`. This action will redirect you to the Google Workspace Marketplace.
In the Google Workspace Marketplace pop-up window, search for "Superjoin".
Click on the `Install` button to install Superjoin.
**Note:** For the best experience, install Superjoin where there's only a single account logged in the Chrome profile.
Once installed, navigate back to the `Extensions` menu tab in Google Sheets. Launch Superjoin from here. You should now see Superjoin running as a side panel on the right side of your screen.
To begin, you can navigate to `Queries`, choose to `Create new query`.
Navigate to `Sources`, select `Connect to a new source` and search for `Facebook Ads`.
Click on the `Connect` button and follow the on-screen instructions to link your account.
Enter your Facebook credentials to log in and access your Facebook Ads data.
After connecting your account, a data preview window will appear, allowing you to modify your `Objects` and apply various `Filters` to refine your data. You can also select a `Breakdown` and a `Time Interval` as per your need.
Time Intervals allow you to pull your data in a `Day-on-Day`, `Week-on-Week` and a `Month-on-Month` fashion.
Add/modify the data fields you want to import. The `Fields` you selected should start showing up in the data preview section.
After previewing the data, click on `Import` and wait for a few seconds. This action transfers all data from your Facebook Ads account into Google Sheets.
You can schedule a `Refresh` to automatically update your data daily, weekly, or monthly at a specific time.
### Why use Superjoin's Excel-Facebook Ads Integration?
We've meticulously organized the data points to ensure easy accessibility in a format you're already familiar
with.
Get a sneak peek of your data. Select columns, apply filters & limits as per
your need before importing.
Enjoy one-click refreshes to ensure your sheets are always up to date.
Benefit from Microsoft Excel's powerful data analysis & visualization capabilities.
## Step-by-step walkthrough: How to connect Facebook Ads to Microsoft Excel
Click on `Add-ins` on the right side of the Excel toolbar.
Click on the searchbar and type "Superjoin". The results would show our add-in under the `More search results` section.
Once Superjoin launches as a side panel, just click on `Sign in with Microsoft` and follow the steps to authenticate your Microsoft Office account with Superjoin.
You should now see Superjoin running as a side panel on the right side of your screen.
To begin, you can navigate to `Queries`, choose to `Create new query`.
Navigate to `Sources`, select `Connect to a new source` and search for `Facebook Ads`.
Click on the `Connect` button and follow the on-screen instructions to link your Facebook Ads account.
Enter your Facebook credentials to log in and access your Facebook Ads data.
After connecting your account, a data preview window will appear, allowing you to select your `Objects`, apply `Filters`, and choose specific `Breakdowns` to refine your Facebook Ads data.
Add/modify the data fields you want to import. The `Fields` you selected should start showing up in the data preview section.
Once you've configured your data selection, click the "Import" button to bring your Facebook Ads data into Microsoft Excel.
Your data has been imported successfully! You can refresh your data at any time by clicking the refresh button in the Superjoin panel.
##### Hope this guide helped you connect Facebook Ads to your spreadsheet using Superjoin.
##### If you have any questions or need further assistance, please don't hesitate to reach out to our support team [support@superjoin.ai](mailto:support@superjoin.ai). Thank you!
# Connect your Google Search Console to Spreadsheets
Source: https://docs.superjoin.ai/integrations/googlesearchconsole/overview
Effortlessly connect your Google Search Console account to Google Sheets or Microsoft Excel for simplified reporting and analysis.
### Why use Superjoin's Google Sheets-Google Search Console Integration?
We've meticulously organized the data points to ensure easy accessibility in a format you're already familiar with.
Get a sneak peek of your data. Select columns, apply filters & limits as per your need before importing.
Enjoy one-click refreshes or schedule regular updates to ensure your sheets are always up to date.
Benefit from Google Sheets' collaborative data analysis & other powerful capabilities.
## Step-by-step walkthrough: How to connect Google Search Console to Google Sheets
Head over to `Extensions` , select `Add-ons` and choose `Get Add-ons`. This action will redirect you to the Google Workspace Marketplace.
In the Google Workspace Marketplace pop-up window, search for "Superjoin".
Click on the `Install` button to install Superjoin.
**Note:** For the best experience, install Superjoin where there's only a single account logged in the Chrome profile.
Once installed, navigate back to the `Extensions` menu tab in Google Sheets. Launch Superjoin from here. You should now see Superjoin running as a side panel on the right side of your screen.
To begin, you can navigate to `Queries` , choose to `Create new query`.
Navigate to `Sources`, select `Connect to a new source` and search for `Google Search Console`.
Click on the `Connect` button and follow the on-screen instructions to link your account.
After connecting your account, a data preview window will appear, allowing you to modify your metrics and apply various filters to refine your data.
After previewing the data, click on `Import` and wait for a few seconds. This action transfers all data from your Google Search Console account into Google Sheets.
You can schedule a `Refresh` to automatically update your data daily, weekly, or monthly at a specific time.
### Why use Superjoin's Excel-Google Search Console Integration?
We've meticulously organized the data points to ensure easy accessibility in a format you're already familiar
with.
Get a sneak peek of your data. Select columns, apply filters & limits as per
your need before importing.
Enjoy one-click refreshes to ensure your sheets are always up to date.
Benefit from Microsoft Excel's powerful data analysis & visualization capabilities.
## Step-by-step walkthrough: How to connect Google Search Console to Microsoft Excel
Click on `Add-ins` on the right side of the Excel toolbar.
Click on the searchbar and type "Superjoin". The results would show our add-in under the `More search results` section.
Once Superjoin launches as a side panel, just click on `Sign in with Microsoft` and follow the steps to authenticate your Microsoft Office account with Superjoin.
You should now see Superjoin running as a side panel on the right side of your screen.
To begin, you can navigate to `Queries`, choose to `Create new query`.
Navigate to `Sources`, select `Connect to a new source` and search for `Google Search Console`.
Click on the `Connect` button and follow the on-screen instructions to link your Google Search Console account.
After connecting your account, a data preview window will appear, allowing you to select your metrics and dimensions, apply date ranges, and set various filters to refine your Search Console data.
Once you've configured your data selection, click the "Import" button to bring your Google Search Console data into Microsoft Excel.
Your data has been imported successfully! You can refresh your data at any time by clicking the refresh button in the Superjoin panel.
##### Hope this guide helped you connect Google Search Console to your spreadsheet using Superjoin.
##### If you have any questions or need further assistance, please don't hesitate to reach out to our support team [support@superjoin.ai](mailto:support@superjoin.ai). Thank you!
# Frequently faced issues during HubSpot Connect
Source: https://docs.superjoin.ai/integrations/hubspot/common-issues
We have listed down some common issues that our customers usually face while trying to authenticate using Superjoin.
If you are have trouble accessing the "Leads" Object from the Sales Hub, navigate to #2 (next FAQ). Continue reading for all other objects.
## Solution
If you believe that you have the right permissions on your user account to access these Objects, go ahead and click on Re-authenticate with HubSpot.
#### Follow the next steps if you encounter the same error.
Only a person with Super Admin access (on HubSpot) can give another user the right permissions.
On a new web browser tab, navigate to your HubSpot account. Make sure to select the same account that you are using in Superjoin. From the topbar (top right), navigate to Settings.
Under Settings (**Account Management**), select Users & Teams from the left section.
From the users listed under team, click on **Edit permissions** for the user you are granting permission for.
Navigate to Sheet where Superjoin is loaded.
Perform the authentication process again and select the right HubSpot account. You will now be able to access that object.
If you are still facing the same issue, reach out to [support@superjoin.ai](mailto:support@superjoin.ai) and we will help you.
## Solution
The Leads object in Superjoin is only available in the Sales Hub Professional and Sales Hub Enterprise plan of HubSpot.
If you are on one of these paid plans, you can follow the instructions above (#1 FAQ) to obtain the permissions.
Not sure what to do next? Reach out to us at [support@superjoin.ai](mailto:support@superjoin.ai). We will respond immediately.
## Solutions
On a new web browser tab, navigate to your HubSpot account. Make sure to select the same account that you are using in Superjoin. From the topbar (top right), navigate to Settings.
Under Settings (**Account Management**), select Users & Teams from the left section.
From the users listed under team, click on **Edit permissions** for the user you are granting permission for.
Under Account -> Settings Access, enable App Marketplace access and save it.
Navigate to Sheet where Superjoin is loaded.
Perform the authentication process again and select the right HubSpot account. You will now be able to access the most basic objects.
If you are still facing the same issue, reach out to [support@superjoin.ai](mailto:support@superjoin.ai) and we will help you.
# Delete Connected HubSpot Account
Source: https://docs.superjoin.ai/integrations/hubspot/delete-connection
Step by Step guide to delete your HubSpot account from Superjoin
Please note that deleting a HubSpot connection from Superjoin is permanent. You may not be able to recover it again.
Launch Superjoin and Navigate to 'Sources' from the bottom navigation pane.
Click on the 3-dot menu of the HubSpot account you wish to delete. Click on Delete and confirm it.
When you delete a connection on Superjoin, all associated imports/exports will also be deleted & the associated import schedules will be
stopped. Your imported sheets however will not be impacted due to a deletion of an object.
# Delete Superjoin from Connected HubSpot Account
Source: https://docs.superjoin.ai/integrations/hubspot/delete-superjoin
Step by Step guide to remove the installed Superjoin app from your HubSpot account
Login to your HubSpot account and navigate to settings (Gear icon on top right section)
Under settings, go to Integrations and select Connected Apps.
Select 'Google Sheets Connector' and click on Actions. From the menu, select 'Uninstall'.
That's it. You have successfully uninstalled Superjoin from your HubSpot account.
Although we're sad to see you go, we assure you that your HubSpot account is no more accessible with Superjoin. If you wish Superjoin to remove all your account related meta data, reach out to [support@superjoin.ai](mailto:support@superjoin.ai) and we will assist you.
# What's your Export goal?
Source: https://docs.superjoin.ai/integrations/hubspot/export
Based on the usecase you're trying to achieve with Superjoin Exports, choose one of the options below
### Insert new data into your HubSpot
Available only on Google Sheets
### Make changes to existing HubSpot data
Available only on Google Sheets
### Insert new data into your HubSpot and make changes to existing HubSpot data at the same time
Available only on Google Sheets
### Associate data from one HubSpot object to another
Available only on Google Sheets
### Dissociate data of one HubSpot object from another
Available only on Google Sheets
### Delete data from your HubSpot
Available only on Google Sheets
# Understanding HubSpot User Level Permissions
Source: https://docs.superjoin.ai/integrations/hubspot/hubspot-permissions
This section will talk about how to give a HubSpot user access to specfic Objects
If you follow the upcoming guide, you will get access to the below objects. Do note that unless you modify the settings, you will only see items that you own. For Eg. You will only see "Contacts" that are assigned to you:
Contacts,
Companies,
Deals,
Deal Splits,
Goals,
Leads,
Custom Objects,
Line Items,
Carts,
Discounts,
Fees,
Orders,
Subscriptions,
Taxes,
Calls,
Emails,
Meetings,
Notes,
Tasks,
Communications,
Postal Mail
If you believe that you have the right permissions on your user account to access these Objects, go ahead and click on Re-authenticate with HubSpot.
#### Follow the next steps if you encounter the same error.
Only a person with Super Admin access (on HubSpot) can give another user the right permissions.
On a new web browser tab, navigate to your HubSpot account. Make sure to select the same account that you are using in Superjoin. From the topbar (top right), navigate to Settings.
Under Settings (**Account Management**), select Users & Teams from the left section.
From the users listed under team, click on **Edit permissions** for the user you are granting permission for.
Under Account -> Settings Access, enable App Marketplace access and save it.
Navigate to Google Sheet where Superjoin is loaded.
Perform the authentication process again and select the right HubSpot account. You will now be able to access the most basic objects.
If you are still facing the same issue, reach out to [support@superjoin.ai](mailto:support@superjoin.ai) and we will help you.
Under Individual User Settings, turn on the following permission.
Under Individual User Settings, turn on the following permission.
Under Individual User Settings, turn on the following permission.
Under Individual User Settings, turn on the following permission.
Under Individual User Settings, turn on the following permission – "Edit properties" & "Manage Product Library".
Under Individual User Settings, turn on the following permission.
This section will be updated soon!
# How to import data from HubSpot to Spreadsheets
Source: https://docs.superjoin.ai/integrations/hubspot/import
Step-by-step guide to import data from HubSpot to Google Sheets or Microsoft Excel
After connecting your account, a data preview window will appear, allowing you to modify your `Objects` and apply various `Filters` to refine your data.
You can also select `Associations` as per your need. Associations allow you to relationally join data from multiple HubSpot objects together.
Add/modify the data fields you want to import. The `Fields` you selected should start showing up in the data preview section.
After previewing the data, click on `Import` and wait for a few seconds. This action transfers all data from your HubSpot account into Google Sheets.
You can schedule a `Refresh` to automatically update your data hourly, daily, weekly, or monthly at a specific time.
##### If you want to export changes you made in the imported data back into HubSpot, head over to the `Export Data` tab or click on the box below.
Step-by-step guide to export data from Google Sheets to HubSpot
##### Hope this guide helped you import your data from HubSpot to Google Sheets using Superjoin.
##### If you have any questions or need further assistance, please don’t hesitate to reach out to our support team. Thank you!
After connecting your account, a data preview window will appear, allowing you to modify your `Objects` and apply various `Filters` to refine your data.
You can also select `Associations` as per your need. Associations allow you to relationally join data from multiple HubSpot objects together.
Add/modify the data fields you want to import. The `Fields` you selected should start showing up in the data preview section.
After previewing the data, click on `Import` and wait for a few seconds. This action transfers all data from your HubSpot account into Google Sheets.
The desired data has been successfully written on to your Excel sheet. Now whenever you want fresh data, just click on the `Pull Latest Data` button.
##### Hope this guide helped you import your data from HubSpot to Microsoft Excel using Superjoin.
##### If you have any questions or need further assistance, please don’t hesitate to reach out to our support team. Thank you!
# HubSpot Data Connector for Spreadsheets
Source: https://docs.superjoin.ai/integrations/hubspot/overview
Welcome to the HubSpot Data Connector's Support Documentation page.
Still can't find answers here? Email us at [support@superjoin.ai](mailto:support@superjoin.ai) and we will help you asap!
### Getting Started
Connect your HubSpot account to start importing or exporting data.
Address issues that you might face while connecting your HubSpot a/c.
Step-by-step guide to import data from HubSpot to Google Sheets
Step-by-step guide to export data from Google Sheets to HubSpot
This is the explanation of HubSpot terms used in Superjoin
### HubSpot Objects & Permissions
A list of supported HubSpot Objects for Import and Export.
Understand and obtain the right permissions on different Objects of HubSpot.
### Data Management
Steps to delete/erase your HubSpot account from Superjoin
Steps to remove the installed Superjoin app from your HubSpot account
# Connect your HubSpot account to Spreadsheets
Source: https://docs.superjoin.ai/integrations/hubspot/quickstart
Effortlessly connect HubSpot to Google Sheets or Microsoft Excel to export and import data using Superjoin's 2-way sync feature in a few clicks.
We've meticulously organized the data points to ensure easy accessibility in a format you're already familiar
with.
Get a sneak peek of your data. Select columns, apply filters & limits as per
your need before importing.
Enjoy one-click refreshes or schedule regular updates to ensure your sheets
are always up to date.
Benefit from Google Sheets' collaborative data analysis & other powerful
capabilities.
## Step-by-step walkthrough: How to connect HubSpot to Google Sheets
Head over to `Extensions`, select `Add-ons` and choose `Get Add-ons`. This action will redirect you to the
Google Workspace Marketplace.
In the Google Workspace Marketplace pop-up window, search for "Superjoin".
Click on the `Install` button to install Superjoin.
**Note:** For the best experience, install Superjoin where there's only a single account logged in the
Chrome profile.
Once installed, navigate back to the `Extensions` menu tab in Google Sheets. Launch Superjoin from here. You
should now see Superjoin running as a side panel on the right side of your screen.
To begin, you can navigate to `Queries`, choose to `Create new query`.
Navigate to `Sources`, select `Connect to a new source` and search for `HubSpot`.
Click on the `Connect` button and follow the on-screen instructions to link your account.
In case of multiple HubSpot accounts, choose the one you want to import the data from.
After connecting your account, a data preview window will appear, allowing you to modify your `Objects` and
apply various `Filters` to refine your data. You can also select a `Association` if needed.
Associations allow you to relationally join data from multiple HubSpot objects together.
Based on whether you want to import data from your HubSpot account or export data from Google sheets into your
HubSpot account , pick one of the options below that will guide you further.
Step-by-step guide to import data from HubSpot to Google Sheets
Step-by-step guide to export data from Google Sheets to HubSpot
We've meticulously organized the data points to ensure easy accessibility in a format you're already familiar
with.
Get a sneak peek of your data. Select columns, apply filters & limits as per
your need before importing.
Enjoy one-click refreshes to ensure your sheets are always up to date.
Benefit from Microsoft Excel's collaborative data analysis & other powerful capabilities.
## Step-by-step walkthrough: How to connect HubSpot to Microsoft Excel
Click on `Add-ins` on the right side of the Excel toolbar.
Click on the searchbar and type "Superjoin". The results would show our add-in under the `More search results` section.
Once Superjoin launches as a side panel, just click on `Sign in with Microsoft` and follow the steps to authenticate your Microsoft Office account with Superjoin.
You should now see Superjoin running as a side panel on the right side of your screen.
To begin, you can navigate to `Queries`, choose to `Create new query`.
Navigate to `Sources`, select `Connect to a new source` and search for `HubSpot`.
Click on the `Connect` button and follow the on-screen instructions to link your account.
In case of multiple HubSpot accounts, choose the one you want to import the data from.
After connecting your account, a data preview window will appear, allowing you to modify your `Objects` and
apply various `Filters` to refine your data. You can also select a `Association` if needed.
Associations allow you to relationally join data from multiple HubSpot objects together.
Click on the card below for detailed instructions on how import your data from HubSpot to Microsoft Excel.
Step-by-step guide to import data from HubSpot to Microsoft Excel
Coming soon!
# Supported HubSpot Objects
Source: https://docs.superjoin.ai/integrations/hubspot/supported-objects
HubSpot Objects supported for Importing or Exporting Data using Superjoin
| Section | Object | Description |
| -------------------------------------- | -------------- | -------------------------------------------------- |
| **Core CRM Objects** | Contacts | Individual people you're engaging with |
| | Companies | Organizations you're working with |
| | Deals | Sales opportunities |
| | Leads | Potential sales prospects |
| | Custom Objects | Tailored objects specific to the customer’s needs |
| | Tickets | Support and customer service requests |
| **Sales & Revenue Objects** | Deals | Sales opportunities |
| | Deal Splits | Splits of deals between multiple people |
| | Line Items | Products or services associated with deals |
| | Carts | Shopping carts for e-commerce scenarios |
| | Orders | Completed purchases |
| | Payments | Monetary transactions |
| | Quotes | Formal offers for services or products |
| | Products | Items or services you sell |
| | Discounts | Price reductions applied to deals or orders |
| | Fees | Additional costs added to sales |
| | Invoices | Billing records for customers |
| | Subscriptions | Recurring payment agreements |
| | Taxes | Applicable taxes on orders or payments |
| **Engagement & Communication Objects** | Calls | Phone communications |
| | Emails | Email communications |
| | Meetings | Scheduled meetings with customers |
| | Notes | Internal notes related to any objects |
| | Tasks | To-do items related to CRM actions |
| | Communications | General interactions with customers |
| | Postal Mail | Physical mail correspondence |
| **Marketing & Lists** | Contact Lists | Segmented lists of contacts for marketing purposes |
| | Goals | Targets and KPIs for sales/marketing teams |
| **Operational & Reporting Objects** | Payments | Transaction records for customer purchases |
| | Quotes | Documents offering potential deals |
| | Invoices | Records for payment requests |
| | Subscriptions | Ongoing services customers are billed for |
| Section | Object | Description |
| --------------------------- | ---------- | ------------------------------------------ |
| **Core CRM Objects** | Contacts | Individual people you're engaging with |
| | Companies | Organizations you're working with |
| | Leads | Potential sales prospects |
| | Tickets | Support and customer service requests |
| **Sales & Revenue Objects** | Deals | Sales opportunities |
| | Products | Items or services you sell |
| | Quotes | Formal offers for services or products |
| | Line Items | Products or services associated with deals |
| **Marketing & Lists** | Goals | Targets and KPIs for sales/marketing teams |
# Connect your Microsoft SQL to Google Sheets
Source: https://docs.superjoin.ai/integrations/microsoftsql/overview
Effortlessly connect your Microsoft SQL data to Google Sheets for reporting and analysis.
### Why use Superjoin’s Google Sheets-Microsoft SQL Integration?
We've meticulously organized the data points to ensure easy accessibility in a format you're already familiar with.
Get a sneak peek of your data. Select columns, apply filters & limits as per your need before importing.
Enjoy one-click refreshes or schedule regular updates to ensure your sheets are always up to date.
Benefit from Google Sheets' collaborative data analysis & other powerful capabilities.
## Step-by-step walkthrough: How to connect Microsoft SQL to Google Sheets
Select `Add-ons` and choose `Get Add-ons`. This action will redirect you to the Google Workspace Marketplace.
In the Google Workspace Marketplace pop-up window, search for "Superjoin".
Click on the `Install` button to install Superjoin.
**Note:** For the best experience, install Superjoin where there's only a single account logged in the Chrome profile.
Once installed, navigate back to the `Extensions` menu tab in Google Sheets. Launch Superjoin from here. You should now see Superjoin running as a side panel on the right side of your screen.
To begin, you can navigate to `Queries` , choose to `Create new query`.
Navigate to `Sources`, select `Connect to a new source` and search for Microsoft SQL Server.
Enter your `Host Name/IP Address`, `Port number` (which is usually 3306), `Database Name` , `Username` ( Make sure to create a new user with read-only access to your database) and `Password`.
Once this is done click on `Authorize` to allow Superjoin to access your Microsoft SQL Server data.
Once this is done click on `Authorize` to allow Superjoin to access your Microsoft SQL Server data.
Choose between three query methods through which you would like to import.
Enter you SQL query and click `Run query` and then you can preview your data.
Once you have previewed the data select `Import` and wait for a few seconds. This action pulls all your data from Microsoft SQL to Google Sheets.
You can schedule a `Refresh` to automatically update your data daily, weekly, or monthly at a specific time.
# How to Acquire MongoDB Credentials?
Source: https://docs.superjoin.ai/integrations/mongodb/credentials
Proceed with the outlined steps to acquire MongoDB credentials.
## Step-by-step walkthrough: How to obtain MongoDB credentials
From the dashboard, click on `Database Access` under `Security`
Click on the `+ ADD NEW DATABASE USER` button.
On the `Add new Database User` modal dialog, choose `Password` for the `Authentication Method`.
In the `Password Authentication` section, set the username to READ\_ONLY\_USER in the first text box and set a password in the second text box.
Under `Database User Privileges`, click on `Select one built-in role for this user` under `Built-in Role` and choose `Only read any database`.
Enable `Restrict Access to Specific Clusters/Federated Database instances` and enable only those clusters/database that you wish to replicate.
Click on `Add User` at the bottom to save the user.
## Setting up MongoDB
Head over to the MongoDB page to get a step by step guide to connect.
# Connect your MongoDB to Google Sheets
Source: https://docs.superjoin.ai/integrations/mongodb/overview
Seamlessly sync data between your MongoDB database and Google Sheets with just a few steps.
Please note that the MongoDB integration is in beta at the moment. If you face any issues, please reach out to us at
[support@superjoin.ai](mailto:support@superjoin.ai) and we will help you asap!
### Why use Superjoin’s Google Sheets-MongoDB Integration?
We've meticulously organized the data points to ensure easy accessibility in a format you're already familiar with.
Get a sneak peek of your data. Select columns, apply filters & limits as per your need before importing.
Enjoy one-click refreshes or schedule regular updates to ensure your sheets are always up to date.
Benefit from Google Sheets' collaborative data analysis & other powerful capabilities.
## Step-by-step walkthrough: How to connect MongoDB to Google Sheets.
Select `Add-ons` and choose `Get Add-ons`. This action will redirect you to the Google Workspace Marketplace.
In the Google Workspace Marketplace pop-up window, search for "Superjoin".
Click on `Extensions` from the Google Sheets menu.
**Note:** For the best experience, install Superjoin where there's only a single account is logged in the Chrome profile.
Once installed, navigate back to the `Extensions` menu tab in Google Sheets. Launch Superjoin from here. You should now see Superjoin running as a side panel on the right side of your screen.
Select MongoDB from the list of available data sources.
Connect your MongoDB account. Go through all the directions and prompts to connect your MongoDB account to Google Sheets.
Now select the objects from the list you want to import from.
Select the filters that you want to apply in order to filter down the data that you want to work on.
Select the items that you want to sort.
Now simply Enter the Limit of rows you want to write on Google Sheet.
Now simply click on the "import" button to bring this selected data into your Google Sheets.
Superjoin lets you refresh your imported data instantly with one click or set it to auto-refresh on a pre-set schedule. This way, you won’t need to manually update your MongoDB data in Google Sheets to reflect changes from the source.
# How to Whitelist an IP Address in MySQL Server?
Source: https://docs.superjoin.ai/integrations/mysql/ip-whitelisting
A guide to whitelist Superjoin's IP address in your MySQL server to connect MySQL to Google Sheets using Superjoin.
Superjoin’s IP Addresses are 3.6.225.10, 13.205.69.7 and 13.204.201.25. Whitelist all three of these IP Addresses in your database and allow TCP/IP connection from this IP in your
firewall.
## What is "Whitelisting"?
Think of your database like a private party. The "whitelist" is your guest list. Only the IP addresses (unique identifiers for computers on the internet) on this list can "enter the party," i.e., connect to your database. IPs not on the list will receive the metaphorical "you're not on the list" and cannot connect.
## Step by Step Guide to IP Whitelisting in your MySQL DB
If you're not hands-on with database management, contacting your IT admin is the best approach
Share Superjoin's IP addresses (3.6.225.10, 13.205.69.7, 13.204.201.25) with your admin.Ask them to whitelist this IP for your database access.Once whitelisted, connect your database in your Superjoin account to confirm everything is set up correctly.If you've tried the above steps and still facing issues, don't hesitate to contact us at [support@superjoin.ai](mailto:support@superjoin.ai). We will respond immediately.
If you're ready to handle this yourself, here’s how you can whitelist IP addresses for MySQL.
## Solution
Use SSH to access your server where MySQL is hosted.Open the configuration file (`/etc/mysql/my.cnf` or similar) using a text editor.Locate the `bind-address` directive and change its value to `0.0.0.0` to allow connections from any IP (be cautious with this setting).Ensure `skip-networking=0` is set under `[mysqld]`. Save and exit.Use `sudo service mysql restart` to apply changes
Log into MySQL with `mysql -u root -p`. & Run the Command `GRANT ALL PRIVILEGES ON your_database_name.* TO 'your_username'@'our_ip_address' IDENTIFIED BY 'your_password'; FLUSH PRIVILEGES;`
Replace placeholders with your actual database name, username, and password. You must run this once for each of our three IP addresses - 3.6.225.10, 13.205.69.7 and 13.204.201.25If you've tried the above steps and still facing issues, don't hesitate to contact us at [support@superjoin.ai](mailto:support@superjoin.ai). We will respond immediately.Go to the SQL section and select your instance.Edit settings and under Authorized Networks, add Superjoin's IP Adresses (3.6.225.10, 13.205.69.7, 13.204.201.25). Save your changes.If you've tried the above steps and still facing issues, don't hesitate to contact us at [support@superjoin.ai](mailto:support@superjoin.ai). We will respond immediately.
## AWS Whitelisting
Head over to the IP Whitelisting in AWS page to get a step by step troubleshooting guide.
Whitelisting an IP for your MySQL, Amazon Redshift, or PostgreSQL database doesn't just bolster security—it ensures that only authorized
locations can access your data. Whether you choose to manage this process yourself or coordinate with IT professionals, ensuring your
database's security is crucial. Remember, if you're ever unsure, consulting with an expert is always a wise decision. Happy data managing!
# Connect your MySQL Database to Google Sheets
Source: https://docs.superjoin.ai/integrations/mysql/overview
Move your MySQL data to Google Sheets with ease! This guide connects them in just a few clicks - no coding needed.
Superjoin has revolutionized the way organizations connect to MySQL databases, offering secure and efficient connection solutions. This guide will walk you through setting up a connection with Superjoin, ensuring you can leverage the full capabilities of Superjoin with your MySQL database. 🚀
## Step-by-step walkthrough: How to connect MySQL to Google Sheets
Once Superjoin is installed, navigate to the `Extensions` menu tab in Google Sheets. Launch Superjoin from here. You should now see Superjoin running as a side panel on the right side of your screen.
Select MySQL from the list of available data sources.
Enter your connection credentials.
Avoid using local IP address (127.0.0.1) or private IP addresses like 192.168.1.100 (192.168.X.X). A private IP address for a server is like a private address of your device in a home or office network which can only be accessed from within the network and not from outside.
Typically, you can find these details in the configuration files of the application that interacts with your database, such as a config.php, .env, or other server-side configuration files. Alternatively, you may access these details from your database management system like phpMyAdmin or directly through MySQL command line using the status command.
| Field | Description | Example |
| -------- | ----------------------------------------------------------------------- | ---------------------- |
| Host | Enter the path to your database, which could be a URL or an IP address. | mydatabase.example.com |
| Port | Use the specific port for your MySQL database. | Default is 3306 |
| Database | Specify the name of the database you want to query. | mydatabase |
| User | Enter the username for connecting to your MySQL database. | admin or user123 |
| Password | Provide the password corresponding to the specified user. | password123 |
## Setting up Amazon RDS
Head over to the AWS RDS page to get a step by step guide to connect or troubleshoot connectivity.
# How to Troubleshoot your MySQL Connection?
Source: https://docs.superjoin.ai/integrations/mysql/troubleshooting
A comprehensive guide to diagnosing and resolving common MySQL connection issues with Superjoin.
Encountering connection issues with MySQL databases can be frustrating. This section provides a detailed explanation and resolution steps for common error messages.
Error Message: Unable to connect to the database, Please make sure that your database is running and that you have whitelisted all three of our IP addresses (3.6.225.10, 13.205.69.7, 13.204.201.25).
### Action Steps
Ensure your MySQL server is running by trying to connect via a tool like MySQL Workbench or through the command line.Whitelist the IP addresses (3.6.225.10, 13.205.69.7, 13.204.201.25) in your MySQL settings, which might involve modifying firewall settings or MySQL user privileges. If you've tried the above steps and still facing issues, don't hesitate to contact us at [support@superjoin.ai](mailto:support@superjoin.ai). We will respond immediately.
Error Message: Unable to connect to the database, Please ensure the database credentials are correct.
### Action Steps
Verify that the username and password in your connection settings match the credentials in your MySQL server.If necessary, reset the password for the user in MySQL and update it in your connection settings.Alternatively, it's best to create a new username/password. Create user like this `CREATE USER 'sammy'@'*' IDENTIFIED BY 'password';` and grant permission to databases like this `GRANT PRIVILEGE ON database.table TO 'username'@'host';` If you've tried the above steps and still facing issues, don't hesitate to contact us at [support@superjoin.ai](mailto:support@superjoin.ai). We will respond immediately.
Error Message: Unable to connect to the database, Please make sure that the database exists.
Ensure that the database name in your connection settings matches an actual database in your MySQL server. Here's the command: `SHOW DATABASES;` If the database does not exist, create it using a tool like MySQL Workbench or by executing a CREATE DATABASE SQL command.If you've tried the above steps and still facing issues, don't hesitate to contact us at [support@superjoin.ai](mailto:support@superjoin.ai). We will respond immediately.
Error Message: Unable to connect to the database, Please make sure that your database is running and that you have whitelisted all three of our IP address (3.6.225.10, 13.205.69.7, 13.204.201.25).
### Action Steps
Check if the MySQL server is operational and not experiencing downtime.Whitelist the IP addresses (3.6.225.10, 13.205.69.7, 13.204.201.25) in your MySQL settings, which might involve modifying firewall settings or MySQL user privileges.If you've tried the above steps and still facing issues, don't hesitate to contact us at [support@superjoin.ai](mailto:support@superjoin.ai). We will respond immediately.
## Summarising all the errors that you could face while connecting to your MySQL DB
# Creating PayPal API Credentials
Source: https://docs.superjoin.ai/integrations/paypal/create-key
Step-by-step guide to create a PayPal developer application and obtain API credentials for Superjoin integration
## Creating API Credentials in PayPal Developer Portal
To connect Superjoin with your PayPal account, you'll need to create an application in the PayPal Developer Portal to obtain the necessary API credentials (Client ID and Secret). Follow these steps to set up your PayPal application:
Visit the [PayPal Developer Dashboard](https://developer.paypal.com/dashboard/) and sign in with your PayPal Business account.
You need a PayPal Business account to access the developer dashboard. If you don't have one yet, you'll need to create one first.
Once logged in, click on the **Apps & Credentials** option in the dashboard menu.
Under the "REST API apps" section, click on the **Create App** button.
Fill in the required details for your app:
1. **App Name**: Enter a descriptive name (e.g., "Superjoin Integration")
2. **App Type**: Select "Merchant"
3. **Business Account**: Make sure your business account is selected
Then click **Create App**.
After creating the app, you'll be taken to the app details page that displays your Client ID and Secret.
Your Client Secret will only be shown once. Make sure to copy it immediately or click "Show" to reveal it. If you lose it, you'll need to generate a new one.
In the app details page, scroll down to the "Sandbox App Settings" and "Live App Settings" sections.
Make sure the following permissions are enabled:
* **Transaction Search**: Needed to retrieve transaction data
* **Payment Information**: Required for payment details
* **Invoicing**: If you want to import invoice data
Click on **Save** when you've selected all necessary permissions.
By default, your app is created in Sandbox (testing) mode. To use it with your real PayPal account:
1. Switch from "Sandbox" to "Live" using the toggle at the top of the page
2. Follow the same steps to create a live app
3. Copy the live Client ID and Secret
Make sure you're using the live credentials when connecting to Superjoin if you want to access your actual PayPal transaction data.
Now you can return to Superjoin and use the Client ID and Secret to connect your PayPal account:
1. Enter the Client ID
2. Enter the Client Secret
3. Click "Connect" to complete the authentication
Store your credentials securely. Never share your Client Secret with anyone.
## Troubleshooting
If you encounter any issues when creating your API credentials or connecting to Superjoin:
* Make sure you've enabled all required permissions for your app
* Verify you're using the correct credentials (Sandbox vs. Live)
* Check that your PayPal account is in good standing
* Ensure you're using a PayPal Business account, not a personal account
For additional help, contact PayPal Developer Support or reach out to our team at [support@superjoin.ai](mailto:support@superjoin.ai).
##### If you have any questions or need further assistance with setting up your PayPal API credentials, please don't hesitate to reach out to our support team at [support@superjoin.ai](mailto:support@superjoin.ai). Thank you!
# Connect your PayPal to Google Sheets
Source: https://docs.superjoin.ai/integrations/paypal/overview
Effortlessly connect PayPal to Google Sheets in a few clicks using Superjoin
### Why use Superjoin's Google Sheets-PayPal Integration?
We've meticulously organized the data points to ensure easy accessibility in a format you're already familiar with.
Get a sneak peek of your data. Select columns, apply filters & limits as per
your need before importing.
Enjoy one-click refreshes or schedule regular updates to ensure your sheets
are always up to date.
Benefit from Google Sheets' collaborative data analysis & other powerful
capabilities.
## Step-by-step walkthrough: How to connect PayPal to Google Sheets
Head over to `Extensions` , select `Add-ons` and choose `Get Add-ons`. This action will redirect you to the Google Workspace Marketplace.
In the Google Workspace Marketplace pop-up window, search for "Superjoin".
Click on the `Install` button to install Superjoin.
**Note:** For the best experience, install Superjoin where there's only a single account is logged in the Chrome profile.
Once installed, navigate back to the `Extensions` menu tab in Google Sheets. Launch Superjoin from here. You should now see Superjoin running as a side panel on the right side of your screen.
To begin, you can navigate to `Queries` , choose to `Create new query`.
Navigate to `Sources`, select `Connect to a new source` and search for `PayPal`.
Add Client Id and Client Secret, then Click on the `Connect` button and follow the on-screen instructions to link your PayPal account.
Step-by-step guide to obtain or generate PayPal API credentials
After connecting your account, a data preview window will appear, allowing you to modify your `Objects` (like Transactions, Payments, Invoices, etc.) and apply various `Filters` to refine your data.
Select the date range for which you want to import the transaction or payment data.
Add/modify the data fields you want to import. You can select specific transaction details like Date, Amount, Description, Status, and more. The `Fields` you selected should start showing up in the data preview section.
You can filter your PayPal data based on:
* Transaction types (sales, refunds, transfers)
* Date range
* Payment status
* Amount range
* Currency
You can sort your data by date, amount, or other fields, and set a row limit to control how many transactions are imported.
After previewing the data, click on `Import` and wait for a few seconds. This action transfers all selected PayPal transaction data into your Google Sheets.
You can schedule a `Refresh` to automatically update your data daily, weekly, or monthly at a specific time. This is particularly useful for keeping your PayPal transaction data up-to-date for regular financial reporting.
##### Hope this guide helped you connect PayPal to Google Sheets using Superjoin.
##### If you have any questions or need further assistance, please don't hesitate to reach out to our support team at [support@superjoin.ai](mailto:support@superjoin.ai). Thank you!
# New User in PostgreSQL
Source: https://docs.superjoin.ai/integrations/postgres/create-new-user
Let's create a new user for PostgreSQL with read-only permission
To create a user in PostgreSQL and give them read-only permissions to a specific database, you can follow these steps.
This process involves using SQL commands within your PostgreSQL environment
You can do this by using a terminal or an SQL client, connecting with a user that has sufficient privileges to create other users and manage permissions, such as the `postgres` superuser.
```sql sql theme={null}
psql -U postgres
```
Use the `CREATE ROLE` or `CREATE USER` command to create a new user. `CREATE USER` is effectively the same as `CREATE ROLE` but with the LOGIN ability enabled by default.
```sql sql theme={null}
CREATE USER readonly_user WITH PASSWORD 'secure_password';
```
Replace readonly\_user with your desired username and secure\_password with a strong password.
You need to grant the new user permission to connect to the specific database.
```sql sql theme={null}
GRANT CONNECT ON DATABASE target_database TO readonly_user;
```
Replace target\_database with the name of the database to which you want to grant access.
Typically, you'd want the user to read data from specific schemas (commonly the public schema).
```sql sql theme={null}
GRANT USAGE ON SCHEMA public TO readonly_user;
```
Finally, grant the SELECT permission on all tables and views within the schema. To automatically apply this to new tables as well, you can set up default privileges.
```sql sql theme={null}
GRANT SELECT ON ALL TABLES IN SCHEMA public TO readonly_user;
ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT SELECT ON TABLES TO readonly_user;
```
This gives the `readonly_user` the ability to read data from all existing and future tables in the `public` schema of `target_database`.
After you're done, you can exit the PostgreSQL command line by typing.
```sql sql theme={null}
\q
```
# How to Whitelist an IP Address in PostgreSQL Server?
Source: https://docs.superjoin.ai/integrations/postgres/ip-whitelisting
A guide to whitelist Superjoin's IP address in your PostgreSQL server for access.
Superjoin’s IP Addresses are (3.6.225.10, 13.205.69.7 and 13.204.201.25). Whitelist all three IP Addresses in your database and allow TCP/IP connection from this IP in your
firewall.
## What is "Whitelisting"?
Think of your database like a private party. The "whitelist" is your guest list. Only the IP addresses (unique identifiers for computers on the internet) on this list can "enter the party," i.e., connect to your database. IPs not on the list will receive the metaphorical "you're not on the list" and cannot connect.
## Step by Step Guide to IP Whitelisting in your PostgreSQL DB
If you're not hands-on with database management, contacting your IT admin is the best approach
Share Superjoin's IP addresses (3.6.225.10, 13.205.69.7, 13.204.201.25) with your admin.Ask them to whitelist this IP for your database access.Once whitelisted, connect your database in your Superjoin account to confirm everything is set up correctly.If you've tried the above steps and still facing issues, don't hesitate to contact us at [support@superjoin.ai](mailto:support@superjoin.ai). We will respond immediately.
If you're ready to handle this yourself, here’s how you can whitelist IP addresses for PostgreSQL.
## Solution
Use SSH to access your server where PostgreSQL is hosted.Open the file located under `/etc/postgresql/[version]/main/`. For each IP (3.6.225.10, 13.205.69.7 and 13.204.201.25), add a line `host all all /32 md5`. Save and close.Open the file located under `/etc/postgresql/[version]/main/`. Locate the line where listen\_addresses is mentioned and add our ip address in it in the following manner - the resultant should look like `listen_addresses = '3.6.225.10,13.205.69.7,13.204.201.25'``sudo service postgresql restart` ensures your settings take effect.If you've tried the above steps and still facing issues, don't hesitate to contact us at [support@superjoin.ai](mailto:support@superjoin.ai). We will respond immediately.Go to the SQL section and select your instance.Edit settings and under Authorized Networks, add Superjoin's IP addresses 3.6.225.10, 13.205.69.7 and 13.204.201.25. Save your changes.If you've tried the above steps and still facing issues, don't hesitate to contact us at [support@superjoin.ai](mailto:support@superjoin.ai). We will respond immediately.
## AWS Whitelisting
Head over to the IP Whitelisting in AWS page to get a step by step troubleshooting guide.
Whitelisting an IP for your PostgreSQL database doesn't just bolster security—it ensures that only authorized locations can access your
data. Whether you choose to manage this process yourself or coordinate with IT professionals, ensuring your database's security is
crucial. Remember, if you're ever unsure, consulting with an expert is always a wise decision. Happy data managing!
# Connect your PostgreSQL Database to Google Sheets
Source: https://docs.superjoin.ai/integrations/postgres/overview
Connect PostgreSQL to Google Sheets in just a few clicks for easy data analysis directly in your spreadsheets.
superjoin has revolutionized the way organizations connect to PostgreSQL databases, offering secure and efficient connection solutions. This guide will walk you through setting up a connection with superjoin, ensuring you can leverage the full capabilities of superjoin with your PostgreSQL database. 🚀
## Step-by-step walkthrough: How to connect PostgreSQL to Google Sheets
Once Superjoin is installed, navigate to the `Extensions` menu tab in Google Sheets. Launch Superjoin from here. You should now see Superjoin running as a side panel on the right side of your screen.
Select PostgreSQL from the list of available data sources.
Enter your connection credentials.
Avoid using local IP address (127.0.0.1) or private IP addresses like 192.168.1.100 (192.168.X.X). A private IP address for a server is like a private address of your device in a home or office network which can only be accessed from within the network and not from outside.
Typically, you can find these details in the configuration files of the application that interacts with your database, such as a config.php, .env, or other server-side configuration files. Alternatively, you may access these details from your database management system like phpMyAdmin or directly through PostgreSQL command line using the status command.
| Field | Description | Example |
| -------- | ----------------------------------------------------------------------- | ---------------------- |
| Host | Enter the path to your database, which could be a URL or an IP address. | mydatabase.example.com |
| Port | Use the specific port for your PostgreSQL database. | Default is 5432 |
| Database | Specify the name of the database you want to query. | mydatabase |
| User | Enter the username for connecting to your PostgreSQL database. | admin or user123 |
| Password | Provide the password corresponding to the specified user. | password123 |
## Setting up Amazon RDS
Head over to the AWS RDS page to get a step by step guide to connect or troubleshoot connectivity.
# How to Troubleshoot your PostgreSQL Connection?
Source: https://docs.superjoin.ai/integrations/postgres/troubleshooting
A comprehensive guide to diagnosing and resolving common PostgreSQL connection issues while connecting PostgreSQL and Google Sheets using Superjoin.
Error Message: Please make sure that your database is running and you have whitelisted all three of our IP address (3.6.225.10, 13.205.69.7, 13.204.201.25)
### Action Steps
Check Database Server: Ensure that your PostgreSQL server is actively running.Modify your PostgreSQL settings to include the IP addresses (3.6.225.10, 13.205.69.7, 13.204.201.25) in the whitelist, which may involve adjusting the pg\_hba.conf file or firewall settings. More information on whitelisting hereIf you've tried the above steps and still facing issues, don't hesitate to contact us at [support@superjoin.ai](mailto:support@superjoin.ai). We will respond immediately.
Error Message: Unable to connect to the database, please make sure that your database URL is correct.
### Action Steps
Double-check the database URL in your connection settings to ensure it is correct and properly formatted.If you've tried the above steps and still facing issues, don't hesitate to contact us at [support@superjoin.ai](mailto:support@superjoin.ai). We will respond immediately.
Error Message: Incorrect database credentials. Please verify the username and password.
### Action Steps
Make sure that the username and password in your connection settings are accurate and correspond to what is configured on your PostgreSQL server.
If necessary, reset the password for the user in PostgreSQL and update it in your connection settings.
Learn how to create a new user in PostgreSQL to provide appropriate read only access.
If you've tried the above steps and still facing issues, don't hesitate to contact us at [support@superjoin.ai](mailto:support@superjoin.ai). We will respond immediately.
Error Message: Database does not exist. Please verify the database name.
Confirm that the database name in your connection settings matches an existing database on your PostgreSQL server. This common issue occurs when the database name is misspelled or the database was not created. Here's the command: `\l`If you've tried the above steps and still facing issues, don't hesitate to contact us at [support@superjoin.ai](mailto:support@superjoin.ai). We will respond immediately.
Error Message: Connection attempt timed out. Please try again later.
### Action Steps
Check if the PostgreSQL server is operational and not undergoing maintenance or downtime which could impede connections. Ensure that the IP addresses (3.6.225.10, 13.205.69.7, 13.204.201.25) is added to the whitelist in your PostgreSQL settings, which may include modifying the pg\_hba.conf file or adjusting firewall settings to allow the connection.If you've tried the above steps and still facing issues, don't hesitate to contact us at [support@superjoin.ai](mailto:support@superjoin.ai). We will respond immediately.
Error Message: Connection timeout exceeded. Please verify the host and port details.
### Action Steps
Double-check that the host and port information in your connection settings are correct and that the PostgreSQL server is actively listening on that host and port. Check to see if any firewall configurations are blocking the connection to the specified port. Confirm that the IP addresses (3.6.225.10, 13.205.69.7, 13.204.201.25) is whitelisted within your PostgreSQL settings, possibly requiring changes to the pg\_hba.conf file or firewall configurations.If you've tried the above steps and still facing issues, don't hesitate to contact us at [support@superjoin.ai](mailto:support@superjoin.ai). We will respond immediately.
Error Message: Maximum connection limit reached. Please try again later
### Action Steps
Review the current connections to your PostgreSQL server and close any that are unused or stale to free up space for new connections. Consider adjusting the max\_connections setting in your postgresql.conf file to increase the number of allowable concurrent connections, ensuring your server is equipped to handle the additional load.If you've tried the above steps and still facing issues, don't hesitate to contact us at [support@superjoin.ai](mailto:support@superjoin.ai). We will respond immediately.
Error Message: Unable to connect to the database. Please make sure that you have whitelisted all three of our IP address (3.6.225.10, 13.205.69.7, 13.204.201.25)
### Action Steps
Double-check your PostgreSQL configurations to ensure all three of our IP addresses (3.6.225.10, 13.205.69.7, 13.204.201.25) are properly whitelisted. This may require adjustments in the pg\_hba.conf file or firewall settings to allow the connection. More on this hereIf you've tried the above steps and still facing issues, don't hesitate to contact us at [support@superjoin.ai](mailto:support@superjoin.ai). We will respond immediately.
Error Message: An unknown error occurred while connecting to the database
### Action Steps
Examine the PostgreSQL server logs for any clues or additional details regarding the error.If you've tried the above steps and still facing issues, don't hesitate to contact us at [support@superjoin.ai](mailto:support@superjoin.ai). We will respond immediately.
Error Message: Unable to connect to the database. Please make sure that your database URL is correct
### Action Steps
Double-check the host entered in your connection settings to ensure it matches the server where your PostgreSQL database resides.If you've tried the above steps and still facing issues, don't hesitate to contact us at [support@superjoin.ai](mailto:support@superjoin.ai). We will respond immediately.
## Summarising all the errors that you could face while connecting to your PostgreSQL DB
# How to Whitelist an IP Address in AWS RDS Server?
Source: https://docs.superjoin.ai/integrations/rds/ip-whitelisting
A guide to whitelist Superjoin's IP address in your AWS RDS server to connect AWS RDS to Google Sheets using Superjoin.
Superjoin’s IP Addresses are (3.6.225.10, 13.205.69.7, 13.204.201.25). Whitelist this IP Address in your database and allow TCP/IP connection from this IP in your
firewall.
If you're not hands-on with database management, contacting your IT admin is the best approach
Share Superjoin's IP addresses (3.6.225.10, 13.205.69.7, 13.204.201.25) with your admin.Ask them to whitelist this IP for your database access.Once whitelisted, connect your database in your Superjoin account to confirm everything is set up correctly.If you've tried the above steps and still facing issues, don't hesitate to contact us at [support@superjoin.ai](mailto:support@superjoin.ai). We will respond immediately.
If you're ready to handle this yourself, here’s how you can whitelist IP addresses for MySQL.
## Solutions
Log in to the AWS Management Console.
Navigate to DB Instances and select your instance.
Choose the security group and edit the inbound rules. Add a new rule for the IP addresses `3.6.225.10`, `13.205.69.7`,`13.204.201.25` and save.
If you've tried the above steps and still facing issues, don't hesitate to contact us at [support@superjoin.ai](mailto:support@superjoin.ai). We will respond immediately.
# Connect your AWS RDS Database to Google Sheets
Source: https://docs.superjoin.ai/integrations/rds/overview
Quickly link your AWS RDS database to Google Sheets for hassle-free data integration and visualization.
Superjoin has revolutionized the way organizations connect to RDS databases, offering secure and efficient connection solutions. This guide will walk you through setting up a connection with Superjoin, ensuring you can leverage the full capabilities of Superjoin with your MySQL database. 🚀
## Step-by-step walkthrough: How to connect RDS to Google Sheets
Once Superjoin is installed, navigate to the `Extensions` menu tab in Google Sheets. Launch Superjoin from here. You should now see Superjoin running as a side panel on the right side of your screen.
Select MySQL (for RDS as well) from the list of available data sources.
Enter your connection credentials.
| Field | Description | Example |
| -------- | --------------------------------------------------------- | --------------------------------------------------------- |
| Host | This will be the endpoint of your RDS instance. | your-db-instance.123456789012.us-east-1.rds.amazonaws.com |
| Port | Use the specific port for your MySQL database. | Default is 3306 |
| Database | Specify the name of the database you want to query. | initialdatabase |
| User | Enter the username for connecting to your MySQL database. | admin or user123 |
| Password | Provide the password corresponding to the specified user. | password123 |
For using AWS RDS (Relational Database Service), you will typically gather the same types of credentials. However, the process may include some AWS-specific steps.
If you're connecting to a PostgreSQL RDS instance which is running
PostgreSQL version 15 or higher, you must enable the enforce SSL toggle beflow the
password field.
Log in to the AWS Management Console.
Navigate to the RDS dashboard and select your database instance.
Under the 'Connectivity & Security' section, find the 'Endpoint' and 'Port' information.
Click "Authorize" to establish the connection. Superjoin will open the Data Preview upon successful creation, allowing you to start querying your database.
# Troubleshooting
Source: https://docs.superjoin.ai/integrations/rds/troubleshooting
Display inline code and code blocks
## Basic
### Inline Code
To denote a `word` or `phrase` as code, enclose it in backticks (\`).
```
To denote a `word` or `phrase` as code, enclose it in backticks (`).
```
### Code Block
Use [fenced code blocks](https://www.markdownguide.org/extended-syntax/#fenced-code-blocks) by enclosing code in three backticks and follow the leading ticks with the programming language of your snippet to get syntax highlighting. Optionally, you can also write the name of your code after the programming language.
```java HelloWorld.java theme={null}
class HelloWorld {
public static void main(String[] args) {
System.out.println("Hello, World!");
}
}
```
````md theme={null}
```java HelloWorld.java
class HelloWorld {
public static void main(String[] args) {
System.out.println("Hello, World!");
}
}
```
````
# How to Whitelist an IP Address in RedShift Server?
Source: https://docs.superjoin.ai/integrations/redshift/ip-whitelisting
A guide to whitelist Superjoin's IP address in your RedShift server to connect RedShift to Google Sheets using Superjoin.
Superjoin’s IP Addresses are (3.6.225.10, 13.205.69.7, 13.204.201.25). Whitelist these IP Addresses in your database and allow TCP/IP connection from this IP in your
firewall.
If you're not hands-on with database management, contacting your IT admin is the best approach
Share Superjoin's IP addresses (3.6.225.10, 13.205.69.7, 13.204.201.25) with your admin.Ask them to whitelist all three IP Addresses for your database access.Once whitelisted, connect your database in your Superjoin account to confirm everything is set up correctly.If you've tried the above steps and still facing issues, don't hesitate to contact us at [support@superjoin.ai](mailto:support@superjoin.ai). We will respond immediately.
If you're ready to handle this yourself, here’s how you can whitelist IP addresses for MySQL.
## Solutions
Log in to the AWS Management Console.
Navigate to DB Instances and select your instance.
Choose the security group and edit the inbound rules. Add new rules for the IP Adresses `3.6.225.10`, `13.205.69.7`, `13.204.201.25` and save.
If you've tried the above steps and still facing issues, don't hesitate to contact us at [support@superjoin.ai](mailto:support@superjoin.ai). We will respond immediately.
# Connect your Redshift Database to Google Sheets
Source: https://docs.superjoin.ai/integrations/redshift/overview
Easily connect your Amazon Redshift database to Google Sheets for streamlined data access and analysis.
Connecting your applications to a database can seem daunting, but with Superjoin, linking to an Amazon Redshift database is streamlined and secure. This detailed guide will walk you through the process step-by-step, troubleshoot common issues, and ensure your connections are as robust as they can be. Let’s dive in!
## Step-by-step walkthrough: How to connect Redshift to Google Sheets
Once Superjoin is installed, navigate to the `Extensions` menu tab in Google Sheets. Launch Superjoin from here. You should now see Superjoin running as a side panel on the right side of your screen.
Select Redshift from the list of available data sources.
Enter your connection details.
| Field | Description | Example |
| -------- | ---------------------------------------------------------------------------------------------- | --------------------------------------------------------------- |
| Host | This is the endpoint of your Redshift cluster, which acts as the host for connection purposes. | your-cluster-name.123456789012.us-west-2.redshift.amazonaws.com |
| Port | Use the specific port for your Redshift database. | Default is 5439 |
| Database | Specify the name of the database within your Redshift cluster that you want to query. | mydatabase |
| User | Enter the username for connecting to your Redshift database. | awsuser |
| Password | Provide the password corresponding to the specified user. | password123 |
Log into the AWS Management Console and navigate to the Redshift dashboard.
Select your workspace to view its details.In the Workspace Configuration tab, you can find the Endpoint and Port information.
Implementing SSL for your database connections is a critical step toward securing your data. By following the specific steps you can protect your database from unauthorized access and ensure that your data remains confidential and intact during transmission.
If your database has a secure connection enabled (SSL), make sure to also enable it on Superjoin when connecting.
Return to your Google Sheet & Superjoin. Click "Authorize" to finalize the connection settings. Once connected, Superjoin will display the Data Preview to confirm everything is running smoothly.
# Troubleshooting
Source: https://docs.superjoin.ai/integrations/redshift/troubleshooting
Let's get your Redshift Connection up and running
Stay tuned. We'll be launching it in the Chrome Webstore!
# Frequently faced issues during Salesforce Connect
Source: https://docs.superjoin.ai/integrations/salesforce/common-issues
## Solution
If you believe that you have the right permissions on your user account to access report, you can verify the access to the report on the Salesforce Dashboard.
#### Follow the next steps if you encounter the same error.
On a new web browser tab, navigate to your Salesforce account. Make sure to select the same account that you are using in Superjoin. Navigate to **Reports** Tab.
Locate the report you want to access and click on it.
If you are not sure which report to access, you can try the following:
* Switch to `All Reports` sections
* Check the report name and description
* Contact your Salesforce administrator for help
Click on the report you were trying to access. In case you get an error, you will have to contact your Salesforce administrator for help.
If you are still facing the same issue, reach out to [support@superjoin.ai](mailto:support@superjoin.ai) and we will help you.
## Solution
You can refer to the summary of the error message in the error box to understand what the potential issue is.
You can click `Show More` in the error box to get more details about the error.
* **Invalid SOQL Query**: Your query syntax is incorrect. Check:
* Query structure
* Field names
* Object references
* Aggregations
* Filter conditions
* **Invalid Field Name**: The field doesn't exist in the object. Verify:
* Field spelling
* Field availability
* API name vs. label
* **Invalid Aggregation**: Your aggregation is incorrect. Ensure:
* Proper aggregation syntax
* Correct field types
* Valid object relationships
* **Invalid Filter Condition**: Your WHERE clause has issues. Check:
* Operator usage
* Value formatting
* Date formats
* Null handling
Not sure what to do next? Reach out to us at [support@superjoin.ai](mailto:support@superjoin.ai). We will respond immediately.
Your org might have policies that prevent opening of Reports - the most frequent one is **Multi-Factor Authentication**.
## Solution
Disable Multi-Factor Authentication in your Salesforce account and then try again after sometime.
Confirm with your Salesforce administrator about the specific policies preventing report access.
If you are still facing the same issue, reach out to [support@superjoin.ai](mailto:support@superjoin.ai) and we will help you.
Your org might have policies that prevent export of Reports. The Profile that your user account is associated with might not have the necessary permissions to export reports.
## Solution
Discuss export limitations with your Salesforce administrator.
Enabling export permission may be done only by a Salesforce administrator.
On a new web browser tab, navigate to your Salesforce account. Navigate to **Setup** Tab found on the top-right corner.
Navigate the the **Users** page. You may use the search bar on the left side of the page to find the Users page.
The option is found under **Users** in the left navigation menu. (Users > Users)
Note the **Profile** of the user account you are using in Superjoin. You may click the Profile name to navigate to the Profile page.
Here you will modify the settings for the Profile to allow export of reports.
Click on **Edit** button to modify the settings for the Profile. and then scroll down to General User Permissions section.
Here enable the **Export Reports** option.
Once done, head to the top of the page and click on **Save**. The changes should take effect shortly.
In case you are not able to enable the **Export Reports** option, the profile may be a **Standard Profile**. In that case, you will have to clone the profile and make sure **Custom Profile** is enabled.
After that make sure to assign this profile to the same user account you are using in Superjoin.
After following all the steps, you are ready to export the report. Head over to Superjoin and try again.
If you are still facing the same issue, reach out to [support@superjoin.ai](mailto:support@superjoin.ai) and we will help you.
Salesforce currently imposes limitations that prevent exporting the row-level details of joined reports. While you can export joined reports in a formatted view, detailed data exports (e.g., CSV format) are not supported . We anticipate that as Salesforce continues to enhance its reporting capabilities, full export functionality for joined reports may become available in future platform updates.
How to Identify a Joined Report:
Joined reports are created by combining multiple report types or objects into distinct blocks within a single report. To determine if a report is a joined report:
Open the report in Salesforce.
Check the report format indicated above the report name; it will display "Joined Report" if applicable.
# Delete Connected Salesforce Account
Source: https://docs.superjoin.ai/integrations/salesforce/delete-connection
Step by Step guide to delete your Salesforce account from Superjoin
Please note that deleting a Salesforce connection from Superjoin is permanent. You may not be able to recover it again.
Launch Superjoin and Navigate to 'Sources' from the bottom navigation pane.
Click on the 3-dot menu of the Salesforce account you wish to delete. Click on Delete and confirm it.
When you delete a connection on Superjoin, all associated imports/exports will also be deleted & the associated import schedules will be
stopped. Your imported sheets however will not be impacted due to a deletion of an object.
# Delete Superjoin from Connected Salesforce Account
Source: https://docs.superjoin.ai/integrations/salesforce/delete-superjoin
Step by Step guide to remove the installed Superjoin app from your Salesforce account
Click on your Avatar on the top right and click on `Settings`.
Under settings, go to `Connections` under the `My Personal Information` section.
Search for the `Superjoin` app and click on `Revoke`.
That's it. You have successfully uninstalled Superjoin from your Salesforce account.
Although we're sad to see you go, we assure you that your Salesforce account is no more accessible with Superjoin. If you wish Superjoin to remove all your account related meta data, reach out to [support@superjoin.ai](mailto:support@superjoin.ai) and we will assist you.
# How to export data from your Spreadsheet to Salesforce
Source: https://docs.superjoin.ai/integrations/salesforce/export
Step-by-step guide to export data from Google Sheets or Microsoft Excel to Salesforce
In the Superjoin side panel, click on `Sources`, navigate through `Your Sources` and click on the Salesforce source you want to export the data to.
A pop-up will come up at the bottom of the side panel. Click on `Export to Salesforce`.
Choose the sheet with the data that you want to export to Salesforce and the row with the header cells of the sheet that you want to export.
Choose the Salesforce `Object` you want to export data to from the dropdown and the action you want to perform during the export:
* if you want to insert new data click on `Insert`
* if you want to update existing data, click on `Update`
* if you want to delete records in Salesforce, click on `Delete`
Map the Google Sheets data fields to the Salesforce Data fields to ensure accuracy. Click on `Save` and the click on `Export`.
IDs are mandatory if you want to perform the `UPDATE` action.
You can choose to export specific rows or entire sheet. If you want to export specific rows, further select the rows you want to export.
Verify the data and the rows the data will be transferred to. Click on `Update`, this action exports all data from your Google Sheets into Salesforce account.
This completes the process of using Superjoin to connect a Salesforce account to Google Sheets and export data back to Salesforce.
##### Hope this guide helped you export your data from Salesforce to Google Sheets using Superjoin.
##### If you have any questions or need further assistance, please don’t hesitate to reach out to our support team. Thank you!
#### Coming Soon!
# How to import data from Salesforce Objects to Spreadsheets
Source: https://docs.superjoin.ai/integrations/salesforce/import-object
Step-by-step guide to import data from Salesforce Objects to Google Sheets or Microsoft Excel
After connecting your account, a data preview window will appear, allowing you to modify and select an `Object` to import and apply various `Filters` to refine your data.
Add/modify the data fields you want to import. The `Fields` you selected should start showing up in the data preview section. You may need to click `Refresh Preview` to see the changes.
After previewing the data, you are ready to start the import. Click on `Import` to start the import process. Here, you can name the new sheet where the data will be imported.
Once you are ready to import, click on `Save and Import` and wait for a few seconds. This action transfers selected data from your Salesforce account into Google Sheets.
You can schedule a `Refresh` to automatically update your data hourly, daily, weekly, or monthly at a specific time.
##### If you want to export changes you made in the imported data back into Salesforce, head over to the `Export Data` tab or click on the box below.
Step-by-step guide to export data from Google Sheets to Salesforce
##### Hope this guide helped you import your data from Salesforce to Google Sheets using Superjoin.
##### If you have any questions or need further assistance, please don’t hesitate to reach out to our support team. Thank you!
After connecting your account, a data preview window will appear, allowing you to modify and select an `Object` and apply various `Filters` to refine your data.
Add/modify the data fields you want to import. The `Fields` you selected should start showing up in the data preview section. You may need to click `Refresh Preview` to see the changes.
After previewing the data, click on `Import` and wait for a few seconds. This action transfers all data from your Salesforce account into Microsoft Excel.
The desired data has been successfully written on to your Excel sheet. Now whenever you want fresh data, just click on the `Pull Latest Data` button.
##### Hope this guide helped you import your data from HubSpot to Microsoft Excel using Superjoin.
##### If you have any questions or need further assistance, please don’t hesitate to reach out to our support team. Thank you!
# How to import data from Salesforce Reports to Spreadsheets
Source: https://docs.superjoin.ai/integrations/salesforce/import-report
Step-by-step guide to import data from Salesforce Reports to Google Sheets or Microsoft Excel
After connecting your account, a data preview window will appear. Here, navigate to the `Reports` tab where you can select a `Report` to import.
Add/modify the data fields you want to import. The `Fields` you selected should start showing up in the data preview section.
The `Fields` available here are the ones that are available in the Report made on the Salesforce platform.
After previewing the data, you are ready to start the import. Click on `Import` to start the import process. Here, you can name the new sheet where the data will be imported.
Once you are ready to import, click on `Save and Import` and wait for a few seconds. This action transfers selected data from your Salesforce account into Google Sheets.
You can schedule a `Refresh` to automatically update your data hourly, daily, weekly, or monthly at a specific time.
##### If you want to export changes you made in the imported data back into Salesforce, head over to the `Export Data` tab or click on the box below.
Step-by-step guide to export data from Google Sheets to Salesforce
##### Hope this guide helped you import your data from Salesforce to Google Sheets using Superjoin.
##### If you have any questions or need further assistance, please don’t hesitate to reach out to our support team. Thank you!
After connecting your account, a data preview window will appear. Here, navigate to the `Reports` tab where you can select a `Report` to import.
Add/modify the data fields you want to import. The `Fields` you selected should start showing up in the data preview section.
The `Fields` available here are the ones that are available in the Report made on the Salesforce platform.
After previewing the data, click on `Import` and wait for a few seconds. This action transfers all data from your Salesforce account into Microsoft Excel.
The desired data has been successfully written on to your Excel sheet. Now whenever you want fresh data, just click on the `Pull Latest Data` button.
##### Hope this guide helped you import your data from HubSpot to Microsoft Excel using Superjoin.
##### If you have any questions or need further assistance, please don’t hesitate to reach out to our support team. Thank you!
# How to import data from Salesforce to Spreadsheets using SOQL
Source: https://docs.superjoin.ai/integrations/salesforce/import-soql
Step-by-step guide to import data from Salesforce to Google Sheets or Microsoft Excel using SOQL
After connecting your account, a data preview window will appear. Here, navigate to the `SOQL` tab where you can craft your own `SOQL` to import.
Here, you can write your own `SOQL` query to fetch the data you want to import. You can make use of autocomplete for commonly used keywords.
After creating your query, click on `Run Query` to preview the data that will be imported.
Once you are ready to import, click on `Import` where you can name the new sheet where the data will be imported.
Click on `Save and Import` and wait for a few seconds. This action transfers selected data from your Salesforce account into Google Sheets.
You can schedule a `Refresh` to automatically update your data hourly, daily, weekly, or monthly at a specific time.
##### If you want to export changes you made in the imported data back into Salesforce, head over to the `Export Data` tab or click on the box below.
Step-by-step guide to export data from Google Sheets to Salesforce
##### Hope this guide helped you import your data from Salesforce to Google Sheets using Superjoin.
##### If you have any questions or need further assistance, please don’t hesitate to reach out to our support team. Thank you!
After connecting your account, a data preview window will appear. Here, navigate to the `SOQL` tab where you can craft your own `SOQL` to import.
Here, you can write your own `SOQL` query to fetch the data you want to import. You can make use of autocomplete for commonly used keywords.
After creating your query, click on `Run Query` to preview the data that will be imported.
Once you are ready to import, click on `Import` where you can name the new sheet where the data will be imported.
Click on `Save and Import` and wait for a few seconds. This action transfers selected data from your Salesforce account into Microsoft Excel.
The desired data has been successfully written on to your Excel sheet. Now whenever you want fresh data, just click on the `Pull Latest Data` button.
##### Hope this guide helped you import your data from HubSpot to Microsoft Excel using Superjoin.
##### If you have any questions or need further assistance, please don’t hesitate to reach out to our support team. Thank you!
# Salesforce Data Connector for Spreadsheets
Source: https://docs.superjoin.ai/integrations/salesforce/overview
Welcome to the Salesforce Data Connector's Support Documentation page.
Still can't find answers here? Email us at [support@superjoin.ai](mailto:support@superjoin.ai) and we will help you asap!
### Getting Started
Connect your Salesforce account to start importing or exporting data.
Address issues that you might face while connecting your Salesforce a/c.
Step-by-step guide to import data from Salesforce to Google Sheets
Step-by-step guide to export data from Google Sheets to Salesforce
### Salesforce Objects & Permissions
A list of supported Salesforce Objects for Import and Export.
Understand and obtain the right permissions on different Objects of Salesforce.
### Data Management
Steps to delete/erase your Salesforce account from Superjoin
Steps to remove the installed Superjoin app from your Salesforce account
# Connect your Salesforce account to Spreadsheets
Source: https://docs.superjoin.ai/integrations/salesforce/quickstart
Effortlessly connect Salesforce to Google Sheets or Microsoft Excel to export and import data using Superjoin's 2-way sync feature in a few clicks.
We've meticulously organized the data points to ensure easy accessibility in a format you're already familiar
with.
Get a sneak peek of your data. Select columns, apply filters & limits as per
your need before importing.
Enjoy one-click refreshes or schedule regular updates to ensure your sheets
are always up to date.
Benefit from Google Sheets' collaborative data analysis & other powerful
capabilities.
## Step-by-step walkthrough: How to connect Salesforce to Google Sheets
Head over to `Extensions`, select `Add-ons` and choose `Get Add-ons`. This action will redirect you to the
Google Workspace Marketplace.
In the Google Workspace Marketplace pop-up window, search for "Superjoin".
Click on the `Install` button to install Superjoin.
**Note:** For the best experience, install Superjoin where there's only a single account logged in the
Chrome profile.
Once installed, navigate back to the `Extensions` menu tab in Google Sheets. Launch Superjoin from here. You
should now see Superjoin running as a side panel on the right side of your screen.
To begin, you can navigate to `Queries`, choose to `Create new query`.
Navigate to `Sources`, select `Connect to a new source` and search for `Salesforce`.
Click on the `Connect` button and follow the on-screen instructions to link your account.
After connecting your account, a data preview window will appear, allowing you to modify your `Objects` and
apply various `Filters` to refine your data.
Based on whether you want to import data from your Salesforce account or export data from Google sheets into your
Salesforce account , pick one of the options below that will guide you further.
Step-by-step guide to import data from Salesforce to Google Sheets
Step-by-step guide to export data from Google Sheets to Salesforce
We've meticulously organized the data points to ensure easy accessibility in a format you're already familiar
with.
Get a sneak peek of your data. Select columns, apply filters & limits as per
your need before importing.
Enjoy one-click refreshes to ensure your sheets are always up to date.
Benefit from Microsoft Excel's collaborative data analysis & other powerful capabilities.
## Step-by-step walkthrough: How to connect Salesforce to Microsoft Excel
Click on `Add-ins` on the right side of the Excel toolbar.
Click on the searchbar and type "Superjoin". The results would show our add-in under the `More search results` section.
Once Superjoin launches as a side panel, just click on `Sign in with Microsoft` and follow the steps to authenticate your Microsoft Office account with Superjoin.
You should now see Superjoin running as a side panel on the right side of your screen.
To begin, you can navigate to `Queries`, choose to `Create new query`.
Navigate to `Sources`, select `Connect to a new source` and search for `Salesforce`.
Click on the `Connect` button and follow the on-screen instructions to link your account.
After connecting your account, a data preview window will appear, allowing you to modify your `Objects` and
apply various `Filters` to refine your data.
Based on whether you want to import data from your Salesforce account or export data from Microsoft Excel into your
Salesforce account, pick one of the options below that will guide you further.
Step-by-step guide to import data from Salesforce to Microsoft Excel
Coming soon!
# Understanding Salesforce User Level Permissions
Source: https://docs.superjoin.ai/integrations/salesforce/salesforce-permissions
This section will talk about how to give a Salesforce user access to specfic Objects
This section will be updated soon.
##### Meanwhile, Email us at [support@superjoin.ai](mailto:support@superjoin.ai) in case you have any questions or facing any issues. We will help you asap!
# Supported Salesforce Objects
Source: https://docs.superjoin.ai/integrations/salesforce/supported-objects
Salesforce Objects supported for Importing or Exporting Data using Superjoin
| Section | Object | Description |
| -------------------------------------- | -------------------- | ----------------------------------------------------- |
| **Core CRM Objects** | Leads | Potential customers or prospects |
| | Contacts | Individual people associated with an account |
| | Accounts | Companies or organizations you're doing business with |
| | Opportunities | Potential revenue-generating deals |
| | Campaigns | Marketing efforts to generate leads and opportunities |
| | Custom Objects | Tailored objects specific to your Salesforce org |
| | Cases | Customer support and service requests |
| **Sales & Revenue Objects** | Opportunities | Sales deals |
| | Opportunity Products | Products or services associated with opportunities |
| | Orders | Confirmed purchases |
| | Order Products | Items or services included in orders |
| | Products | Items or services being sold |
| | Pricebook Entries | Pricing information for products |
| | Assets | Purchased products in use by customers |
| | Contracts | Legal agreements with customers |
| **Engagement & Communication Objects** | Tasks | To-do items related to CRM actions |
| | Events | Scheduled calendar events or meetings |
| | Notes | Internal notes related to records |
| | Email Messages | Email communications |
| **Marketing & Lists** | Campaign Members | Links between leads/contacts and campaigns |
| | Campaigns | Marketing initiatives |
| **Operational & Reporting Objects** | Reports | Structured representations of Salesforce data |
| | Dashboards | Visual summaries of key metrics and data |
| | Audit Trail | Logs of configuration changes |
| Section | Object | Description |
| --------------------------- | -------------------- | ------------------------------------------------------ |
| **Core CRM Objects** | Leads | Potential customers or prospects |
| | Contacts | Individual people associated with an account |
| | Accounts | Companies or organizations you're working with |
| | Cases | Customer support and service requests |
| **Sales & Revenue Objects** | Opportunities | Sales opportunities |
| | Products | Items or services you sell |
| | Opportunity Products | Products or services linked to an opportunity |
| **Marketing & Lists** | Campaigns | Marketing efforts to generate and nurture leads |
| | Campaign Members | Participation of contacts/leads in marketing campaigns |
# Overview
Source: https://docs.superjoin.ai/integrations/summary
Pull data from 40+ Integrations using Superjoin
## Popular Integrations
### Configure & bring your data from any API.
## All Integrations
## Beta Integrations
## Coming Soon
# Connect your Vitally to Google Sheets
Source: https://docs.superjoin.ai/integrations/vitally/overview
Effortlessly connect your Vitally account to Google Sheets with just a few steps.
### Why use Superjoin’s Google Sheets-Vitally Integration?
We've meticulously organized the data points to ensure easy accessibility in a format you're already familiar with.
Get a sneak peek of your data. Select columns, apply filters & limits as per your need before importing.
Enjoy one-click refreshes or schedule regular updates to ensure your sheets are always up to date.
Benefit from Google Sheets' collaborative data analysis & other powerful capabilities.
## Step-by-step walkthrough: How to connect Vitally to Google Sheets.
Head over to `Extensions` , select `Add-ons` and choose `Get Add-ons`. This action will redirect you to the Google Workspace Marketplace.
In the Google Workspace Marketplace pop-up window, search for "Superjoin".
Click on the `Install` button to install Superjoin.
**Note:** For the best experience, install Superjoin where there's only a single account logged in the Chrome profile.
Once installed, navigate back to the `Extensions` menu tab in Google Sheets. Launch Superjoin from here. You should now see Superjoin running as a side panel on the right side of your screen.
To begin, you can navigate to `Queries` , choose to `Create new query`.
Navigate to `Sources`, select `Connect to a new source` and search for `Vitally`.
Enter your `Subdomain` and the `API Key` of your Vitally account. Once this is done, click on Authorize to allow Superjoin to access your Vitally data.
Select the objects and fields you wish to import, then preview and set limits on the number of rows to be imported.
Once you have previewed the data select `Import` and wait for a few seconds. This action pulls your selected data from Vitally to Google Sheets.
You can schedule a `Refresh` to automatically update your data daily, weekly, or monthly at a specific time.
# Introduction
Source: https://docs.superjoin.ai/introduction
Pull live data into Spreadsheets instantly
## Superjoin
Superjoin is your go-to platform for spreadsheet automation. With Superjoin, you can seamlessly connect multiple SaaS tools and with just one click, you can pull data directly into your preferred choice of Spreadsheets - Google Sheets or Microsoft Excel.
Say goodbye 👋🏽 to manual exports and embrace the power of automated data integration.
## Setting up
First things first, let's get you up and ready to start experiencing the power of Superjoin.
Install Superjoin in under a minute and start pulling your data instantly.
We've listed down common issues that you might face & how to fix it.
Choose from 40+ Integrations to import or export data.
## Quick Overview
Save hours of manual work by instantly connecting your SaaS data to Spreadsheets automatically!
Connect to multiple sources and pull data in just one click.
Set up schedules to automatically update Sheets with the latest data.
Draw insights from user interactions with your documentation.
Keep your docs on your own website's subdomain.
# Common Issues while launching Superjoin
Source: https://docs.superjoin.ai/issues-launching-superjoin
Sorry that you are facing an issue. Let's get it fixed!
Superjoin requires Chrome or a Chromium-based browser (like Chrome or Edge). It does not work on Safari or Firefox.
Always sign in with the Google account connected to your Google Sheets. This ensures seamless integration between Superjoin and your spreadsheets.
You must have editor (not view-only) access for Superjoin to work. View-only permissions will not allow Superjoin to function properly.
Yes! You can swap between AI Assistant and Data Connectors at any time from within the sidebar, depending on what you want to accomplish.
## Solution
After installing Superjoin, please refresh the Google Sheet you're working on.Pause for about 15 seconds, then navigate to the "Extensions" menu. "Superjoin" should be listed there.Ensure you're logged into the Google account you used to install Superjoin. Sometimes, being logged into multiple accounts can cause visibility issues.If you've tried the above steps and still can't see Superjoin, don't hesitate to contact us at [support@superjoin.ai](mailto:support@superjoin.ai). We will respond immediately.
This issue often arises with Google Workspace when users have multiple Google accounts. If Superjoin is installed on a non-default account, it may not launch properly.
## Solution
For a seamless experience, consider installing Superjoin on the default Google account associated with your browser.
Create a new Chrome profile dedicated solely to a single Google account. This ensures no account conflicts when launching Superjoin.As a temporary solution, launch an incognito window in your browser and access Superjoin. This mode ensures no account conflicts for that sessionIf you've tried the above steps and still facing the same issue, don't hesitate to contact us at [support@superjoin.ai](mailto:support@superjoin.ai). We will respond immediately.
## Solution
After installing Superjoin, please refresh the Google Sheet you're working on.Pause for about 15 seconds, then navigate to the "Extensions" menu. "Superjoin" should be listed there.Once you locate "Superjoin" in the menu, click on it. You should see an option labeled "Launch Superjoin". Select this to start using the add-on.If you've tried the above steps and still facing the same issue, don't hesitate to contact us at [support@superjoin.ai](mailto:support@superjoin.ai). We will respond immediately.
This issue often arises with Google Workspace when users have multiple Google accounts and you are using a non-default account. If Superjoin is installed on a non-default account, it may not launch properly.
## Solution
For a seamless experience, consider installing Superjoin on the default Google account associated with your browser.Create a new Chrome profile dedicated solely to a single Google account. This ensures no account conflicts when launching Superjoin.As a temporary solution, launch an incognito window in your browser and access Superjoin. This mode ensures no account conflicts for that sessionIf you've tried the above steps and still facing the same issue, don't hesitate to contact us at [support@superjoin.ai](mailto:support@superjoin.ai). We will respond immediately.
This issue results in your import schedules to fail inconsistently and impacts the liveliness of your sheets. Here's how to fix this:
## Solutions
From the help menu on the top right section, select "Re-authorize with Google".
If you have already authenticated earlier, you will not see this in the Help menu.
Continue with the sign in process. We will be taking couple of Google Account permissions in order to write to your Google Sheets without interruptions.
If you've tried the above steps and still facing the same issue, don't hesitate to contact us at [support@superjoin.ai](mailto:support@superjoin.ai). We will respond immediately.
## Deploy Superjoin for the Entire Organization
Go to:
[https://admin.microsoft.com](https://admin.microsoft.com)
Log in with a **Global Admin** or **Application Admin** account.
In the left sidebar, click **Settings** → **Integrated apps**, then click **Get apps**.
In the AppSource search bar, search for **Superjoin** and click the Superjoin listing.
Click **Get it now**. You will be asked who to deploy this to: **Entire organization** (recommended), **Specific users/groups**, or **Just me**. Choose the appropriate option and click **Deploy**. That's it! Superjoin is now approved and available inside Excel.
## What Users Will See
Once deployed, users can access Superjoin by opening Excel (Web or Desktop), navigating to **Home** → **Add-ins**, and clicking **Superjoin**. No further approval will be required.
# Quickstart
Source: https://docs.superjoin.ai/quickstart
Let's help you install and start using Superjoin in under a minute!
Here's the step-by-step guide to Install Superjoin on Google Sheets.
Open from Google Drive or type `sheets.new` in a new Google Chrome tab.Click on `Extensions` from the Google Sheets menu.
Select `Add-ons` and choose `Get Add-ons`. This action will redirect you to the Google Workspace Marketplace.
In the Google Workspace Marketplace pop-up window, search for "Superjoin".
Click on `Extensions` from the Google Sheets menu.
**Note:** For the best experience, install Superjoin where there's only a single account is logged in the Chrome profile.
Once installed, navigate back to the `Extensions` menu tab in Google Sheets.
Launch Superjoin from there. You should now see Superjoin running as a side panel on the right side of your screen.
In cases where only "Help" is visible after clicking on `Extensions`, refresh your Google Sheet and wait for some time. Sometimes it takes
over a minute to load. If you are still facing the issue, email us at [support@superjoin.ai](mailto:support@superjoin.ai).
Here's the step-by-step guide to Install Superjoin on Microsoft Excel.
Open your desktop app or paste this link `www.microsoft365.com/launch/Excel` in a new tab in your browser.
Click on the `Blank workbook` option that's on top of the window.
Click on `Add-ins` on the right side of the Excel toolbar.
Click on the searchbar and type "Superjoin". The results would show our add-in under the `More search results` section.
Once Superjoin launches as a side panel, just click on `Sign in with Microsoft` and follow the steps to authenticate your Microsoft Office account with Superjoin.
You should now see Superjoin running as a side panel on the right side of your screen.
## What is Superjoin?
Superjoin is an AI-powered assistant and data integration tool designed for Google Sheets users. It lets you:
* Connect Google Sheets live to apps like HubSpot, Stripe, and Salesforce
* Automate data sync between sources and your spreadsheets
* Use AI to help with data cleaning, dashboard creation, analysis, and formula writing—all with natural language commands
Whether you're a marketer, analyst, or operations pro, Superjoin is built to help you automate repetitive spreadsheet tasks and work smarter inside Sheets.
***
## Watch the Demo
***
## Installing Superjoin in Google Sheets
Go to the official [Superjoin AI website](https://www.superjoin.ai).
Click the **Get Started for Free** button to begin the setup.
This takes you to the Chrome Web Store.
Superjoin is a Chrome extension and requires a Chromium-based browser (like Chrome or Edge). It does not work on Safari or Firefox.
Click **Add to Chrome** to install the extension.
Once installed, you'll be directed to a login page.
Sign in with your Google account—the same one you use for Google Sheets. Superjoin works only in Google Sheets environments.
Approve all necessary permissions for Superjoin to operate. This allows integration between your Sheets and external services.
Once complete, Superjoin is installed and ready to use.
***
## Connecting Superjoin to Your Google Sheet
You can use Superjoin on a brand new or an existing Google Sheet.
Open Google Sheets and either:
* Start a new sheet, or
* Open an existing sheet where you want to use Superjoin
If you're starting new, click the appropriate button in Superjoin to launch a blank Google Sheet.
You must have **editor access** on the sheet. Superjoin will not function with view-only permissions.
Once your sheet is open and you have the correct access, you'll see Superjoin listed in your sidebar.
Click on Superjoin in the sidebar to load its features and tools.
***
## Getting Started with Superjoin's AI and Data Sync Features
When Superjoin opens, you'll see its two core feature sets:
* **Data Connectors**: Sync live data in and out of spreadsheet tables from sources like HubSpot, Stripe, and Salesforce.
* **AI Assistant**: Your Sheets copilot for data cleaning, dashboard creation, and writing advanced formulas—using plain language commands.
Select either **Data Connectors** or **AI Assistant** depending on what you want to accomplish today.
For example, click **AI Assistant** for help with formulas or dashboards. You can explore both the features later in the app.
You'll be prompted with a quick onboarding form to tailor the assistant to your needs.
Fill out the form and click **Get Started**.
After onboarding, access the Superjoin home screen by clicking the home button.
This navigation page is your starting point—choose to use AI features for sheet automation, or connect new data sources for syncing.
***
## Frequently Asked Questions
Superjoin requires Chrome or a Chromium-based browser (like Chrome or Edge). It does not work on Safari or Firefox.
Always sign in with the Google account connected to your Google Sheets. This ensures seamless integration between Superjoin and your spreadsheets.
You must have editor (not view-only) access for Superjoin to work. View-only permissions will not allow Superjoin to function properly.
Yes! You can swap between AI Assistant and Data Connectors at any time from within the sidebar, depending on what you want to accomplish.
***
## Next Steps and Use Cases
You've now installed Superjoin, connected it to your Google Sheets, and explored its AI and data sync capabilities. You're ready to:
* Automate live data imports from tools like HubSpot or Stripe
* Use the AI Assistant for cleaning, analyzing, and visualizing data
* Streamline manual spreadsheet processes and save hours every week
Explore Superjoin's advanced workflows—like building live dashboards, creating automated reports, or syncing two-way data with external services—for even more powerful productivity gains inside Google Sheets.
If you are looking for a step-by-step guide to Import or Export data from a specific Data source, navigate to that Data Source from the
left side list under the section named Integrations.
## Features Overview
Save hours of manual work by instantly connecting your SaaS data to Spreadsheets automatically!
Connect to multiple sources and pull data in just one click.
Set up schedules to automatically update Sheets with the latest data.
Draw insights from user interactions with your documentation.
Keep your docs on your own website's subdomain.
# Superjoin 💙 Microsoft Excel
Source: https://docs.superjoin.ai/superjoin-excel
Key functionalites that enhance your experience on Excel & limitations are highlighted in this section
### Creating New Column on an Import sheet
When you add a new column at the end of the sheet, Superjoin ensures that this column remains intact through data refreshes, without affecting any existing data or structure.
### Create New Column in Between/Beginning
If you try to add a new column at the beginning or in between existing columns, this action will result in the **column being deleted after the next data refresh** or modification, as Superjoin preserves the integrity of the imported data layout.
### Update Data Cells (Modifying Rows)
When modifying a row record, any changes made will be overridden by the data available at your source on the next data refresh. We recommend you to create a new column on the right of the imported data to store custom data.
### Spreadsheet Limits
Each spreadsheet can handle up to 1.7 billion cells, which is the upper limit based on Miscrosoft Excel’s spreadsheet limitations. This makes it easy to manage extensive datasets within your existing sheets.
# Superjoin 💙 Google Sheets
Source: https://docs.superjoin.ai/superjoin-gsheets
Key functionalites that enhance your experience on Sheets & limitations are highlighted in this section
### Creating New Column on an Import sheet
When you add a new column at the end of the sheet, Superjoin ensures that this column remains intact through data refreshes, without affecting any existing data or structure.
### Flexi-Columns (Column Rearrangement)
If you rearrange the order of columns in your sheet, rest assured that the new order will remain intact through data refreshes. Superjoin does not alter column positions once they have been rearranged by the user on Sheet.
### Create New Column in Between/Beginning
If you try to add a new column at the beginning or in between existing columns, this action will result in the **column being deleted after the next data refresh** or modification, as Superjoin preserves the integrity of the imported data layout.
### Update Data Cells (Modifying Rows)
When modifying a row record, any changes made will be overridden by the data available at your source on the next data refresh. We recommend you to create a new column on the right of the imported data to store custom data.
### Delete Column
If you delete a column in the middle of your sheet, Superjoin will automatically move it to the end of the sheet, ensuring that your core data structure remains consistent.
### Working on Template Data Sheets
If you are working with template sheets, be aware that any modification that you make will be overwritten during the next data refresh. This ensures that the template remains up-to-date and accurately reflects any changes made to the underlying data.
### Formulae Drilldown
Formulae Drilldown automatically populates any formulas that you have in the spreadsheet in the immediate right columns of the imported data every time you refresh the data.
This saves you the time (and hassle) of manually going into your spreadsheet and copying your formula(s) down the row(s) manually.
Click here for step-by-step instructions.
### Editing a Config after Import
This feature is currently supported for the following integrations – Chargebee, HubSpot, MySQL, PostgreSQL
You can easily add/remove data columns, change the column orders or apply new filters to the existing imports without creating a new query again and again.
### Auto Refresh in Append Mode
In Append Mode, Superjoin automatically adds new data to the existing dataset, making it ideal for continuously growing datasets. This mode operates in a mindless append fashion, meaning that new rows will be appended to the sheet during every refresh. However, it should be noted that manual refreshes are not possible in this mode, as the system automatically handles the updates for you.
### Flashbacks
When using the Flashback feature, a new sheet will be created after each refresh. This ensures that you can maintain a historical view of your data over time. The original sheet will still be refreshed with the most up-to-date data, preserving your current working dataset while allowing you to keep track of previous versions for comparison or auditing purposes.
### Spreadsheet Limits
Each spreadsheet can handle up to 10 million cells, which is the upper limit based on Google Sheets’ spreadsheet limitations. This makes it easy to manage extensive datasets within your existing sheets.
### Schedule Limits
* **Schedules per Sheet**: You can set up to 5 refresh schedules per sheet, allowing for regular automated updates to your data without manual intervention.
* **Simultaneous Schedules**: Superjoin does not support running multiple schedules at the same time. Each schedule is queued and executed sequentially to ensure data consistency.
* **Maximum Schedules Limit**: Keep track of how many schedules are active at any given time. You can monitor your scheduled refreshes to make sure you're using the system efficiently without exceeding the limit.
# SUPERGPT Functions for Sheets
Source: https://docs.superjoin.ai/tlg/GPTFunctions
Discover all available functions in SUPERGPT for Sheets, along with simple examples and an extensive list of paramaters.
Only available on Google Sheets
Prepare to transform your Google Sheets experience with the groundbreaking SUPERGPT Functions! 🌟 Powered by OpenAI's advanced language model, these tools enable you to conduct natural language processing, generate text, perform sentiment analysis, and even create code right in your spreadsheets. 🚀 Unlock new insights and enhance decision-making with these capabilities, streamlining your workflows for peak productivity. Dive into a new realm of possibilities and elevate your spreadsheet game with SUPERGPT functions!
You have opened a Google spreadsheet and selected Extensions > Superjoin > Enable SUPERGPT functions.
To enable SUPERGPT functions, you must be the Creator of the spreadsheet.
## How to use SUPERGPT Functions on Google Sheet?
## SUPERGPT function
The simplest function to start using SUPERGPT in Google Sheets. Outputs the result in a single cell.
**How to use**
| Syntax | =SUPERGPT(prompt, \[value], \[temperature], \[model]) |
| ------------------ | ----------------------------------------------------- |
| Copy/paste example | `=SUPERGPT("Write a tagline for an ice cream shop.")` |
| Output | A response to your prompt in a single cell |
**Parameters**
| Parameter | Definition |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| prompt (cannot be empty) | Instruction provided to the AI to generate a result in a single cell. The prompt parameter can be: - A string: `"Write a tagline for an ice cream shop."` - A cell: `A1` -A range of cells: `A1:C3` |
| value (optional) | Text, cell or range you want your prompt to apply to |
| temperature (optional) | temperature is a number between 0 and 1. Use it to control creativity. |
## SUPERGPT\_LIST function
Like the SUPERGPT function, but even more user-friendly for quickly generating results in a list format.
**How to use**
| Syntax | =SUPERGPT\_LIST(prompt, \[value], \[temperature], \[model]) |
| ------------------ | -------------------------------------------------------------------- |
| Copy/paste example | `=SUPERGPT_LIST("Give me 5 good short ads about spreadsheets.")` |
| Output | As many responses to your prompt as you asked, one response per cell |
**Parameters**
| Parameter | Definition |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| prompt (cannot be empty) | Instruction provided to the AI to generate a list. The prompt parameter can be: - A string: `"Give me 5 good short ads about spreadsheets."` - A cell: `A1` -A range of cells: `A1:C3` |
| value (optional) | Text, cell or range you want your prompt to apply to |
| temperature (optional) | temperature is a number between 0 and 1. Use it to control creativity. |
## SUPERGPT\_FILL function
Fill in a range with generated results that follow the pattern of the example rows you choose!
**How to use**
| Syntax | =SUPERGPT\_FILL(examples, \[inputs], \[temperature]) |
| ------------------ | ------------------------------------------------------------------------- |
| Copy/paste example | `=SUPERGPT_FILL(S4:U5,S6:S14)` |
| Output | The empty part of the range will be filled based on the examples provided |
**Parameters**
| Parameter | Definition |
| -------------------------- | --------------------------------------------------------------------------------- |
| examples (cannot be empty) | Range containing complete examples that the AI should learn from (example: S4:U5) |
| inputs (optional) | Range containing incomplete data that the AI should complete from the examples |
| temperature (optional) | temperature is a number between 0 and 1. Use it to control creativity. |
## SUPERGPT\_TABLE function
Like SUPERGPT, but outputs the results in a table. Very practical when the output is a table
**How to use**
| Syntax | =SUPERGPT\_TABLE(prompt, \[head], \[inputs], \[temperature]) |
| ------------------ | ----------------------------------------------------------------------------------------- |
| Copy/paste example | `=SUPERGPT_TABLE("top 10 most eaten fruits and their nutrition data", A1:D1, A2:A5, 0.8)` |
| Output | The response to your prompt in the shape of a table |
**Parameters**
| Parameter | Definition |
| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| prompt (cannot be empty) | Instruction to generate a table. The prompt parameter can be: - A string: `"top 10 most eaten fruits and their nutrition data"` - A cell: `A1` -A range of cells: `A1:C3` |
| head (optional) | Range containing at least one row. the first row should be headers, the following rows can be used to specify examples If left empty, headers will be generated automatically. |
| inputs (optional) | Range containing partial rows to complete with SUPERGPT\_TABLE |
| temperature (optional) | temperature is a number between 0 and 1. Use it to control creativity. |
## SUPERGPT\_EDIT function
Applies the given task to the given text. The default task is to fix grammar and spelling.
**How to use**
| Syntax | =SUPERGPT\_EDIT(text, \[task], \[temperature]) |
| ------------------ | ------------------------------------------------------------------------------------- |
| Copy/paste example | `=SUPERGPT_EDIT("It is to cold in hear.", "Fix spelling and grammar mistakes.", 0.8)` |
| Output | The edited text in a single cell |
**Parameters**
| Parameter | Definition |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| text (cannot be empty) | Input text to edit. The text parameter can be: - A string: `"It is to cold in hear."` - A cell: `A1` -A range of cells: `A1:C3` |
| task (cannot be empty) | Text, cell or range specifying how the text should be edited. Defaults to fixing grammar and spelling. Other examples: - "Make it funnier" - "Make it shorter" - "Make it sound formal" - "Add an ending" |
| temperature (optional) | temperature is a number between 0 and 1. Use it to control creativity. |
## SUPERGPT\_TAG function
Applies user-defined tags to text or automatically suggests relevant tags if none are specified.
**How to use**
| Syntax | =SUPERGPT\_TAG(value, \[tags], \[examples], \[top\_k], \[temperature]) |
| ------------------ | ---------------------------------------------------------------------- |
| Copy/paste example | `=SUPERGPT_TAG("I love chocolate", "food, positive, negative")` |
| Output | The applicable tags as csv in a single cell |
**Parameters**
| Parameter | Definition |
| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| value (cannot be empty) | Input text to tag. The value parameter can be: - A string: `"I love chocolate"` - A cell: `A1` -A range of cells: `A1:C3` |
| tags (optional) | Comma-separated tags or range of tags applicable. If left empty, SUPERGPT\_TAG will automatically come up with the tags |
| top\_k (optional) | Maximum number of tags to return |
| examples (optional) | A table of examples in two columns. The first column should contain the inputs and the second column should contain the outputs. |
| temperature (optional) | temperature is a number between 0 and 1. Use it to control creativity. |
## SUPERGPT\_CLASSIFY function
Classifies a given text into a single category.
**How to use**
| Syntax | =SUPERGPT\_CLASSIFY(value, categories, \[examples], \[temperature]) |
| ------------------ | ------------------------------------------------------------------- |
| Copy/paste example | `=SUPERGPT_CLASSIFY("banana", "fruit, vegetable")` |
| Output | The best applicable category |
**Parameters**
| Parameter | Definition |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| value (cannot be empty) | Input text to classify. The value parameter can be: - A string: `"banana"` - A cell: `A1` -A range of cells: `A1:C3` |
| categories (cannot be empty) | Comma-separated categories or range of categories to choose from. Only the most relevant category will be returned. |
| examples (optional) | A table of examples in two columns. The first column should contain the inputs and the second column should contain the outputs. |
| temperature (optional) | temperature is a number between 0 and 1. Use it to control creativity. |
## SUPERGPT\_EXTRACT function
Extracts data (like email addresses or company names) from a text. Outputs as comma-separated values.
**How to use**
| Syntax | =SUPERGPT\_EXTRACT(text, to\_extract, \[temperature]) |
| ------------------ | -------------------------------------------------------------------------------------------- |
| Copy/paste example | `=SUPERGPT_EXTRACT("I worked 5 years at Amazon.com and then 3 years at Apple", "companies")` |
| Output | The extracted entities as comma-separated values in a single cell |
**Parameters**
| Parameter | Definition |
| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| text (cannot be empty) | Input text to extract data from. The text parameter can be: - A string: `"I worked 5 years at Amazon.com and then 3 years at Apple"` - A cell: `A1` -A range of cells: `A1:C3` |
| to\_extract (cannot be empty) | Text, cell or horizontal range specifying what you want to extract. Examples: - `"companies"` - `B3:E3` |
| temperature (optional) | temperature is a number between 0 and 1. Use it to control creativity. |
## SUPERGPT\_SUMMARIZE function
Summarizes text according to a given format (three sentences by default).
**How to use**
| Syntax | =SUPERGPT\_SUMMARIZE(text, \[format], \[temperature]) |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Copy/paste example | `=SUPERGPT_SUMMARIZE(A2:A10, “10 words or less”)` |
| Output | Returns a summary of the input text in the format specified. Note - If selecting to summarize a range of cells, the output will be a summary for each individual cell of the selected range, not a single summary of all cells included in range. |
**Parameters**
| Parameter | Definition |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| text (cannot be empty) | Input text to summarize. The text parameter can be: - A string: `"Some long content"` - A cell: `A1` -A range of cells: `A1:C3` |
| format (optional) | Format of the summary. Examples: - `"key takeaways"` - `"action items"` - `"two paragraphs"` - `"100 words"` - `"tweets"` |
| temperature (optional) | temperature is a number between 0 and 1. Use it to control creativity. |
## SUPERGPT\_TRANSLATE function
Translates text from one language into another. Works better if you specify the source language.
**How to use**
| Syntax | =SUPERGPT\_TRANSLATE(text, \[target\_language], \[source\_language], \[instructions],\[temperature]) |
| ------------------ | ---------------------------------------------------------------------------------------------------- |
| Copy/paste example | `=SUPERGPT_TRANSLATE("Cool off with our delicious treats!", "spanish")` |
| Output | The requested translation in a single cell |
**Parameters**
| Parameter | Definition |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| text (cannot be empty) | Input text to translate. The text parameter can be: - A string: `"Cool off with our delicious treats!"` - A cell: `A1` -A range of cells: `A1:C3` |
| target\_language (optional) | Language of the output. Examples: "spanish", "chinese", "french". Defaults to "english". |
| source\_language (optional) | Language of the input. Example: "english" |
| instructions (optional) | Additional instructions for the translation. Can include a dictionary of translations. |
| temperature (optional) | temperature is a number between 0 and 1. Use it to control creativity. |
## FAQs for SUPERGPT\_ Functions
Yes, to ensure that SUPERGPT can provide a sufficient response, we have set a character limit of 2k tokens. This is about 8k characters for the prompt.
For SUPERGPT Functions to calculate, you will need to open the Superjoin sidebar at least once.
Anyone with Editor (Google Sheets Permissions) can use the SUPERGPT functions, however - all the usage will incur on the owner of the spreadsheet who first launched Superjoin.
The SUPERGPT functions, similar to Google Sheet formulas, recalculate when you reload the sheet. To avoid these recalculations affecting your usage limits, you can use the button "Convert Formulas to Values" on Superjoin.
# Automate Google Sheets Using Workflows
Source: https://docs.superjoin.ai/workflows/introduction
Learn how to automate your workflows in Google Sheets with Superjoin. Follow this step-by-step guide to create, configure, and manage workflows effortlessly, allowing you to streamline data processes and automate actions based on specified triggers.
Only available on Google Sheets
## Follow the quickstart guide to get started with Superjoin 🚀
Install Superjoin in under a minute and start pulling your data instantly.
We've listed down common issues that you might face & how to fix it.
## Steps to get up and running with Workflows ✨
Ensure Superjoin is installed and working before following the rest of the guide. Link to quick start guide is shared above.
Click on the `+ Create` button. This will open the create drawer at the bottom of the side-panel screen.
Click on `New Workflow`. This will take you to the worklow creation page.
Click on the pencil icon near `Workflow 1`. This will let you edit the workflow name.
You can't edit this later! Once created, a workflow can't be edited.We will cover how to duplicate a workflow later in this guide.
Click on the tick (✔️) icon to cofirm the name. This will update the workflow's name.
Next, click on the `Configre Trigger` button to select the trigger for our workflow.
Click on the `Trigger Type` dropdown to select a trigger for our workflow.
A trigger is an event which, when fired, will run the associated workflow.
Let's start by selecting `At Scheduled Time`
to run our workflow at a specified interval.
Click on the `Interval Type` dropdown to select the interval at which to run this workflow.
Select `Monthly` to run the workflow on a particular date every month at the selected time.
You can also use other intervals like `Hourly`, `Daily` and `Weekly`
We also have another trigger called `Import Refresh` which fires whenever the data
of the selected sheet refreshes (either manually or through a schedule).
It does not trigger when changing a sheet's data by hand.
Click on `New Action` to open the new action side drawer. Here, you can select between
two actions, `Send Screenshot` and `Refresh Import`. Select the screenshot action.
If the trigger for your workflow is an import refresh then that sheet cannot be an import refresh action.
After selecting the send screenshot action, pick the sheet that you want screenshotted.
You can type the name of the sheet and search in the dropdown.
Click on start selection and wait for the sheet to open. Then start selecting the range
and click on stop selection when you're done.
If you wish to send the screenshot to a slack channel, follow
[this](slack)
guide to connect your slack account.
We discussed how to select Slack as a channel for sending a screenshot in the previous step.
For sending a screenshot via email, we just have to write the emails in the `to` field, which is auto-populated
with the emails of other users in your workspace for your convenience.
You can write the `subject` and `body` in the provided fields.
You can test your action by clicking the send preview button and verify if everything is
connected correctly.
After the preview has been sent successfully, you can save the action and continue adding more actions to your
workflow.
Saving an action does not save the workflow and if you go back to the home screen, you will lose your current work.
Click on save workflow to save your workflow. It will now start executing whenever
the associated trigger is fired (for import refresh based trigger) or repeat at the scheduled frequency.
Use the toggle to pause or unpause your workflow.
Click the three dots to view more options like delete, duplicate and workflow execution history.
Click the trash icon in the more options menu and then click the `Delete` button.
# Send Google Sheet snapshots to Slack automatically
Source: https://docs.superjoin.ai/workflows/slack
Connect Slack to Google Sheets in a few clicks
Only available on Google Sheets
### What is Superjoin’s Google Sheet-Slack Integration?
The Slack integration allows you to connect your team's Slack to Superjoin
and send automated notifications to any public channel through our bot `Updates by Superjoin`.
Follow this guide to setup a workflow
**(steps 1-10)**.
Select Slack from the notification channel dropdown.
Click on connect to connect to your team's Slack and give Superjoin access
to public channels.
We can only send notifications to public channels and cannot read any
messages.
Click allow to install Superjoin's bot to your team's Slack. After
successful authentication, this window will close automatically.
You should see this message on your screen after successful connection. This
tab will close automatically or you can close it manually.
You can now select your Slack account. Each new account that you
authenticate will show up here under the name of your Slack team.
Finally, you can now select (or type) the public channel where you wish to
send your automated notifications. We recommend creating a dedicated public
channel for our bot so you can have a clean message history.
You should now have a Slack account connected and a channel selected for
sending notifications.
# How to Cancel Superjoin Subscription?
Source: https://docs.superjoin.ai/faqs/cancel-superjoin-subscription
Step-by-step guide to cancel Superjoin Subscription
Open Superjoin by clicking on the icon that is on the top right of your Google Sheets.
Click the purple button on the top of the screen that shows your current plan and click on "Manage Subscription" button.
In the Account Management Dashboard, click on the "Cancel Subscription" button on the top right of the screen.
Click the "Cancel Subscription" button in the confirmation page to finalize the cancellation.
Congratulations! You have successfully canceled your Superjoin subscription. You will continue to have access to Superjoin features until the end of your current billing cycle.
# Can't See Filter Options for Fields
Source: https://docs.superjoin.ai/faqs/cant-see-filter-options-superjoin
Understanding why certain field filters are unavailable in Superjoin and how to work around this limitation
## I can't see an option to filter a field. Why?
When working with Superjoin to import data from HubSpot into Google Sheets, it's common to wonder why certain filter options are missing for some fields. This FAQ explains the underlying reasons and guides you on what to expect.
**Quick answer:** Filter options are only available for your primary object, not secondary objects in associations.
## Why can't I add filters to certain fields?
In Superjoin, the ability to filter data depends on how your objects (such as Contacts or Deals) are associated during the import process.
### How object associations work:
When you set up the import, you select a **primary object** (for example, Contacts).
You can associate it with a **secondary object** (such as Deals).
**Filters are only available for the primary object.** This means if Contacts is the primary object and Deals is secondary, you can only use filter options for Contact properties—not for Deal properties.
The association of Contacts (primary object) with Deals (secondary object) in Superjoin. This association controls which properties can be filtered.
## Where do I see which filters are available?
Once you set your associations, the filter dropdown will display all available filter options for your primary object only. Filters for secondary object fields will not appear.
### How to identify available filters:
1. **Look at your filter dropdown** - It will show only primary object properties
2. **Check your object hierarchy** - Primary objects have full filtering capabilities
3. **Understand the limitation** - Secondary objects cannot be filtered directly
The available filter options for the primary object (Contacts) in Superjoin. This screen illustrates that only primary object filters are accessible.
## What can I do if I need to filter based on a secondary object's fields?
**Important:** You cannot filter secondary objects directly. You'll need to restructure your import setup.
### Solutions to consider:
To filter by properties from a secondary object, change your primary object selection during setup.
Consider making the field you want to filter by part of your primary object.
Create a separate import with the desired object as primary to access its filter options.
**Pro tip:** Plan your object hierarchy carefully before setting up your import to ensure you can filter on the fields you need most.
***
## Summary & Best Practices
* Only primary objects have filter options
* Plan your object hierarchy before importing
* Check filter dropdown to see available options
* Change primary object if you need different filters
* Create separate imports for different filtering needs
* Restructure your data associations as needed
### Key Takeaways
* **Primary objects** = Full filtering capabilities
* **Secondary objects** = No direct filtering
* **Plan ahead** = Choose your primary object based on your filtering needs
* **Be flexible** = You can always restructure your import setup
***
**Need help with object associations?** Contact Superjoin support with details about your filtering requirements so they can assist you with the best setup approach.
# How to change the billing details for my Superjoin subscription?
Source: https://docs.superjoin.ai/faqs/change-billing-information
Step-by-step guide on how to change the billing details for Superjoin
Open Superjoin by clicking on the icon that is on the top right of your Google Sheets.
Click the purple button on the top of the screen that shows your current plan and click on "Manage Subscription" button.
Click on the "Update Information" option under the billing information section.
Enter the new billing details you wish to use and click on the "Save" button to save the changes.
Congratulations! You have successfully updated your billing details for Superjoin. All future billing communications will be sent to the new email address you provided.
# My export limits are exhausted. What to do?
Source: https://docs.superjoin.ai/faqs/export-limits-exhausted
Steps to take when your Superjoin export limits are exhausted
If you have exhausted your Superjoin export limits (export runs or number of rows), you have to buy a higher plan to continue using Superjoin for your data exports or wait till the next month cycle for your limits to reset.
Explore our [pricing plans](https://www.superjoin.ai/pricing) to find the one that best suits your needs.
# Fix "No Headers" issue
Source: https://docs.superjoin.ai/faqs/fix-no-headers-superjoin-export
During an export, if you see an error message that says "No headers in Row", you can fix it with these easy steps.
## Fixing the "No Headers Detected" Issue in Superjoin
This guide will walk you through the process of resolving the "No Headers Detected" issue that you may encounter while exporting data in Superjoin. This is particularly useful for data analysts and operations teams who need to ensure their data exports are correctly formatted for further analysis.
### Understanding the Issue
When exporting data, you may come across a message stating "No Headers Detected". This typically happens when Superjoin is unable to find any headers in the specified row of your spreadsheet.

\*The "No Headers Detected" error message in Superjoin\*
### Step 1: Check the Header Row
The first step is to check the row number where Superjoin is trying to find headers. If the specified row is empty, as in the example below, Superjoin will not be able to detect any headers.

\*An empty row where Superjoin is trying to find headers\*
### Step 2: Fill the Header Row
You have two options to resolve this issue. The first option is to fill the empty row with the appropriate headers and fetch the data again. For instance, you can fill the row with headers such as "Deal Name", "Deal Amount", and "Deal Stage".

\*Fetching the data after filling the row with headers\*
You should now see that the headers have been populated correctly.
### Step 3: Change the Header Row
The second option to resolve the "No Headers Detected" issue is to change the header row to another row that contains headers.

For instance, you can move the header row to row one. Then, switch over to the row that contains the headers.

\*Switching over to the row that contains the headers\*
After making the same selections as before, you should now see the page with the correct row headers.
# I'm 100% sure that my formula is right but it still doesn't work. Why?
Source: https://docs.superjoin.ai/faqs/google-sheets-formula-not-working-region
Understanding regional differences in Google Sheets formulas and how to fix them.
## Regional Differences in Google Sheets Formulas
Your formulas might be correct, but they may not be in the **right format for your region**. Google Sheets formulas differ based on your **locale settings**, which can impact separators, function names, number formats, and more. These differences can cause formulas to appear "broken" when they’re actually just formatted for another region.
If you ever face issues with formulas, just ask **Superjoin AI** for help – it’s an advanced Copilot for Google Sheets that understands these differences and can guide you.
***
## 1. Argument Separators
* **US/UK and most English-speaking locales:** Comma ( `,` )\
Example: `=SUM(A1, B1, C1)`
* **European and some other locales:** Semicolon ( `;` )\
Example: `=SUM(A1; B1; C1)`
👉 **Why?** In many European countries, the **comma is used as a decimal separator** (e.g., `3,14` instead of `3.14`). To avoid confusion, Google Sheets switches to semicolons for function arguments.
***
## 2. Decimal and Thousands Separators
* **US/UK:** `1,234.56`
* **Germany/France:** `1.234,56` or `1 234,56`
👉 **Why?** Local numeric conventions. Spreadsheets adapt to what people are used to seeing in everyday documents.
***
## 3. Function Names
Functions are **translated into the local language** for consistency with Excel and local expectations.
Examples:
* `=IF()` → `=SI()` (French, Spanish)
* `=VLOOKUP()` → `=SVERWEIS()` (German), `=RECHERCHEV()` (French)
* `=TRUE` → `=VRAI` (French) / `=VERDADERO` (Spanish)
***
### 📊 Common Function Translation Table
| Function (English) | French | German | Spanish |
| ------------------ | --------------- | --------------- | -------------- |
| `=SUM()` | `=SOMME()` | `=SUMME()` | `=SUMA()` |
| `=IF()` | `=SI()` | `=WENN()` | `=SI()` |
| `=VLOOKUP()` | `=RECHERCHEV()` | `=SVERWEIS()` | `=BUSCARV()` |
| `=HLOOKUP()` | `=RECHERCHEH()` | `=WVERWEIS()` | `=BUSCARH()` |
| `=AVERAGE()` | `=MOYENNE()` | `=MITTELWERT()` | `=PROMEDIO()` |
| `=ROUND()` | `=ARRONDI()` | `=RUNDEN()` | `=REDONDEAR()` |
| `=LEN()` | `=NBCAR()` | `=LÄNGE()` | `=LARGO()` |
| `=LEFT()` | `=GAUCHE()` | `=LINKS()` | `=IZQUIERDA()` |
| `=RIGHT()` | `=DROITE()` | `=RECHTS()` | `=DERECHA()` |
| `=NOW()` | `=MAINTENANT()` | `=JETZT()` | `=AHORA()` |
| `=TODAY()` | `=AUJOURDHUI()` | `=HEUTE()` | `=HOY()` |
| `=TRUE` | `=VRAI` | `=WAHR` | `=VERDADERO` |
| `=FALSE` | `=FAUX` | `=FALSCH` | `=FALSO` |
***
## 4. Date Formats
* **US:** `MM/DD/YYYY` → `01/25/2025`
* **Europe:** `DD/MM/YYYY` → `25/01/2025`
* **Japan:** `YYYY/MM/DD` → `2025/01/25`
***
## 5. Currency and Symbols
* **US:** `$1,234.56`
* **Germany:** `1.234,56 €`
* **UK:** `£1,234.56`
***
## 6. Sorting and Collation
* **English:** Sorts alphabetically (A–Z).
* **Other locales:** Accents/diacritics impact order (e.g., `ä`, `ö`, `ß` in German).
***
## 7. Google Sheets vs Excel
* Google Sheets mirrors **Excel regionalization**.
* Unlike Excel, you can **easily change locale in settings** to standardize behavior.
***
# 🔑 Why These Differences Exist
1. **Excel compatibility**
2. **Cultural conventions** (dates, numbers, language)
3. **Avoiding ambiguity** (commas for decimals vs separators)
***
# ✅ Best Practices for Teams
* **Set a common locale** in shared sheets.
* **Use ISO date format (`YYYY-MM-DD`)**.
* **Document formula conventions** for templates.
* **Be careful when copy-pasting formulas** across regions.
***
# 🔄 Migration Tips for Cross-Regional Collaboration
When collaborating internationally, you may need to **convert formulas** between regional formats. Here are practical strategies:
### 1. Switch Locale in Google Sheets
* Go to **File → Settings → Locale**.
* Change to a common locale (e.g., “United States”) for consistent formula structure.
* This updates formula separators, date formats, and currency automatically.
### 2. Find and Replace Separators
* If collaborators use different separators (`;` vs `,`):
* Use **Ctrl+H (Find & Replace)**.
* Replace `;` with `,` (or vice versa).
* Be careful not to replace commas inside numbers (e.g., `1,234.56`).
### 3. Function Translation Awareness
* When opening a sheet from another locale, function names will **auto-translate**.
* Example: A German `=SVERWEIS()` will appear as `=VLOOKUP()` in an English locale.
### 4. Use ISO-Friendly Formats
* Dates: Use `YYYY-MM-DD` (e.g., `2025-01-25`) to avoid misinterpretation.
* Numbers: Avoid thousands separators (`1,234` vs `1.234`) in formulas. Stick to raw numbers when possible.
### 5. Collaborate with Superjoin AI
* If formulas keep breaking, ask **Superjoin AI** to **auto-convert or debug** them based on your region.
* This avoids manual guesswork.
***
# 📚 References
* [Google Sheets Supported Functions (by language)](https://support.google.com/docs/table/25273?hl=en)
* [Change Google Sheets Locale & Language](https://support.google.com/docs/answer/58515?hl=en)
* [Date, number, and currency formatting](https://support.google.com/docs/answer/56470?hl=en)
***
👉 If you face any trouble with formulas, ask **Superjoin AI** – your personal Google Sheets Copilot. It understands spreadsheet structures and regional formula rules to give you the right solution.
## How to Access Superjoin AI in Google Sheets
Visit the homepage of Superjoin. Find and click the "Superjoin AI" button under the "Get Started" section.
Use Superjoin AI to get help with formulas, data manipulation, data analysis, and more—just ask in plain English!
# Where to find the history of exports done using Superjoin?
Source: https://docs.superjoin.ai/faqs/history-of-superjoin-exports
Step-by-step guide to find the history of exports done using Superjoin
Open Superjoin by clicking on the icon that is on the top right of your Google Sheets.
Click on the "Queries" button in the homepage to access the Queries tab.
Click on the Export Query that you want to see the history for.
Click on the 3 dots on the top right and select "View Export History" from the dropdown.
Congratulations! You can now see the history of exports done using Superjoin.
# Where to find the history of imports done using Superjoin?
Source: https://docs.superjoin.ai/faqs/history-of-superjoin-imports
Step-by-step guide to find the history of imports done using Superjoin
Open Superjoin by clicking on the icon that is on the top right of your Google Sheets.
Click on the "Queries" button in the homepage to access the Queries tab.
Click on the Import Query that you want to see the history for.
Click on the 3 dots on the top right and select "Import Timeline" from the dropdown.
Congratulations! You can now see the history of imports done using Superjoin.
# Where to find the history of Workflow runs using Superjoin?
Source: https://docs.superjoin.ai/faqs/history-of-superjoin-workflow-runs
Step-by-step guide to find the history of Workflow runs using Superjoin
Open Superjoin by clicking on the icon that is on the top right of your Google Sheets.
Click on the "Workflows" button in the homepage to access the Workflows tab.
Click on the 3 dots next to the Workflow that you want to see the history for.
Select "Timeline" from the dropdown.
Congratulations! You can now see the history of Workflow runs using Superjoin.
# How Do Superjoin Import Sheets Work?
Source: https://docs.superjoin.ai/faqs/how-superjoin-import-sheets-work
Understanding Superjoin import sheets - best practices for editing, overwriting, and managing protected areas safely
## How Do Superjoin Import Sheets Work?
This FAQ explains how Superjoin import sheets operate, including best practices for editing, overwriting, and understanding protected areas—so you can manage your spreadsheet data safely and efficiently.
**Quick answer:** A Superjoin import sheet is a managed Google Sheet with strict control over editable areas. Understanding these rules prevents data loss and sync issues.
***
## What is a Superjoin import sheet?
A Superjoin import sheet is a Google Sheet managed by Superjoin, serving as a live interface to your connected data source (like HubSpot or Stripe).
It enables bulk imports, updates, and synchronization with your database or app while maintaining strict control over which areas are editable.
***
## Which areas of the sheet can I edit?
You should only edit data up to the last filled column—meaning, all columns that Superjoin controls up to the current furthest non-empty column.
Any columns beyond this point are not managed by Superjoin and should not be used for critical data. Best practice is to avoid using extra columns beyond the last filled one.
Superjoin highlights its controlled columns. Data outside these columns is not synced or protected.
***
## What happens if I change data inside Superjoin-controlled columns?
Any edits made to values or headers within Superjoin-managed columns will be overwritten the next time the sheet is refreshed or imported.
This includes all changes to column A and any column up to the last filled one. For example, if your update mode is set to "Replace", Superjoin will overwrite everything in these columns with data from your source.
When using replace mode, any manual changes in these columns will be lost on the next update.
Avoid overwriting values you intend to keep within these columns when your sheet uses "Replace" mode.
***
## Can I change the column headers?
**Do not modify any of the Superjoin-generated column headers.** These headers allow Superjoin to map data accurately.
Changing them may cause data sync errors.
***
## Can I rearrange columns in the sheet?
Yes, you can rearrange the order of columns on your import sheet. Superjoin automatically detects column reordering and will update the underlying import mapping to match the new order.
This ensures your data syncs correctly without manual remapping.
Superjoin recognizes and adapts to column order changes—no manual remapping is necessary.
***
## What about the first and second rows of the sheet?
**You should never remove the first or second row from your Superjoin import sheet.** Superjoin writes data starting from the third row and relies on these two initial rows for consistent column identification.
Superjoin always overwrites the first two rows—removal can break import functionality.
***
## Summary & Best Practices
* Feel free to reorder columns; Superjoin adapts to new positions
* Edit data within controlled columns knowing it will be overwritten
* Keep the first two rows intact at all times
* Don't edit or use columns beyond the last controlled column
* Never change Superjoin-generated headers
* Don't remove the first two rows—Superjoin requires them
### Key Rules to Remember
* **All edits to data in controlled columns will be overwritten on sync or replace**
* **Never change Superjoin-generated headers**
* **Do not remove the first two rows—Superjoin requires them to function**
**Critical:** Violating these guidelines can result in data loss or sync problems. Always double-check before making structural changes!
***
## What should I do next?
Now that you know how to safely work with Superjoin import sheets, you can confidently bulk-edit and manage syncs between Google Sheets and your live data sources.
Explore Superjoin's features for data analysis and visualization to further leverage your time and reduce manual spreadsheet work.
***
**Need help with import sheets?** Contact Superjoin support with details about your specific use case so they can assist you with the best approach.
# How to add teammates to Superjoin?
Source: https://docs.superjoin.ai/faqs/how-to-add-teammates-to-superjoin
Step-by-step guide to add teammates to Superjoin
Below are the instructions to buy paid licenses for your teammates. If they'd like to buy licenses themselves, they can do so by following [these steps](/faqs/how-to-purchase-superjoin-paid-plans). You can understand Superjoin's team sharing features in detail [here](/features/org-sharing).
Open Superjoin by clicking on the icon that is on the top right of your Google Sheets.
Click the purple button on the top of the screen that shows your current plan and click on "Manage Subscription" button.
Click the "Update subscription" button on the top right of the screen.
Click on the + button next to the desired plan and set the number to be as many members that you are purchasing superjoin for; then click on "Continue".
Ask your teammates to install Superjoin on their Google Sheets and launch it once.
Once you have purchased additional seats, reach out to Superjoin Support via [support@superjoin.ai](mailto:support@superjoin.ai) and provide them with the email addresses of the teammates you want to add to your Superjoin account. We will activate your teammates' paid licenses promptly.
Congratulations! You have successfully added teammates to your Superjoin account and can now collaborate effectively.
# How to purchase Superjoin Add-Ons?
Source: https://docs.superjoin.ai/faqs/how-to-buy-add-ons
Step-by-step guide on how to purchase Superjoin Add-Ons
Interested in purchasing add-ons for additional integrations or planning to get a refresh-only license for your teammates?
Write to us at [support@superjoin.ai](mailto:support@superjoin.ai) with the following details:
* Your email address associated with Superjoin
* The add-on(s) you wish to purchase
Our team will get back to you with the payment process and promptly activate the add-ons in your account.
# How to Filter Import Queries in Superjoin?
Source: https://docs.superjoin.ai/faqs/how-to-filter-import-queries-superjoin
Complete guide to filtering data imports in Superjoin - learn to create, configure, and apply filters for clean and relevant data
## How to Filter Import Queries in Superjoin
Superjoin lets you filter your data imports before bringing them into Google Sheets, so you only import the data that matters. This powerful feature allows you to create sophisticated filter queries that ensure your spreadsheets remain clean, focused, and performant.
Whether you're importing contacts, deals, transactions, or any other data, filters help you eliminate unnecessary information and focus on the records that drive your business decisions.
**Quick tip:** Use filters to import only the data you need, reducing clutter and improving spreadsheet performance. Filtered imports also refresh faster and consume less API quota.
***
## Before You Begin
Before setting up filters, make sure you have:
* **Superjoin installed** - Set up the Superjoin add-on in Google Sheets
* **Data source connected** - Connect to your data source (like HubSpot, Salesforce, Stripe, or others)
* **Fields selected** - Choose which fields you want to import from your data source
**Important:** Filters work on your primary object only. If you've associated secondary objects, you can only filter based on properties from your primary object. For more details about filtering limitations, see our FAQ on filter options.
Remember that the data preview shows only the first 100 rows. After applying filters, you may see an empty preview even if your filtered data exists—this just means the matching records aren't in the first 100 rows. Always click **Import** to see your complete filtered results.
***
## How to Set Up Filters
Open Superjoin in Google Sheets and select your connected data source. The data preview screen will display a sample of your incoming data, showing you the available fields and a snapshot of your records.
This preview helps you understand your data structure before you apply filters. Take a moment to review the fields available for filtering.
The data preview interface displaying your source data with all available fields
Click the **Filter** button to open the filter configuration interface. This is where you'll build your filter query using a user-friendly visual interface.
The filter builder allows you to create both simple and complex filter conditions without writing any code or learning query syntax.
The Filter button in the Superjoin data preview interface
Choose a field you want to filter on (for example, **Create date**), then select the appropriate filter condition (such as **is known**, **equals**, **contains**, **greater than**, etc.).
The available filter conditions depend on the field type you select. Date fields offer date-specific operators, text fields provide string matching options, and numeric fields include comparison operators.
Opening the field selector to choose which property to filter
Selecting the **Create date** field from the available field list
Choosing the filter operator - in this example, **is known** (which filters for records that have a value in this field)
Confirming the selected filter condition before applying
**Common filter operators:**
* **is known/unknown** - Check if a field has a value or is empty
* **equals/not equals** - Exact match for specific values
* **contains/doesn't contain** - Search within text fields
* **greater than/less than** - Compare numbers or dates
Click the **Apply** button to see how your filter affects the data preview. The preview will update to show only records matching your filter criteria.
This lets you verify that your filter is working as expected before importing the full dataset.
Click the **Apply** button to preview your filtered results
If the preview appears empty after applying a filter, don't worry! The preview only shows the first 100 rows from your source. Your filtered data may exist beyond those first 100 rows and will appear when you complete the import.
To further narrow your data and make your filter more specific, click **Add Filter** to include more criteria in the same filter group. When multiple filters are in the same group, **all conditions must be met** for a record to be included (AND logic).
This is perfect for scenarios like "Import all contacts created this year AND with lead status" where both conditions must be true.
Click **Add Filter** to add more criteria to your current filter group
A new filter row appears in the same group
Set the new filter condition (for example, **Life cycle stage equals lead**) to create a more specific filter combination.
Selecting **Life cycle stage** field and the **equals** operator
Choosing the value **lead** from the dropdown options
Click **Apply** to preview all filters working together with AND logic. Now only records that match both the create date condition AND the lifecycle stage condition will be included.
The combined filter is now active - records must match ALL conditions in this group
**AND Logic explained:** All conditions in the same filter group must be satisfied for a record to be included. Think of it as narrowing down your results - each additional filter makes your criteria more specific.
**Example:** Create date is known AND Lifecycle stage equals lead = Only leads with creation dates
If you want your import to match either one set of conditions or another (OR logic), click **Add Filter Group** to create a separate group of conditions. Records matching **any filter group** will be included in your import.
This is useful for scenarios like "Import contacts that are leads OR contacts created this month" where meeting either condition is sufficient.
Click **Add Filter Group** to create an alternative set of conditions (OR logic)
**OR Logic explained:** Data matching any filter group will be included in your import. This broadens your results compared to AND logic.
**Example:** (Create date > Jan 1, 2024 AND Status = Lead) OR (Last modified > March 1, 2024) = Leads created after Jan 1st OR any record modified after March 1st
You can combine AND and OR logic to create sophisticated filters: Each group uses AND logic internally, while multiple groups are joined with OR logic. This gives you maximum flexibility in defining your import criteria.
Once you're satisfied with your filtered results and have verified the preview (when possible), click **Update** or **Import** to bring only the filtered data into your Google Sheets.
Your import will now respect all the filter conditions you've configured, ensuring only relevant data is imported and kept up-to-date on future refreshes.
Click the **Update** button to import your filtered dataset into Google Sheets
Your filter configuration is saved with your import. Every time you refresh this import, the same filters will be automatically applied, ensuring you always get the most current data matching your criteria.
***
## Understanding Filter Logic
Mastering filter logic helps you create precisely targeted imports that include exactly the data you need.
Use **Add Filter** within the same group when **all conditions must be met** simultaneously.
**When to use:** Narrowing down results with multiple requirements
**Example scenarios:**
* Contacts created after Jan 1, 2024 AND with email addresses
* Deals with amount > \$10,000 AND stage = "Qualified"
* Orders from Q1 AND with status = "Completed"
Use **Add Filter Group** when you want to match **any of multiple condition sets**.
**When to use:** Broadening results to include records matching different criteria
**Example scenarios:**
* Contacts that are leads OR customers
* Tickets created this week OR with high priority
* Deals closing this quarter OR already closed-won
### Complex Filter Examples
**Goal:** Import leads created in the last 30 days with estimated value over \$5,000
**Filter setup:**
* Group 1:
* Create date > \[30 days ago]
* AND Lifecycle stage = "Lead"
* AND Amount > 5000
**Goal:** Import active contacts from either New York or California
**Filter setup:**
* Group 1: City = "New York" AND Status = "Active"
* OR Group 2: State = "California" AND Status = "Active"
**Goal:** Import deals that are either in negotiation OR closing this month
**Filter setup:**
* Group 1: Stage = "Negotiation"
* OR Group 2: Close date > \[First of this month] AND Close date \< \[Last of this month]
***
## Common Filter Conditions Explained
Includes records where the field has any value (not empty or null)
Includes records where the field is empty or null
Exact match - field must exactly equal the specified value
Excludes records where field exactly equals the specified value
Text fields - includes records where field contains the specified text
Numeric and date comparisons - includes records above or below a threshold
***
## Best Practices & Tips
Begin with a simple filter to ensure you're getting results, then add more conditions to refine. This helps you avoid creating overly restrictive filters that exclude important data.
Always click **Apply** to preview your filter results before importing. While the preview is limited, it helps you verify your filter logic is working correctly.
The "is known" and "is unknown" operators are powerful for data quality. Use "is known" to import only complete records, or "is unknown" to identify records that need updating.
For sophisticated filters with multiple groups, document your filter logic in your spreadsheet or team wiki so others understand what data is included and why.
### Performance Tips
**Optimize your filters for speed:**
* Use date ranges to limit historical data imports
* Filter out inactive or archived records
* Exclude fields you don't need from the import
* Consider separate imports for different time periods rather than one massive import
***
## Troubleshooting Common Issues
### Empty Preview After Filtering
**Don't panic if your preview appears empty!** The preview only shows the first 100 rows from your source. If your filtered results aren't in those first 100 rows, the preview will be blank, but your data will still import correctly.
**Solution:** Always click Import/Update to see your complete filtered results in the spreadsheet.
### Filter Not Working as Expected
If your filter doesn't seem to work correctly:
1. **Check your filter logic** - Verify you're using AND vs OR correctly
2. **Review field types** - Ensure you're using appropriate operators for each field type
3. **Test individual conditions** - Remove all but one filter to test each condition separately
4. **Check data source** - Verify the data exists in your source system
### Too Much or Too Little Data
If you're getting more or fewer records than expected:
* **Too much data:** Add more specific filters with AND logic to narrow results
* **Too few records:** Check if filters are too restrictive; try OR logic or remove some conditions
* **Verify in source system:** Check your data source directly to confirm the data exists
***
## Summary & Next Steps
By filtering your import queries in Superjoin, you keep your spreadsheets focused and relevant—importing only the data you need, organized and ready for analysis or automation.
**Key benefits of filtered imports:**
* ✅ Faster refresh times and better spreadsheet performance
* ✅ Reduced API usage and lower rate limit concerns
* ✅ Cleaner, more focused datasets for analysis
* ✅ Automatic filtering on every refresh keeps data current
**Pro tip:** Combine AND and OR logic to create complex filters that precisely match your data requirements. Start simple and add complexity as needed. Remember that you can always modify your filters later by editing the import configuration.
### What to Do Next
Now that you've mastered filtering:
1. **Set up auto-refresh** - Configure your filtered imports to refresh automatically
2. **Explore derived columns** - Add calculations and transformations to your imported data
3. **Share with your team** - Use Superjoin's sharing features to distribute filtered data to colleagues
4. **Create multiple views** - Set up different imports with different filters for various use cases
***
**Need help with filters?** Contact Superjoin support with details about your filtering requirements and they can assist you with the best setup approach. Include screenshots of your filter configuration for faster assistance.
# How to purchase Superjoin Paid Plans?
Source: https://docs.superjoin.ai/faqs/how-to-purchase-superjoin-paid-plans
Step-by-step guide on how to purchase Superjoin Paid Plans
Open Superjoin by clicking on the icon that is on the top right of your Google Sheets.
Browse through the available paid plans and select the one that best suits your needs by clicking on the "Buy Now" button below the desired plan.
Fill in your payment details and complete the purchase process.
Congratulations! You have successfully purchased a Superjoin Paid Plan and can now enjoy its benefits.
# How to remove teammates from Superjoin?
Source: https://docs.superjoin.ai/faqs/how-to-remove-teammates-from-superjoin
Step-by-step guide to remove teammates from Superjoin
Below are the instructions to cancel paid licenses for your teammates if you are handling them. If they handle their own licenses, they can do so by following [these steps](/faqs/cancel-superjoin-subscription).
Open Superjoin by clicking on the icon that is on the top right of your Google Sheets.
Click the purple button on the top of the screen that shows your current plan and click on "Manage Subscription" button.
Click the "Update subscription" button on the top right of the screen.
Click on the - (minus) button next to your plan to remove the seats for your teammates.
Once you have removed the seat(s), reach out to Superjoin Support via [support@superjoin.ai](mailto:support@superjoin.ai) and provide them with the email addresses of the teammates you want to remove from Superjoin. We will deactivate your teammates' licenses promptly.
Congratulations! You have successfully removed teammates to your Superjoin account and can now collaborate effectively.
# How to Sort Imported Data in Superjoin?
Source: https://docs.superjoin.ai/faqs/how-to-sort-imported-data-superjoin
Step-by-step guide to customize the sort order of your imported data in Google Sheets using Superjoin
## How do I sort imported data in Superjoin?
Superjoin makes it easy to control the order of your imported data directly within Google Sheets. This feature is especially helpful when you need your rows organized by creation date, last update, or any other field that matters most for your workflow. Whether you're managing new leads, syncing updates, or preparing data for reporting, sorting data on import helps keep everything organized and actionable.
**Quick answer:** You can customize the sort order of your records from the Data Preview interface by selecting a sort field (like Created At or Last Modified At) and choosing ascending or descending order.
***
## What You'll Achieve
You'll learn how to customize the sort order of your records—such as contacts—from HubSpot (or other connected data sources) using Superjoin's import interface. This ensures you always see data in the order that's most relevant to your needs.
Sorting is available for all data objects including Contacts, Companies, Deals, and any other supported objects from your connected data sources.
***
## How to Sort Your Imported Data
When you import data using Superjoin, you'll land in the **Data Preview** section. By default, Superjoin sorts your records by `record ID`. This is a unique number assigned to each record by HubSpot to help you identify individual rows.
The Data Preview panel automatically displays imported records, initially sorted by record ID.
Sorting by record ID may not always match how you want to review or process your data.
If you'd like to change the sort order, head to the sorting options within the preview panel. For example, if you want the most recently created contacts at the top of your sheet:
* Find the sort controls (usually above your data preview)
* Select the **sort by** field
Click the sort field dropdown to select another sorting option.
From the dropdown, choose a field such as **Created At**. This will allow you to sort your data based on when each record was added.
The sort by options include Created At, record ID, and Last Modified At — pick what best matches your workflow.
Next, set the direction for your sort:
* **Ascending** places older records or earliest created contacts first (top to bottom)
* **Descending** puts the newest contacts or latest records at the top
Select ascending or descending—descending shows your latest records first.
Once you select your sort criteria and direction, Superjoin instantly updates your data preview to reflect your choice, ensuring you see exactly what will be imported.
You're not limited to just creation date or record ID—you can also sort by **Last Modified At** if you need to review the most recently updated records first.
* Pick **Last Modified At** from the sort dropdown
* Select your preferred order
Sort options—like Last Modified At—help you focus on recently updated records.
Once applied, your preview updates once again:
Preview updates to reflect sorting by the chosen field, helping ensure the right data appears in your Sheet.
You can repeat these steps for any object (such as Contacts, Companies, or Deals) Superjoin supports:
Sorting is available for all data objects—just choose your field and order.
Customizing sort order helps support downstream workflows. For instance, if you want new contacts to always appear at the bottom of your sheet (useful for data entry or automated processes):
* Set the sort field to **Created At**
* Choose **Ascending** order (oldest at the top, newest at the bottom)
Sorting by Created At in Ascending order ensures new rows are always at the bottom.
Your preview now mirrors how you want your Sheet to look, with sorted rows ready for import into Google Sheets.
**Workflow tip:** Ascending order is ideal when you have automations or formulas at the bottom of your sheet that process new data as it arrives.
***
## Common Sorting Options
Sort by when records were first created. Perfect for tracking new leads or entries chronologically.
Sort by the most recent updates. Ideal for monitoring changes and recent activity.
Sort by unique record identifiers. Useful for maintaining consistent record order across refreshes.
***
## Summary & Next Steps
Congratulations! You've customized the sort order for your imports in Superjoin. Now, your contacts, deals, or any data synced from HubSpot and other tools will be structured exactly how you want them in Sheets. This is ideal for reporting, workflow automation, or simply making your data easier to work with.
**Pro tip:** Your sort configuration is saved with your import and will be applied automatically every time the data refreshes, ensuring consistent order across all updates.
### What to Explore Next
* **Filtering** - Combine sorting with filters to get precisely the data you need in the right order
* **Field Mapping** - Customize which fields are imported and how they're labeled
* **Live Sync** - Set up automatic refreshes to keep your sorted data always up-to-date
***
**Need help with sorting?** Contact Superjoin support with details about your specific sorting requirements and they can assist you with the best configuration.
# My import limits are exhausted. What to do?
Source: https://docs.superjoin.ai/faqs/import-limits-exhausted
Steps to take when your Superjoin import limits are exhausted
If you have exhausted your Superjoin import limits (data refreshes or number of rows), you have to buy a higher plan to continue using Superjoin for your data imports or wait till the next month cycle for your limits to reset.
Explore our [pricing plans](https://www.superjoin.ai/pricing) to find the one that best suits your needs.
# How to increase the trial period for Superjoin?
Source: https://docs.superjoin.ai/faqs/increase-trial-period
Step-by-step guide on how to increase the trial period for Superjoin
If you need more time to evaluate Superjoin before committing to a subscription, we offer the option to extend your trial period. To request an extension of your trial period, write to us at [support@superjoin.ai](mailto:support@superjoin.ai) with a detailed desscription of your use case and why you need additional time to evaluate Superjoin.
Our team will review your request and get back to you with the possibility of extending your trial period. Please note that trial extensions are granted on a case-by-case basis and are subject to approval by our customer success team.
# How to retrieve Record IDs manually
Source: https://docs.superjoin.ai/faqs/manually-import-record-ids
Step-by-step guide for manually retrieving Record IDs to precisely map the field so that the data can be exported back to HubSpot
##### If your preferred workflow requires getting the IDs manually from HubSpot, here’s how you can do it:
Go to the `Object` in HubSpot and tweak the `Advanced filters` in order to view the exact data you’ve been working with on Google Sheets so that you retrieve the accurate Record IDs.
Click on `Export` and download the data in a CSV file.
Click on `File` --> `Import` and then browse for the CSV file to import it in a new sheet.
Perform a `VLOOKUP` on the new sheet to accurately find the Record IDs assigned to each record.
```
=VLOOKUP(record-to-search-for,'imported-csv-sheet'!range-of-search,column-number-of-record-IDs)
```
Now use the drag down feature for the `VLOOKUP` to be applied for all records.
Map the Google Sheet's Record ID field to the HubSpot's Record ID field on Superjoin. Click on `Save` and then follow the rest of the steps on the `Export Data` page for exporting data back to Hubspot.
##### Hope this guide helped you manually retrieve Record IDs from HubSpot to Google Sheets.
##### If you have any questions or need further assistance, please don’t hesitate to reach out to our support team. Thank you!
# Missing Data in Superjoin Preview
Source: https://docs.superjoin.ai/faqs/missing-data-superjoin-preview
Troubleshooting guide for incomplete data previews in Superjoin - learn how to import your full dataset correctly
## A lot of data is missing in the Superjoin preview. What do I do?
If you notice missing data in the Superjoin preview, follow these steps to ensure your full dataset is imported correctly. This FAQ guides you through preview limitations, importing all your data, and troubleshooting filtered or blank previews.
**Quick fix:** The preview only shows 100 rows by design. Click the **Import** button to get your complete dataset.
***
## Why is my data preview incomplete?
**Superjoin intentionally limits the data preview to 50 rows.** The preview is designed for a quick snapshot—not to show your entire dataset.
This limitation exists for performance reasons and to keep the preview loading fast. Don't worry—your complete data is still available for import.
**Image needed:** Screenshot showing the data preview section with 100 rows limit in Superjoin interface.
***
## How do I get all of my data into Google Sheets?
Look for the **Import** button in the Superjoin sidebar or preview area.
Click the **Import** button to load your full dataset into Google Sheets.
All eligible data (not just the previewed sample) will be imported to your sheet.
The import process typically takes a few moments depending on your data size. You'll see a progress indicator during the import.
***
## What if the preview shows nothing after I apply a filter?
**Don't panic if your preview appears empty after filtering!** This is a common scenario and doesn't mean your data is missing.
### Why does this happen?
The preview filter only applies to the first 100 rows. If your filtered values aren't in those initial rows, the preview will appear blank. However, **this does NOT mean your filtered data is missing!**
**Image needed:** Screenshot showing empty preview after applying filter when matching data isn't in the first 100 rows.
***
## How can I confirm my data after importing?
Click the **Import** button to bring in your complete dataset.
Navigate to your Google Sheet and review the imported data.
Often, records that were missing from the preview (because of the 100-row limit or filter location) now appear correctly in your sheet.
**Expected result:** Your complete dataset, including filtered values, should now be visible in your Google Sheet.
**Image needed:** Screenshot showing the full dataset after import, including filtered values appearing in the Google Sheet.
***
## Summary & Best Practices
* Always click **Import** to get your complete dataset
* Check your actual Google Sheet after import, not just the preview
* Remember that previews are limited to 100 rows for performance
* Don't panic if filtered previews appear empty
* Don't rely solely on the preview for data validation
* Don't assume missing data if the preview is incomplete
### Troubleshooting Steps
If you still can't find your data after import:
1. **Review your data source** - Ensure the source has the data you expect
2. **Check your filters** - Verify filter settings aren't too restrictive
3. **Adjust connection settings** - Try different field selections or date ranges
4. **Re-import** - Sometimes a fresh import resolves sync issues
***
**Still missing data after import?** Contact Superjoin support with details and screenshots so they can assist you further.
# How to Upgrade or Downgrade your paid Superjoin Plan?
Source: https://docs.superjoin.ai/faqs/paid-plan-upgrade-downgrade
Step-by-step guide on how to upgrade or downgrade your paid Superjoin Plan
Open Superjoin by clicking on the icon that is on the top right of your Google Sheets.
Click the purple button on the top of the screen that shows your current plan and click on "Manage Subscription" button.
Click the "Update subscription" button on the top right of the screen.
Choose the desired plan you want to upgrade or downgrade to by clicking on the + button next to the plan card then click on "Continue".
Congratulations! You have successfully upgraded or downgraded your Superjoin Plan and can now enjoy its benefits.
# What does Record ID mean and why is it needed for Exports?
Source: https://docs.superjoin.ai/faqs/record-id-superjoin-exports-importance
Understanding Record ID in Superjoin Exports and its importance to data synchronization and hygiene.
Out of the 6 different export actions that Superjoin offers, 5 of them require **Record IDs** to function properly. These are Update, Upsert, Associate, Dissociate and Delete. The only action that does not require Record IDs is Insert as the Insert action creates new Record IDs.
## What is a Record ID?
A Record ID is a unique identifier for each record in your Source. It is used by Superjoin to identify and locate the specific record that you want to update, upsert, associate, dissociate or delete. The Record ID is usually a combination of numbers (or a string of numbers and letters) that is unique to each record.
For example, in HubSpot, the Record ID for a contact might look like this: `123456789`. In Salesforce, the Record ID for an account might look like this: `0011A00000XXXXXX`.
## Why is Record ID important?
Superjoin uses these IDs to identify which records in your Source need to be updated, associated, dissociated or deleted based on the data in your Google Sheets. Without the Record ID, Superjoin would not be able to determine which records to modify, leading to potential data mismatches or errors.
For example, if you want to update a contact's email address in HubSpot, Superjoin needs the Record ID of that contact to ensure that the correct record is updated. If the Record ID is missing or incorrect, Superjoin may not be able to find the right contact, and the update will fail.
So its always best practice to Import the data you want to modify along with their Record IDs from your Source to Google Sheets first, so that you have the Record IDs for all the records that you want to modify. This will ensure that your Exports are accurate and that your data remains clean and consistent.
## How to get Record IDs?
You can perform an Import from your Source (HubSpot or Salesforce) to Google Sheets using Superjoin, and select the Record IDs as one of the fields you want to bring in.
# I want to get a refund for my Superjoin subscription cancellation
Source: https://docs.superjoin.ai/faqs/refund-policy
Refund Policy for Superjoin subscription cancellations
At Superjoin, we strive to provide the best service possible. However, we understand that there may be instances where you may need to cancel your subscription and request a refund.
According to our [refund policy](https://www.superjoin.ai/legal/refund-and-cancellation), Superjoin offers a 3-day money-back guarantee for all new subscriptions. If you cancel your subscription within 3 days of your initial purchase or within 3 days of your latest billing date, you are eligible for a full refund. To request a refund, please contact our support team at [support@superjoin.ai](mailto:support@superjoin.ai) with your email that's associated with the subscription and reason for cancellation.
# How to Renew Superjoin Subscription?
Source: https://docs.superjoin.ai/faqs/renew-superjoin-subscription
Step-by-step guide to renew your Superjoin Subscription
Open Superjoin by clicking on the icon that is on the top right of your Google Sheets.
Click the purple button on the top of the screen that shows your current plan and click on "Manage Subscription" button.
In the Account Management Dashboard, click on the "Don't Cancel Subscription" button on the top right of the screen.
Click the "Renew Subscription" button in the confirmation page to finalize the renewal.
Congratulations! You have successfully renewed your Superjoin subscription. Your subscription will continue to follow the same billing cycle as before.
# How Many Users Can Use One Subscription?
Source: https://docs.superjoin.ai/faqs/superjoin-subscription-user-limit
Understanding Superjoin's per-user licensing model and subscription sharing policies
## How many users can use 1 subscription?
Superjoin uses a per-user (or per-editor) licensing model.
This means:
* **One subscription is intended for one user.** Only that user can set up or manage data imports or exports.
* A single subscription is linked to a single Google account or Google Workspace account.
* If more than one person on your team needs to set up or edit imports/exports, each must have their own individual subscription.
Superjoin's pricing structure showing the per-user or per-editor model.
***
## What if I want to bring my team in?
If you want to enable multiple team members to work with Superjoin, here's what you need to know:
Each person who uses Superjoin beyond the free limits needs their own license—even if they're only refreshing data.
### Licensing for Different Use Cases
**Full access for creators and editors:**
* Team members who set up imports, create connections, or manage data configurations need a full Pro subscription
**Refresh-only team members:**
* If you have team members who only need to refresh existing imports (not create or modify them), they still need a license to exceed free tier limits
* However, Superjoin offers **refresh-only licenses at \$25/month/user** when you purchase 3 or more Pro licenses
**Cost-effective team setup:** Purchase Pro subscriptions for your power users who configure imports, then add refresh-only licenses at \$25/mo/user for team members who just need to keep data up-to-date.
### Example Team Scenarios
**3 Pro licenses + 2 refresh-only**
Perfect for teams with a few data admins and additional users who need fresh data.
**5+ Pro licenses + multiple refresh-only**
Ideal for organizations where many people need access but only some configure imports.
**Important:** The refresh-only license option (\$25/mo/user) is only available when purchasing 3 or more Pro licenses. Contact Superjoin sales to set up team licensing.
***
## Summary
One Superjoin subscription cannot be shared between multiple users. Each user (or editor) requires a separate subscription.
**Need multiple users?** Consider purchasing individual subscriptions for each team member who needs to set up or manage data imports and exports.
# How to Update Payment Method for Superjoin subscription?
Source: https://docs.superjoin.ai/faqs/update-payment-method
Step-by-step guide to update payment method for your Superjoin subscription
Open Superjoin by clicking on the icon that is on the top right of your Google Sheets.
Click the purple button on the top of the screen that shows your current plan and click on "Manage Subscription" button.
In the Account Management Dashboard, click on the "Add Payment Method" button as shown below.
Enter your new payment details in the provided fields and click on the "Add" button.
Select the newly added payment method as your default payment method for future billing. Once selected, you can remove the old payment method if desired.
Congratulations! You have successfully updated your payment method for your Superjoin subscription.
# How to view Past Invoices?
Source: https://docs.superjoin.ai/faqs/view-past-invoices
Step-by-step guide to view Past Invoices of your Superjoin Subscription
Open Superjoin by clicking on the icon that is on the top right of your Google Sheets.
Click the purple button on the top of the screen that shows your current plan and click on "Manage Subscription" button.
In the Account Management Dashboard, scroll down to the "Past Invoices" section and click on the invoice you want to view.
You can download the invoice as a PDF, download the receipt or view the invoice in your browser by clicking on the respective buttons.
Congratulations! You have successfully viewed your past invoice for your Superjoin subscription.
# HubSpot Glossary
Source: https://docs.superjoin.ai/glossary/hubspot-terms-in-superjoin
This is the explanation of HubSpot terms used in Superjoin
## Undertanding HubSpot's Data Model
The main components of the HubSpot data model are:
**Objects**: represent your customers and business process information. They're grouped into categories: foundational, sales, marketing, and service. Several objects belong in multiple categories (e.g., services), while others are unique and fit into all depending on your use case.
**Properties a.k.a Fields**: the different fields where you can store information on a record. There are default properties included in your account for each object. For most objects, you can also create custom properties to reflect your business needs.
**Records**: single instances of an object, where you can store information in properties, track interactions, and view associations.
**Associations**: relationships between records. Associations are always two-way (i.e., if record A is associated with record B, record B is also associated with record A). You can associate records of different objects (e.g., companies and deals) or same objects (e.g., contacts and contacts). You can have multiple associations between two records (e.g., a contact can be associated with multiple deals).
**Primary Associations**: In HubSpot, a primary association is the main record that another record is linked to, most commonly a primary company for a contact or deal. For example, if a contact works at multiple companies, the primary company is the main one they're associated with, and you can manually set or automatically assign this label. This designation is used in HubSpot tools like lists and workflows to identify the principal relationship.
If you're new to HubSpot or want to learn more about HubSpot's data model, refer to [HubSpot's official documentation](https://knowledge.hubspot.com/records/understand-objects).
## Superjoin's Representation of HubSpot's Data Model
Here is the visual representation of HubSpot's data model in Superjoin when importing data from HubSpot to Google Sheets.
Here is the visual representation of HubSpot's data model in Superjoin when exporting data from Google Sheets to HubSpot.
# Superjoin Glossary
Source: https://docs.superjoin.ai/glossary/superjoin-terminology-glossary
Your complete reference guide to Superjoin terminology and concepts
**Quick Navigation:** Use the sections below to jump to specific categories, or use `Ctrl/Cmd + F` to search for any term.
Welcome to the Superjoin Glossary! This comprehensive guide helps you understand key terms and concepts used throughout Superjoin. Whether you're new to the platform or need a quick reference, you'll find clear, contextual definitions for every important term.
***
## 🔗 Core Concepts
**These terms are used interchangeably** throughout Superjoin documentation.
These refer to the established links between your Google Sheets or Microsoft Excel and your data sources. This includes:
HubSpot, Salesforce, Stripe, Chargebee, Intercom, and more
PostgreSQL, MySQL, MongoDB, Snowflake, BigQuery, Redshift
Google Ads, Facebook Ads, LinkedIn Ads, Mailchimp
Connect to any REST API with our Custom API connector
**What they do:** Connections enable the seamless flow of data directly into your spreadsheets, allowing you to access and analyze up-to-date information without leaving your spreadsheet environment. The Data Connectors feature works alongside the AI Assistant as one of Superjoin's two core feature sets.
***
## 📊 Data Operations
The process of **pulling data** from external sources (SaaS platforms, databases, APIs) into Google Sheets or Microsoft Excel.
**What you can import:**
* Sales figures and revenue data
* Customer information and contact lists
* Financial metrics and transactions
* Marketing campaign performance
* Support tickets and conversations
* And much more from 40+ integrations
Imported data can be **automatically refreshed** on a schedule to keep your spreadsheets up-to-date without manual work.
The process of **pushing data** from your Google Sheets back to external platforms like HubSpot, Salesforce, or other integrated services.
**What you can do with exports:**
* Create new records in your CRM
* Update existing customer data
* Delete outdated information
* Associate related records
* Synchronize data between systems
Available only on Google Sheets
### 📌 General Definition
In Superjoin, a **query** refers to any configuration between a connector (data source) and your spreadsheet. This includes:
* **Import Queries** → Configurations that define what data to pull from a source into your sheets
* **Export Queries** → Configurations that define how data from your sheets should be pushed to a destination
Every import or export you create in Superjoin is essentially a **saved query** that can be refreshed, scheduled, or shared with teammates.
### 🗄️ Database-Specific Context
When working with **database sources** (PostgreSQL, MySQL, Snowflake, etc.), queries also refer to SQL queries that retrieve and manipulate data. These can be created using three methods:
Write SQL directly for complete control
Use a visual interface to build queries without writing code
Describe what you want in natural language and let AI generate the SQL
Database queries can be saved, shared with teammates, and used to create scheduled imports or flashbacks.
The action of **updating imported data** to pull the latest information from your connected source.
**Refresh methods:**
| Method | Description | Use Case |
| ---------------- | ---------------------------------- | ------------------------------------ |
| **Manual** | Click a refresh button | When you need data on-demand |
| **Scheduled** | Set up automatic refresh intervals | For regular reporting and dashboards |
| **Programmatic** | Use API or custom buttons | For advanced automation workflows |
***
## 🚀 Export Actions
Export actions define **how data flows** from your spreadsheet to external platforms. Choose the action that matches your use case.
Creates **new records** in your destination platform (e.g., HubSpot, Salesforce) from data in your spreadsheet.
* ✅ Adds new records
* ❌ Will not modify existing records
**Example:** Adding new contacts to HubSpot from a list in Google Sheets
Modifies **existing records** in your destination platform based on data in your spreadsheet.
* ✅ Updates existing records using unique identifiers
* ❌ Will not create new records
**Example:** Updating deal amounts or contact information for existing HubSpot records
A powerful combined operation that both **inserts new records** and **updates existing ones** in a single action.
Upsert uses a custom unique identifier field to determine whether to create a new record or update an existing one. Perfect when you have a mix of new and existing data!
**Example:** Syncing a contact list where some contacts exist in HubSpot and others are brand new
Removes records from your destination platform based on data in your spreadsheet.
Delete operations **permanently remove** records from the connected system. Use with caution!
**Example:** Removing outdated contacts or closed deals from your CRM
Creates **relationships between different objects** in platforms like HubSpot.
**Common associations:**
* Link a Contact to a Company
* Connect a Deal to a Contact
* Associate Tickets with Companies
* Link multiple objects together
Associations allow you to establish connections between related records without duplicating data.
Removes **existing relationships** between objects in platforms like HubSpot.
This breaks the connection between related records **without deleting the records themselves**.
**Example:** Unlinking a contact from a company when they change organizations
***
## ⚡ Automation Features
Also called **Scheduled Imports**, these terms are used interchangeably.
Automates the process of keeping your data up-to-date by **refreshing imports on a regular basis** without manual intervention. This ensures your spreadsheets always contain current information from your connected sources.
**Schedule options:**
Every 6, 8, or 12 hours
At a specific time each day
On a specific day and time each week
On a specific date and time each month
A specialized scheduling feature that creates **new static sheets** on a weekly or monthly basis.
**Key difference:** Unlike scheduled refreshes that update existing sheets, flashbacks create snapshots of your data at regular intervals, preserving historical versions.
**Use case:** Perfect for comparing data across different time periods, tracking changes over time, or maintaining historical records.
Automation sequences that execute specified actions based on triggers.
Available only on Google Sheets
### Trigger Types
Run at hourly, daily, weekly, or monthly intervals
Run when data in a selected sheet refreshes
### Available Actions
Email or send via Slack a screenshot of a specified sheet range
Automatically refresh data in a specified sheet
Workflows help automate repetitive tasks like sending weekly reports or keeping multiple data sources synchronized.
Automatically populates **formulas in columns** immediately adjacent to imported data whenever the data refreshes.
**Benefits:**
* 🚫 No more manually copying formulas after each refresh
* ⏱️ Saves time on repetitive tasks
* ✅ Reduces errors from forgotten formula updates
* 🔄 Works seamlessly with scheduled refreshes
Available only on Google Sheets
***
## 📋 Data Structure
Individual **records or entries** in your spreadsheet.
**In Superjoin context:**
* Each row typically represents a single record from your data source
* Examples: one contact, one deal, one transaction
* When exporting, you can choose to export specific rows or entire sheets
Vertical divisions in your spreadsheet that represent different **attributes or fields** of data.
**In Superjoin context:**
* Columns correspond to the fields/properties you select from your data source
* You can add, remove, or modify columns during the import preview process
* Column order can be customized to match your needs
These terms are used **interchangeably**. "Properties" is more common in CRM platforms like HubSpot and Salesforce, while "Fields" is more universal.
The individual **data attributes** available from your connected data sources.
**Examples:**
* Email address
* Company name
* Deal amount
* Created date
* Phone number
* Status
These represent specific pieces of information that you can choose to include as columns in your import or map during an export.
The main **data entities** in platforms like HubSpot, Salesforce, and other CRMs.
Contacts, Companies, Deals, Leads, Tickets
Products, Quotes, Line Items, Orders, Invoices
Calls, Emails, Meetings, Notes, Tasks
When importing or exporting, you select which object(s) you want to work with.
Custom columns created by **applying formulas to existing data** within Superjoin.
**What you can do:**
* ✨ Perform calculations without altering the original dataset
* 📊 Create custom metrics tailored to your needs
* 🔢 Combine multiple fields using mathematical, string, date, or logical functions
Currently supported for Chargebee and HubSpot integrationsAvailable only on Google Sheets
**Example:** Calculate "Days Since Last Purchase" or "Full Name" from first and last name fields
***
## 🔍 Data Filtering & Selection
Criteria applied during the import process to **refine and limit** the data pulled from your source.
**Examples:**
* Only contacts created in the last 30 days
* Deals with amount greater than \$10,000
* Customers from specific countries
* Records modified since last import
The data preview shows only the **first 100 rows**, so filtered results may not be visible in preview even if they exist. Always click "Import" to get your complete filtered dataset.
Relational connections between **different objects** in platforms like HubSpot.
**How they work:**
Associations allow you to join data from multiple objects together, enabling more comprehensive reporting by combining related data in a single import.
**Example:** Pull Contact data along with their associated Company information, Deal details, and recent Engagement history—all in one import.
A limited view (typically **100 rows**) of your data shown before importing.
**Purpose:**
* Verify your field selections
* Check filter results
* Validate associations
* Preview data structure
The preview is intentionally limited for **performance reasons**. Clicking "Import" pulls the complete dataset.
The process of **matching columns** from your spreadsheet to fields/properties in your destination platform during an export.
**Why it matters:**
Mapping ensures that data from the correct spreadsheet column goes to the correct field in the destination system.
**Example:** Mapping a "Contact Email" column in Sheets → "Email" property in HubSpot
***
## 👥 Collaboration & Sharing
A virtual grouping of users with the **same email domain** (e.g., `@company.com`).
**How it works:**
* Users in the same workspace can **see** each other's queries on shared sheets
* However, they **cannot interact** with them (refresh, edit, or export) unless the source connection is explicitly shared
👀 **Visibility ≠ Access**. Being in the same workspace only provides visibility, not permissions.
Access levels granted when sharing connections with teammates.
| Permission Level | Create/Edit | Refresh | Export | Use Case |
| ---------------------- | ----------- | ------- | ------ | ----------------------- |
| **Admin/Full** | ✅ | ✅ | ✅ | Team leads, data owners |
| **Read-Write/Limited** | ❌ | ✅ | ✅ | Regular team members |
| **Read-Only** | ❌ | ✅ | ❌ | View-only stakeholders |
Proper permission management ensures team members have appropriate access to shared data connections without over-permissioning.
The action of **granting teammates access** to your source connections or saved queries.
**Benefits:**
* 🤝 Team members can use your established connections
* 🔧 No need for everyone to set up their own connections
* 📊 Facilitates collaboration across teams
* ✅ Maintains consistency in data sources
***
## 🛠️ Additional Terms
Superjoin's **AI-powered copilot** for Google Sheets that helps with:
Transform and clean messy data with natural language
Create visualizations and reports instantly
Write and fix formulas using plain language
Generate insights from your data
The AI Assistant works alongside Data Connectors as one of Superjoin's core features.
A unique **authentication token** provided by Superjoin support that allows programmatic access to refresh data.
**What you can do with it:**
* Create custom refresh buttons in Google Sheets
* Trigger refreshes via Apps Script
* Automate data updates through API calls
* Build custom workflows outside Superjoin's UI
To obtain an API key, contact Superjoin support at [support@superjoin.ai](mailto:support@superjoin.ai)
Google's **JavaScript-based platform** for extending Google Sheets functionality.
**Used in Superjoin for:**
* Creating custom refresh buttons that anyone can click
* Building automation scripts
* Triggering data refreshes programmatically
* Extending Superjoin functionality with custom code
***
## 📚 Need More Help?
New to Superjoin? Get started in under a minute.
Learn more about how Superjoin works.
Browse 40+ available integrations.
Find answers to common questions.
**Still can't find what you're looking for?**
Contact our support team at [support@superjoin.ai](mailto:support@superjoin.ai) — we're here to help! 💙
# How to acquire Jira API token?
Source: https://docs.superjoin.ai/integrations/Jira/credentials
Proceed with the outlined steps to acquire Jira API token.
## Step-by-step walkthrough: How to obtain JIRA API token
Log in to [https://id.atlassian.com/manage-profile/security/api-tokens](https://id.atlassian.com/manage-profile/security/api-tokens).
Click Create API token.
From the dialog that appears, enter a memorable and concise Label for your token and click Create.
Click Copy to clipboard, then paste the token in the above section.
**Note:** Please note that it isn't possible to view the token after closing the creation dialog.
For more details, use JIRA Documentation: [https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/)
## Setting up Jira
Head over to the Jira overview page to get a step by step guide to connect.
# Connect your Jira to Google Sheets
Source: https://docs.superjoin.ai/integrations/Jira/overview
Easily connect your Jira to Google Sheets with Superjoin, enabling seamless data integration and automatic updates for efficient project tracking.
Please note that the Jira integration is in beta at the moment. If you face any issues, please reach out to us at [support@superjoin.ai](mailto:support@superjoin.ai)
and we will help you asap!
### Why use Superjoin’s Google Sheets-Jira Integration?
We've meticulously organized the data points to ensure easy accessibility in a format you're already familiar with.
Get a sneak peek of your data. Select columns, apply filters & limits as per your need before importing.
Enjoy one-click refreshes or schedule regular updates to ensure your sheets are always up to date.
Benefit from Google Sheets' collaborative data analysis & other powerful capabilities.
## Step-by-step walkthrough: How to connect Jira to Google Sheets.
Select `Add-ons` and choose `Get Add-ons`. This action will redirect you to the Google Workspace Marketplace.
In the Google Workspace Marketplace pop-up window, search for "Superjoin".
Click on `Extensions` from the Google Sheets menu.
**Note:** For the best experience, install Superjoin where there's only a single account is logged in the Chrome profile.
Once installed, navigate back to the `Extensions` menu tab in Google Sheets. Launch Superjoin from here. You should now see Superjoin running as a side panel on the right side of your screen.
Select Jira from the list of available data sources.
Connect your Jira account. Go through all the directions and prompts to connect your Jira account to Google Sheets.
Now select the objects from the list you want to import from.
Select the filters that you want to apply in order to filter down the data that you want to work on.
Select the items that you want to sort.
Now simply Enter the Limit of rows you want to write on Google Sheet.
Now simply click on the "import" button to bring this selected data into your Google Sheets.
Superjoin lets you refresh your imported data instantly with one click or set it to auto-refresh on a pre-set schedule. This way, you won’t need to manually update your Jira data in Google Sheets to reflect changes from the source.
# How to acquire Monday Credentials?
Source: https://docs.superjoin.ai/integrations/Monday/credentials
Proceed with the outlined steps to acquire Monday credentials.
## Step-by-step walkthrough: How to obtain Monday API token
Log into your monday.com account and click on your avatar in the top right corner
Select Developer. This will open the Developer Center in another tab.
Click `Developer` > `My Access Tokens` > `Show`
Copy your personal token. Please note that you can always regenerate a new token, but doing so will cause any previous tokens to expire.
For more details, use Monday.com Documentation: [https://developer.monday.com/api-reference/docs/authentication](https://developer.monday.com/api-reference/docs/authentication)
## Setting up Monday
Head over to the Monday Overview page to get a step by step guide to connect.
# Connect your Monday to Google Sheets
Source: https://docs.superjoin.ai/integrations/Monday/overview
Easily integrate your Monday.com data into Google Sheets for unified project tracking and visualization.
Please note that the Monday integration is in beta at the moment. If you face any issues, please reach out to us at [support@superjoin.ai](mailto:support@superjoin.ai)
and we will help you asap!
### Why use Superjoin’s Google Sheets-Monday Integration?
We've meticulously organized the data points to ensure easy accessibility in a format you're already familiar with.
Get a sneak peek of your data. Select columns, apply filters & limits as per your need before importing.
Enjoy one-click refreshes or schedule regular updates to ensure your sheets are always up to date.
Benefit from Google Sheets' collaborative data analysis & other powerful capabilities.
## Step-by-step walkthrough: How to connect Monday to Google Sheets.
Select `Add-ons` and choose `Get Add-ons`. This action will redirect you to the Google Workspace Marketplace.
In the Google Workspace Marketplace pop-up window, search for "Superjoin".
Click on `Extensions` from the Google Sheets menu.
**Note:** For the best experience, install Superjoin where there's only a single account is logged in the Chrome profile.
Once installed, navigate back to the `Extensions` menu tab in Google Sheets. Launch Superjoin from here. You should now see Superjoin running as a side panel on the right side of your screen.
Select Monday from the list of available data sources.
Connect your Monday account. Go through all the directions and prompts to connect your Monday account to Google Sheets.
Now select the objects from the list you want to import from.
Select the filters that you want to apply in order to filter down the data that you want to work on.
Select the items that you want to sort.
Now simply Enter the Limit of rows you want to write on Google Sheet.
Now simply click on the "import" button to bring this selected data into your Google Sheets.
Superjoin lets you refresh your imported data instantly with one click or set it to auto-refresh on a pre-set schedule. This way, you won’t need to manually update your Monday data in Google Sheets to reflect changes from the source.
# How to acquire Shopify API token?
Source: https://docs.superjoin.ai/integrations/Shopify/credentials
Proceed with the outlined steps to acquire Shopify API token.
## Step-by-step walkthrough: How to get Shopify API token
Log in to your Shopify account. In the dashboard, click on apps.
In the dashboard, navigate to Settings > App and sales channels.
Select a name for your new app.
Grant access to the scopes mentioned in the next step. Only select scopes prefixed with read\_, not write\_ (e.g. read\_locations,read\_price\_rules, etc ).
Add the following scopes to your custom app to ensure Superjoin can sync all available data: `read_analytics`, `read_assigned_fulfillment_orders`, `read_content`, `read_customers`, `read_discounts`, `read_draft_orders`, `read_fulfillments`, `read_gdpr_data_request`, `read_gift_cards`, `read_inventory`, `read_legal_policies`, `read_locations`, `read_locales`, `read_marketing_events`, `read_merchant_managed_fulfillment_orders`, `read_online_store_pages`, `read_order_edits`, `read_orders`, `read_price_rules`, `read_product_listings`, `read_products`, `read_publications`, `read_reports`, `read_resource_feedbacks`, `read_script_tags`, `read_shipping`, `read_shopify_payments_accounts`, `read_shopify_payments_bank_accounts`, `read_shopify_payments_disputes`, `read_shopify_payments_payouts`, `read_themes`, `read_third_party_fulfillment_orders`, `read_translations`
Click Install app to give this app access to your data. Once installed, go to API Credentials to copy the Admin API Access Token.
For more details, use shopify Documentation: [https://shopify.dev/docs/api/usage/authentication](https://shopify.dev/docs/api/usage/authentication)
## Setting up Shopify
Head over to the Shopify overview page to get a step by step guide to connect.
# Connect your Shopify to Google Sheets
Source: https://docs.superjoin.ai/integrations/Shopify/overview
Easily import your Shopify ecommerce data into Google Sheets for comprehensive sales analysis and reporting.
### Why use Superjoin’s Google Sheets-Shopify Integration?
We've meticulously organized the data points to ensure easy accessibility in a format you're already familiar with.
Get a sneak peek of your data. Select columns, apply filters & limits as per your need before importing.
Enjoy one-click refreshes or schedule regular updates to ensure your sheets are always up to date.
Benefit from Google Sheets' collaborative data analysis & other powerful capabilities.
## Step-by-step walkthrough: How to connect Shopify to Google Sheets.
Select `Add-ons` and choose `Get Add-ons`. This action will redirect you to the Google Workspace Marketplace.
In the Google Workspace Marketplace pop-up window, search for "Superjoin".
Click on `Extensions` from the Google Sheets menu.
**Note:** For the best experience, install Superjoin where there's only a single account is logged in the Chrome profile.
Once installed, navigate back to the `Extensions` menu tab in Google Sheets. Launch Superjoin from here. You should now see Superjoin running as a side panel on the right side of your screen.
Select Shopify from the list of available data sources.
Connect your Shopify account. Go through all the directions and prompts to connect your Shopify account to Google Sheets.
Now select the objects from the list you want to import from.
Select the filters that you want to apply in order to filter down the data that you want to work on.
Select the items that you want to sort.
Now simply Enter the Limit of rows you want to write on Google Sheet.
Now simply click on the "import" button to bring this selected data into your Google Sheets.
Superjoin lets you refresh your imported data instantly with one click or set it to auto-refresh on a pre-set schedule. This way, you won’t need to manually update your Shopify data in Google Sheets to reflect changes from the source.
# Authorization
Source: https://docs.superjoin.ai/superjoin-apis/authorization
## API Key Authorization
Superjoin API uses **API Key-based authorization** to ensure secure access to its endpoints. Every request to the API requires an API key, which must be included in the request header. This API key serves as your unique identifier and grants you access to the API's functionalities.
### Authorization Format
To authorize your request, you need to include the API key in the request header using the following format:
```bash theme={null}
Authorization: Api-Key
```
**Example:**
```bash theme={null}
Authorization: Api-Key abc123xyz456
```
## Obtaining Your API Key
To obtain an API key, follow these steps:
1. **Contact Support**: Email [support@superjoin.ai](mailto:support@superjoin.ai) with a request for an API key. Make sure to provide your user details and the intended use case for the API.
2. **Receive API Key**: You will receive your unique API key via email once your request is processed.
## Re-requesting an API Key
If you have lost or compromised your API key, you can request a new one. Follow these steps:
1. Email [support@superjoin.ai](mailto:support@superjoin.ai) to request a new API key.
2. **Deactivation of Previous Keys**: When you receive a new API key, all previously issued API keys will be automatically **deactivated**. Ensure that any applications or services using the old key are updated with the new one to avoid disruptions.
### Revoking API Keys
If you suspect that your API key has been compromised, contact support immediately to request a new API key and revoke all previously active keys.
Make sure to store your API key securely and only share it with trusted systems.
# Usage Limits
Source: https://docs.superjoin.ai/superjoin-apis/rate-limit
Superjoin API implements rate limiting to ensure fair usage and maintain system stability. Each user is allowed a specific number of API requests within a defined time window.
## Rate Limit Rules
To prevent excessive usage and maintain system performance, the following rate limits apply:
* **5 requests per minute**: You can make up to 5 requests within any 60-second window.
* **50 requests per day**: A maximum of 50 requests are allowed in a 24-hour period.
### Exceeding Rate Limits
If you exceed the rate limits, the API will respond with a `429 Too Many Requests` error. You will need to wait until the rate limit window resets before making additional requests.
**Response Example:**
```json theme={null}
{
"message": "Too many requests: You have exceeded the API rate limits."
}
```
## Monitoring Your Usage
It's important to monitor your API usage to avoid hitting the rate limits. Ensure your integration handles the `429` error gracefully and retries after the appropriate waiting period.
## Need Higher Limits?
If your use case requires higher rate limits, you can request an increase by contacting us at [support@superjoin.ai](mailto:support@superjoin.ai). Be sure to include the reasons for needing the higher limit and details about your usage.
# Refresh Data in Sheets
Source: https://docs.superjoin.ai/superjoin-apis/refresh-data-in-google-sheets
post /public/v1/import/refresh-data
This endpoint allows you to refresh data in a specified Google Sheets spreadsheet.
# How to associate any two records of different HubSpot objects from your Spreadsheet
Source: https://docs.superjoin.ai/usecases/associate-hubspot-records-google-sheets
Step-by-step guide to associate any two records of different HubSpot objects from Google Sheets or Microsoft Excel
In the Superjoin side panel, click on `Sources`, navigate through `Your Sources` and click on the HubSpot source you want to export the data to.
A pop-up will come up at the bottom of the side panel. Click on `Export to HubSpot`.
Choose the sheet with the data that you want to export to HubSpot and the row with the header cells of the sheet that you want to export.
Select `Associate` under the `Action` dropdown. Choose both the Objects that you want to be associated
Map only the two Google Sheets columns which contain the Record IDs of each of the object's records to the HubSpot Record ID properties of the two objects to ensure accuracy.
Choose the Record ID property of chosen object and repeat the same for the other object's record ID mapping as well.
Once you're done with the mapping, click on `Save` and then click on `Export`.
Record IDs are mandatory to perform the `ASSOCIATE` action. You can use the `Click here to get Record IDs` feature or retrieve the IDs manually.
Head over to this page to get a detailed explanation on it.
You can choose to export the entire sheet or only specific rows. If you want to export specific rows, further select the rows you want to export.
Verify the number of rows and click on `Associate in HubSpot` button, this action exports the selected data from your Google Sheets into your HubSpot account.
This completes the process of using Superjoin to associate two records of different HubSpot objects from Google Sheets.
Below are the steps to automate this process.
Now you'll see a card called `Automatic Exports`. Click on the `Create Schedule` button.
Configure the frequency in which you want this export process to repeat.
##### Hope this guide helped you export your data from Google Sheets to HubSpot using Superjoin.
##### If you have any questions or need further assistance, please don’t hesitate to reach out to our support team. Thank you!
#### Coming Soon!
# Automating Sequential Data Refreshes in Superjoin Workflows
Source: https://docs.superjoin.ai/usecases/automate-sequential-data-refresh-superjoin-workflows
This guide walks you through building a workflow in Superjoin to automate sequential data refreshes.
## Demo
Demo: Build a dynamic dashboard in Google Sheets with Superjoin
This walkthrough sets up a monthly refresh in a Chargebee MRR dashboard where one sheet updates only after another—preventing inconsistencies from unsynchronized refreshes.
## Why sequential refreshes?
When sheets depend on one another—such as an Active Subscription sheet that relies on an Existing Data sheet—refreshing both at the same time or out of sequence can create inaccuracies. By automating refreshes sequentially, Superjoin ensures your dependent data stays consistent and reliable, even if the first refresh requires multiple attempts.
## Prerequisites
Have the dashboard installed in Google Sheets and connected to Superjoin.
1. Existing Data (Chargebee) 2) Active Subscription (Chargebee)
In the Active Subscription sheet, there's a copied column named existing subs used to cross-reference subscription IDs.
The 'existing subs' column in the Active Subscription sheet
## Understand the dependency
The Active Subscription sheet uses a lookup to check whether a subscription ID exists in the Existing Data sheet.
The formula cross-references the Existing Data sheet for matches
Because of this formula, the Active Subscription sheet depends on the Existing Data sheet. Sequence matters for accuracy.
## Why not just time buffer?
The Active Subscription sheet must refresh after the Existing Data sheet refreshes. Scheduling the refreshes 30–60 minutes apart is unreliable—if the first refresh fails and retries, the second could run too soon.
Superjoin Workflows provide true sequence control: each step runs only after the previous completes successfully, with built‑in retries.
## Build the workflow
In Superjoin, open Workflows in the sidebar and click Create New Workflow.
Start a new workflow
Choose when the workflow starts. For this example, select Scheduled Time and set it to run monthly.
Select a trigger type
Add your first action: Import Data for the Existing Data sheet. Save the action.
Completed sequential workflow
Then add a second Import Data action targeting the Active Subscription sheet.
Your workflow now triggers monthly at 12am, first refreshing the Existing Data sheet, then—only after success—refreshing the Active Subscription sheet. This sequencing prevents mismatches and ensures accurate reporting.
Completed sequential workflow
## Next steps
* Configure notifications or exports after refreshes
* Explore error handling and alerts for greater reliability
* Browse other workflow patterns in the docs
With Superjoin Workflows, you’re a few clicks away from dependable, automated spreadsheet data syncs.
# Build a Dynamic Dashboard in Google Sheets with Superjoin
Source: https://docs.superjoin.ai/usecases/build-dynamic-dashboard-google-sheets-superjoin
Step-by-step guide to construct live, auto-updating dashboards in Google Sheets using Superjoin
### Demo video
Demo: Build a dynamic dashboard in Google Sheets with Superjoin
***
This guide walks you through constructing comprehensive live dashboards in Google Sheets using Superjoin to sync real-time data from tools like HubSpot. Whether you're analyzing your sales pipeline or tracking ongoing opportunities, you'll learn how to set up a powerful, dynamic report that stays up-to-date automatically.
## Introduction
With Superjoin, you can pull live sales pipeline data from [HubSpot](/integrations/hubspot/overview) directly into Google Sheets. This enables you to build dashboards that always reflect your latest business reality. Ideal for anyone responsible for pipeline analysis, these live dashboards remove manual updates and keep reports accurate.
### Prerequisites
* **Google Sheets access** with edit permissions on the target spreadsheet
* **Superjoin for Google Sheets** add-on installed (see [Quickstart](/quickstart))
* **Connected HubSpot account** with access to Deals and related objects
***
## Step 1: Import data with Superjoin
Superjoin connects Google Sheets to your business systems to keep data fresh without manual imports. Follow these steps to import live HubSpot pipeline data:
Install/add the Superjoin add-on if you haven't already
Click the **Superjoin** menu and select **Open Sidebar**
1. In the sidebar, click **Add Data Source**
2. Select **HubSpot** from the list of integrations
3. Authenticate your HubSpot account as prompted
1. Choose which HubSpot object to import (e.g., **Deals** for pipeline data)
2. Define the fields/columns you want (such as Deal Name, Amount, Stage, Owner, Close Date, etc.)
3. Set the import to **Auto-Sync** (recommended) for live updates (see [Formula Filldown](/features/formulae-filldown))
The Superjoin data will appear as a new sheet in your spreadsheet
HubSpot pipeline data imported into Sheets via Superjoin. Monthly updates ensure your dashboard never goes stale.
With live pipeline data, your reports reflect the most up-to-date information for decision-making and forecasting.
***
## Step 2: Explore and build the dashboard
The dashboard you build on your Superjoin-connected sheet is fully dynamic. Here’s how to bring that to life:
Ensure all pipeline fields are present
Create a dashboard tab where you will build the report UI
1. Use formulas to pull numbers from your live data (explained in the next section)
2. If you change underlying data (like opportunity stages in CRM), your dashboard reflects those changes immediately
Filters drive everything. Changing the opportunity type updates metrics and visuals instantly.
***
## Step 3: Set up the live data sheet (best practices)
A key difference with Superjoin-powered dashboards: Your sheet is always syncing with the source, so:
1. **Do NOT directly edit the imported Superjoin sheet.** This ensures uninterrupted sync and future-proof updates.
2. **Leave all raw data columns untouched.**
3. **Add calculated/formula columns to the right:**
* Open a blank column adjacent to your imported data
* Use row-level formulas (e.g., `=IF([Status] = "Closed Won", 1, 0)`) to enrich your raw data
* Example calculations:
* Closed date conversions
* Stage buckets (Won/Open/Lost)
* Owner or team name extraction
4. **Superjoin auto-fills formulas for every new row** that syncs in future updates.
5. **Use the space beside the imported data** to transform and analyze without breaking the sync.
Do not overwrite or delete columns in the imported Superjoin sheet. Make your transformations in new columns to the right to preserve syncing.
Adding formula columns to the right of imported Superjoin data for real-time calculations like extracting dates, amounts, and sales rep names. Superjoin auto-applies formulas to new rows as data is refreshed.
***
## Step 4: Build the metrics layer
This is the foundation of your dashboard – a "metrics block" where you summarize pipeline KPIs for display
Create a block (section) above/beside your imported/processed data
Use these example formulas:
```google-sheets theme={null}
# Total Pipeline Value
=SUMIF([Stage], "Open", [Amount])
# Won Revenue This Month
=SUMIFS([Amount], [Stage], "Closed Won", [Close Date], ">="&FirstOfMonth, [Close Date], "<="&Today)
# Deal Count
=COUNTIF([Stage], "Open")
```
Use structured references from your formula columns to simplify formulas
1. Use bold headers and light cell fills to clearly distinguish metrics from raw data
2. Display relevant KPIs important to your team (e.g., pipeline by segment, sales rep, deal type)
Metrics block with summary KPIs (deal count, pipeline value, closed revenue) dynamically calculated from imported Superjoin data.
***
## Step 5: Set up the drop-down filter
Dynamic filtering lets your dashboard viewers slice the data by attributes like opportunity type or business segment.
1. **Insert a drop-down cell** at the top of your dashboard area.
2. **Populate the drop-down with filter values:**
* Click the drop-down cell
* Go to **Insert > Drop-down** (Google Sheets) and select **Drop-down from a range**
* Choose a reference range — ideally, a list of unique values via `UNIQUE()` from your main data (e.g., all distinct Pipeline Types)
3. **Label the drop-down** (e.g., Select Opportunity Type).
4. **Point your summary and chart formulas to the drop-down selection:**
* Example: `=SUMIF([OpportunityType], $A$1, [Amount])` where `$A$1` is your drop-down cell
Dashboard with interactive drop-down filter for selecting opportunity type. Filtering options update dynamically as the dataset changes.
***
## Step 6: Use dynamic formulas
Tie your dashboard formulas to the filter selection so everything updates in real-time.
1. **Build formulas that reference the drop-down cell.** For example: `=SUMIFS([Amount], [OpportunityType], $A$1)`
2. **Apply similar formulas** to all relevant summary metrics and charts.
3. **Test by changing the drop-down** — all dashboard values should update instantly for the chosen filter.
4. **Handle edge cases:**
* Add formulas to show “All” or an empty state if nothing matches the selected filter
* Use `IFERROR` or `ISBLANK` to prevent errors when filter values are missing
***
## Step 7: Automate historic data collection
Automating the collection of historical metrics is crucial for tracking trends and performance over time in your Superjoin-powered dashboards. Here's how to implement this process step-by-step:
1\. **Gather all summary metrics and KPIs from your metrics block.** These should be calculated on your middle layer using live, formula-based results connected to your Superjoin data. These metrics might include total pipeline value, closed revenue, deal count, or any custom KPIs you've built.
2\. **Prepare a separate tracking sheet dedicated to historic data storage.** Set up columns for the date (e.g., daily, weekly, or monthly), alongside each metric you intend to monitor over time.
3. **Automate snapshotting metrics at regular intervals:**
* Use Google Apps Script or manual methods to copy the latest values from your metrics block into the corresponding row of your tracking sheet
* Schedule this process to run daily, weekly, or on another cadence suited to your reporting needs
* Ensure that only values (not formulas) are pasted to preserve the historical record even as live data changes
4. **Track how your metrics change over time.** The tracking sheet gradually accumulates snapshots, allowing you to calculate trends, run comparisons, and visualize time series directly on your dashboard.
Historical data tracking and visualization in Superjoin dashboard
5. **Reference historic data in your dashboards:**
* Use dynamic charts and summary sections that read from your tracking sheet to showcase trends like pipeline growth, win rates, or period-over-period changes
* This historical context adds deeper analytical value than point-in-time numbers alone, enabling true analysis and forecasting
6. **Integrate your automated tracking into the overall dashboard flow:**
* Your live dashboard should pull both current and historic values, with the same filter logic from Step 5 applied as needed to surface targeted insights
* By layering real-time and historical data, your dashboard delivers ongoing visibility into both recent activity and long-term performance
7. **Summary and best practices:**
* Maintain a live Superjoin sheet for real-time sync
* Build a robust middle layer for calculated results
* Store regular metric snapshots in a tracking/history sheet
* Reference both live and trend data in your dashboard visualizations, with interactive filtering for drill-down analysis
***
## Conclusion: Dashboard structure overview
The full Superjoin dashboard workflow follows these layers:
* **Live data sheet** synced via Superjoin
* **Middle layer** of calculated formulas that reference the live data
* **Historical tracking sheet** for time-based analysis
* **Final dashboard** that combines metrics and trendlines for actionable reporting
This setup empowers you to create robust, interactive sales dashboards that require minimal maintenance and always stay current with your business data.
***
### Related resources
* [Quickstart](/quickstart) — Install the add-on and connect your first source in minutes.
* [Formula Filldown](/features/formulae-filldown) — Auto-apply formulas to new rows as data refreshes.
* [Scheduled refresh](/features/scheduled-refresh) — Keep dashboards current with automated refreshes.
# Building Time Trends in Google Sheets with Superjoin
Source: https://docs.superjoin.ai/usecases/build-time-trends-google-sheets-superjoin
Capture historical metrics in Google Sheets using Superjoin Workflows and Apps Script to build reliable time series.
This guide helps you automate daily snapshots of key metrics so you can analyze day-over-day, week-over-week, and month-over-month trends—without manual copying.
## Demo
Build a dynamic dashboard in Google Sheets with Superjoin
***
## Why capture time trends?
When working with live dashboards in Superjoin, data reflects the current state—making it impossible to retrieve metrics from previous days. Capturing daily snapshots lets you:
* Analyze day-over-day, week-over-week, and month-over-month changes
* Build historical trend lines
* Eliminate manual copy-pasting
***
## Prerequisites
Superjoin is installed and your sheet is connected with at least one import set to refresh (manual, scheduled, or via workflow).
***
## Overview of the approach
Keep your Superjoin import(s) refreshing to power formulas.
Centralize key metrics in a middle-layer sheet with formulas.
Use a workflow + script to paste values into a trends sheet.
***
## Step-by-step
You should have a Superjoin sheet with live data being refreshed daily, weekly, or monthly. This data represents the state as of when it was last refreshed.
Pipeline metrics in Google Sheets live-updating with Superjoin integration
Establish a separate middle-layer sheet to contain key metric formulas. This acts as a staging area for daily captures before values are overwritten by fresh data. These formulas dynamically reference your Superjoin sheet and stay up-to-date as new data comes in.
Middle-layer sheet containing live formula outputs
Because these formulas are live, yesterday's values are lost after each update. We'll capture values before they refresh.
Set up a final trends or analysis sheet to collect daily snapshots. You'll automate copying values—not formulas—here, ensuring each day's state is preserved after each refresh.
Today's calculated metrics, ready for capture
Manually copying data every day is laborious and risks missing updates. Instead, leverage Superjoin Workflows and Google Sheets Apps Script to schedule and automate the capture process.
Click Workflows in Superjoin to get started.
Superjoin sidebar showing the Workflows option
Click Create New Workflow and name it "Day on Day Trends" for easy identification.
Workflow creation dialog, ready to be named and configured
Set a Trigger to run every day at a chosen time (e.g., 9am). This ensures your snapshot is taken before live data changes.
Scheduled trigger set up for daily automation
After the trigger, add an action to Refresh your connected data source (e.g., the "HubSpot" sheet), ensuring live data and formulas are up-to-date for today’s metrics.
Refresh the HubSpot sheet and update live formulas
Add a Run Script action to execute a Google Apps Script that copies today’s values (not formulas) from your intermediate formulas sheet into the analysis/trend sheet.
You can use Superjoin AI to generate the Apps Script. Click Test Action to verify.It’s critical to paste values only—referencing formulas will result in dynamic updates, not historical snapshots.Sample Apps Script: copy values from selected rows to the next empty column
```javascript filename="script.gs" Sample Script theme={null}
/***** ULTRA-SIMPLE SNAPSHOT (values → last column) *****
* How to use:
* 1) Extensions → Apps Script → paste this, Save.
* 2) Click ▶️ Run once (authorize if asked).
* 3) Run again to append the snapshot.
********************************************************/
/******** SETTINGS (edit these) ********/
var SOURCE_SHEET_NAME = 'Live Formulas'; // where data lives
var TARGET_SHEET_NAME = 'Pipeline Analysis'; // where to paste
var HEADER_CELL_A1 = 'B1'; // header cell to copy
var SOURCE_COLUMN = 2; // 2 = column B
var ROWS_TO_COPY = [4,5,6,7,8,9,10,13,14,15,16,19,20,21];
/****************************************/
function appendSnapshotRun() {
// If you see "getActive not supported", replace the next line with:
// var ss = SpreadsheetApp.openById('PUT_SPREADSHEET_ID_HERE');
var ss = SpreadsheetApp.getActiveSpreadsheet();
var src = ss.getSheetByName(SOURCE_SHEET_NAME);
var dst = ss.getSheetByName(TARGET_SHEET_NAME);
if (!src) throw new Error('Missing source sheet: ' + SOURCE_SHEET_NAME);
if (!dst) throw new Error('Missing target sheet: ' + TARGET_SHEET_NAME);
// Next empty column on target
var destCol = dst.getLastColumn() + 1;
if (destCol < 1) destCol = 1;
// Header (value only)
var headerVal = src.getRange(HEADER_CELL_A1).getValue();
dst.getRange(1, destCol).setValue(headerVal);
// Read needed values from the source column in one go
var maxRow = _maxRow(ROWS_TO_COPY);
var colVals = src.getRange(1, SOURCE_COLUMN, maxRow, 1).getValues(); // 2D
// Paste values into the last column at chosen rows
for (var i = 0; i < ROWS_TO_COPY.length; i++) {
var r = ROWS_TO_COPY[i];
if (r > 0) {
var v = colVals[r - 1][0];
dst.getRange(r, destCol).setValue(v);
}
}
Logger.log('Done! Snapshot pasted into column ' + destCol + ' of "' + TARGET_SHEET_NAME + '".');
}
/* Helper */
function _maxRow(arr) {
var m = 0;
for (var i = 0; i < arr.length; i++) if (+arr[i] > m) m = +arr[i];
return m;
}
```
Resulting analysis sheet after the script—values are pasted, not formulas
Click Save Action and then Save Workflow to finalize your automation. Your routine will now run daily, refreshing data and archiving each snapshot for seamless trend analysis.
Workflow successful and ready for daily execution
***
## What’s next?
You now have an automated day-over-day trend system in Google Sheets powered by Superjoin. Every morning, your trend sheet will be updated automatically with the latest metrics, letting you analyze historical trends without manual work.
* Set up email reports using Scheduled Reports
* Extend your workflow to capture other key metrics
* Visualize your trends with chart recommendations
# How to delete HubSpot data from your Spreadsheet
Source: https://docs.superjoin.ai/usecases/delete-hubspot-data-google-sheets
Step-by-step guide to delete HubSpot data from Google Sheets or Microsoft Excel
In the Superjoin side panel, click on `Sources`, navigate through `Your Sources` and click on the HubSpot source you want to export the data to.
A pop-up will come up at the bottom of the side panel. Click on `Export to HubSpot`.
Choose the sheet with the data that you want to export to HubSpot and the row with the header cells of the sheet that you want to export.
Choose the HubSpot `Object` you want to export data to, from the `Object` dropdown and select `Delete` under the `Action` dropdown.
Select the Google Sheets column that contains the Record IDs of the HubSpot data from the dropdown. Click on `Save` and then click on `Export`.
Record IDs are mandatory to perform the `DELETE` action. You can use the `Click here to get Record IDs` feature or retrieve the IDs manually.
Head over to this page to get a detailed explanation on it.
You can choose to export the entire sheet or only specific rows. If you want to export specific rows, further select the rows you want to export.
Verify the number of rows and click on `Update in HubSpot` button, this action exports the selected data from your Google Sheets into your HubSpot account.
This completes the process of using Superjoin to delete HubSpot data from Google Sheets.
Below are the steps to automate this process.
Now you'll see a card called `Automatic Exports`. Click on the `Create Schedule` button.
Configure the frequency in which you want this export process to repeat.
##### Hope this guide helped you export your data from Google Sheets to HubSpot using Superjoin.
##### If you have any questions or need further assistance, please don’t hesitate to reach out to our support team. Thank you!
#### Coming Soon!
# How to dissociate two records of different HubSpot objects from your Spreadsheet
Source: https://docs.superjoin.ai/usecases/dissociate-hubspot-records-google-sheets
Step-by-step guide to dissociate two records of different HubSpot objects from Google Sheets or Microsoft Excel
In the Superjoin side panel, click on `Sources`, navigate through `Your Sources` and click on the HubSpot source you want to export the data to.
A pop-up will come up at the bottom of the side panel. Click on `Export to HubSpot`.
Choose the sheet with the data that you want to export to HubSpot and the row with the header cells of the sheet that you want to export.
Select `Dissociate` under the `Action` dropdown. Choose both the Objects that you want to be dissociated.
Map only the two Google Sheets columns which contain the Record IDs of each of the object's records to the HubSpot Record ID properties of the two objects to ensure accuracy.
Choose the Record ID property of chosen object and repeat the same for the other object's record ID mapping as well.
Once you're done with the mapping, click on `Save` and then click on `Export`.
Record IDs are mandatory to perform the `DISSOCIATE` action. You can use the `Click here to get Record IDs` feature or retrieve the IDs manually.
Head over to this page to get a detailed explanation on it.
You can choose to export the entire sheet or only specific rows. If you want to export specific rows, further select the rows you want to export.
Verify the number of rows and click on `Dissociate in HubSpot` button, this action exports the selected data from your Google Sheets into your HubSpot account.
This completes the process of using Superjoin to dissociate records of two different HubSpot objects from Google Sheets.
Below are the steps to automate this process.
Now you'll see a card called `Automatic Exports`. Click on the `Create Schedule` button.
Configure the frequency in which you want this export process to repeat.
##### Hope this guide helped you export your data from Google Sheets to HubSpot using Superjoin.
##### If you have any questions or need further assistance, please don’t hesitate to reach out to our support team. Thank you!
#### Coming Soon!
# Import Calls from HubSpot to Google Sheets
Source: https://docs.superjoin.ai/usecases/import-calls-hubspot-google-sheets
Step-by-step guide to import calls from HubSpot into Google Sheets using Superjoin
This guide walks you through importing your calls data from HubSpot into Google Sheets using Superjoin. This workflow is ideal for sales and operations teams who need live visibility into call activity without spending hours manually exporting and cleaning data. By the end, your calls data will be imported into a sheet with optional automated refreshes.
## Open the Superjoin Sidebar
Click the Superjoin icon to launch the sidebar in Google Sheets.
## Access HubSpot in Sources
Navigate to the **Sources** section in the Superjoin sidebar and locate your connected **HubSpot** data source.
## Open Data Preview
Click on your **HubSpot** source, then choose **Import into Google Sheets**.
## Preview and Select Data
The Data Preview modal will appear, allowing you to select which data to import. Under **Objects**, select **Calls**.
## Add or Modify Fields
Click **Add or Modify fields**. Select the desired fields to include in your import, such as:
* Notes
* Activity date
* My call
* Location
## Apply Filters (Optional)
Click **Add filters** to refine your data. For example, to see only today's calls, add a filter for **activity date** and set it to today. Click **Apply Filter** to update the preview.
## Create and Name the Report
Once the data is filtered as desired, create a new report. Give your report a name, such as "Calls from today", and click **Import** to bring the calls data into your sheet.
Click **Cancel import** at any time if you need to stop the process.
## Automate Data Refresh (Optional)
To regularly update your calls data, set a refresh schedule. Choose how often you want to update (for example, daily), the time (such as 6:00 AM), and click **Schedule**.
Scheduled refreshes ensure your team always has access to the latest call data
every morning without manual intervention.
Your HubSpot calls are now in Google Sheets and will update automatically.
# Import Companies from HubSpot to Google Sheets
Source: https://docs.superjoin.ai/usecases/import-companies-hubspot-google-sheets
Step-by-step guide to import companies from HubSpot into Google Sheets using Superjoin
This guide walks you through importing company data from HubSpot directly into Google Sheets using Superjoin. This workflow is perfect for marketing and sales teams who need up-to-date HubSpot company records in their spreadsheets for reporting, analysis, or automation—without any manual CSV exports or record limits. By the end, you'll have a scheduled report in Sheets that stays synced with your HubSpot Companies data, filtered exactly as you need.
## Open Superjoin and Navigate to Sources
Start by opening the Superjoin add-on in your Google Sheets. In the sidebar, navigate to the **Sources** section where you manage all your data connections—like HubSpot, Salesforce, or Stripe.
## Choose Your HubSpot Data Source
From the list of connected sources, select your active **HubSpot** connection. Once selected, click **Import into Google Sheets** to begin the data import process.
If you don't see your HubSpot source, you may need to connect it first through
the Superjoin setup.
## Preview and Configure Your Data
A Data Preview pane appears, allowing you to pick which data object you want, choose specific fields to import, and add filters to narrow down your results. Select the object **Companies**, then add the **Record ID** field to ensure you include unique identifiers for each company.
Only select the fields you need to keep your sheet clean and maintain fast
performance.
## Apply Filters to Refine Your Import
Switch to the **Filter** tab to set up custom filters. For example, you can import only companies added in the last 120 days by filtering on the **Create date** field with the condition "in the last 120 days." Apply your filter to preview the exact rows Superjoin will import.
Once ready, click **Apply Filter** to lock in your criteria.
## Import and Name Your Data
Click **Import** to start pulling the filtered companies data into your spreadsheet. Give the import a descriptive name, such as "companies last 120 days," so you can easily identify it later.
Once you've named it, click **Save**.
Superjoin bypasses HubSpot's usual 10,000 record limit, allowing you to import
up to 200,000 company records at once.
If you need to stop the import at any time, simply click **Cancel import**.
## Set Up Automatic Refresh Scheduling
To keep your report constantly updated, use Superjoin's scheduling feature. You can refresh data hourly, daily, weekly, or monthly depending on your needs. For example, to update your company report every day at 6:00 AM, select **daily** and choose **6:00 AM** as the time, then click **Schedule** to activate auto-refresh.
Your Google Sheet now has an always-current HubSpot Companies report, updated
automatically per your schedule.
# Import Contacts from HubSpot to Google Sheets
Source: https://docs.superjoin.ai/usecases/import-contacts-hubspot-google-sheets
Step-by-step guide to import contacts from HubSpot into Google Sheets using Superjoin
This guide demonstrates how to import contacts from your HubSpot account into Google Sheets using Superjoin. This workflow is ideal for marketers, sales teams, and anyone who needs real-time HubSpot contact data in their spreadsheets. You'll learn how to import, filter, and schedule automatic updates for your customer data.
## Open the Superjoin Sidebar
Start by opening the Superjoin sidebar in Google Sheets by clicking the Superjoin icon in your Google Sheets interface.
## Locate Your HubSpot Source
Navigate to the **Sources** section in the sidebar. You'll see your connected HubSpot account listed here.
## Open Data Preview
Click on your **HubSpot** source, then select **Import into Google Sheets** from the available options.
## Select Data to Import
A data preview modal will open, allowing you to configure which HubSpot data to import. Select **Contacts** as the object type.
Next, add the specific columns you need. For this example, we'll select:
* Record ID
* Create Date
* Email Domain
## Apply Filters (Optional)
To import only a subset of your contacts, configure filters. For example, to import only contacts with Gmail email addresses, set a filter for the **email domain** field to include "Gmail."
## Review and Import Your Data
Review your selections in the data preview. When everything looks correct, click **Import**, enter a name for your sheet (e.g., "Gmail users"), and click **Save and Import**.
Click **Cancel** at any time if you need to abort the import process.
## View Imported Data
After the import completes, a new sheet containing your filtered HubSpot contact data will appear in your Google Sheets file, ready for analysis or follow-ups.
Your HubSpot contacts are now successfully imported into Google Sheets.
## Automate with Scheduling (Optional)
Set up automatic refresh to keep your contact list current. Configure the sheet to update hourly, daily, weekly, or monthly. For example, schedule daily updates at 6:00 AM by adjusting the scheduling settings and clicking **Schedule**.
Scheduled refreshes ensure your spreadsheet always reflects the latest data
from HubSpot without manual intervention.
## Next Steps
You've successfully imported your HubSpot contacts into Google Sheets and configured optional automation for effortless updates. Your team now has access to current data without manual imports.
Integrate additional platforms like Salesforce or Stripe to centralize your
data.
Discover Superjoin's workflow automation and reporting tools to boost
productivity.
# Import Deals from HubSpot to Google Sheets
Source: https://docs.superjoin.ai/usecases/import-deals-hubspot-google-sheets
Step-by-step guide to import deals from HubSpot into Google Sheets using Superjoin
This guide shows you how to import HubSpot deals into Google Sheets using Superjoin and set up automatic updates to keep your data fresh. This workflow is perfect for sales and operations teams who need real-time deal tracking without manual exports. You'll learn how to sync filtered HubSpot deal data into Sheets, bypass HubSpot's 10,000 record limit (import up to 200,000 records), and automate daily data refreshes for always up-to-date reports.
## Launch Superjoin in Google Sheets
Open your Google Sheet and click the **Superjoin** button to launch the assistant sidebar. This is your starting point for all data workflows with Superjoin.
## Navigate to Sources and Choose HubSpot
In the Superjoin sidebar, click the **Sources** section to view all available data connections. Locate your connected **HubSpot** account and click it to proceed.
## Open Data Preview
Click the **Import into Google Sheets** action to open the Data Preview screen, where you can review and configure your import.
## Select Objects and Review Preview
In the Data Preview, navigate to the **Objects** field and select **Deals**. Superjoin instantly displays a preview of your deals data so you can confirm what will be imported.
## Filter Deals (Optional)
To refine your import, click **Filter**. For example, you may want only deals in a specific stage or pipeline. Choose your desired criteria—such as **Deal Stage** and set it to **Appointment scheduled** in the **Sales pipeline**—then apply your filter to ensure only relevant deals are imported.
Filtering before import keeps your Sheets focused and actionable.
## Import Filtered Data
Once your filters are set, click **Import**. You'll be prompted to name your sheet—enter something intuitive (such as "Deals")—then click **Save and Import**. Superjoin will pull all matching deals from HubSpot and create a new tab in your Google Sheet.
Superjoin bypasses HubSpot's 10,000 record limit, allowing you to import up to
200,000 records at once.
## Automate Data Refresh with Scheduling
After import, you can automate refreshing your deal data on a schedule. Choose from hourly, daily, weekly, or monthly options. For example, to get updated deals every day at 6:00 AM, set your schedule to **daily** and select **6:00 AM**, then click **Schedule** to activate automation.
Your HubSpot deals are now synced to Google Sheets and will update
automatically every morning.
# How to insert new data from your Spreadsheet to HubSpot
Source: https://docs.superjoin.ai/usecases/insert-data-google-sheets-hubspot
Step-by-step guide to insert data from Google Sheets or Microsoft Excel to HubSpot
In the Superjoin side panel, click on `Sources`, navigate through `Your Sources` and click on the HubSpot source you want to export the data to.
A pop-up will come up at the bottom of the side panel. Click on `Export to HubSpot`.
Choose the sheet with the data that you want to export to HubSpot and the row with the header cells of the sheet that you want to export.
Choose the HubSpot `Object` you want to export data to, from the `Object` dropdown and select `Insert` under the `Action` dropdown.
Map the Google Sheets columns to the HubSpot properties to ensure accuracy.
Search for the HubSpot property you want to map your Google Sheet column to and click on it. Now repeat this for all the columns you want to map with the relevant HubSpot properties.
Once you're done with the mapping, click on `Save` and then click on `Export`.
You can choose to export the entire sheet or only specific rows. If you want to export specific rows, further select the rows you want to export.
Verify the number of rows and click on `Insert to HubSpot` button, this action exports the selected data from your Google Sheets into your HubSpot account.
This completes the process of using Superjoin to insert new data into HubSpot from Google Sheets.
Below are the steps to automate this process.
Now you'll see a card called `Automatic Exports`. Click on the `Create Schedule` button.
Configure the frequency in which you want this export process to repeat.
##### Hope this guide helped you export your data from Google Sheets to HubSpot using Superjoin.
##### If you have any questions or need further assistance, please don’t hesitate to reach out to our support team. Thank you!
#### Coming Soon!
# Updating Contacts in HubSpot with Superjoin
Source: https://docs.superjoin.ai/usecases/update-contacts-hubspot-google-sheets
Step-by-step guide to update contacts from Google Sheets into HubSpot using Superjoin
Bulk update HubSpot contacts directly from Google Sheets with Superjoin. Ideal for marketing, sales, and ops teams to keep CRM data accurate—without manual entry.
## What you'll achieve
* Update existing HubSpot contacts by syncing data from your Google Sheet
* Automatically map and export fields, including Record IDs and emails
* Monitor row-by-row update results inside your spreadsheet
***
## Prerequisites
* Your sheet contains a unique identifier per contact: Record ID or email
* Superjoin is installed and connected to HubSpot
***
## Step-by-step
To update contacts, include at least the Record ID or email in your sheet. If you import via Superjoin, add the Record ID field for accurate matching.
Include a column for Record ID or email in your Google Sheet
When importing from HubSpot, add Record ID in the data source dialog so Superjoin can uniquely identify contacts.
Create a query to export updates from your sheet to HubSpot.
Go to Queries in the Superjoin sidebar.
Open the Queries section from the sidebar
Click Create New Query to start a new export task.
Start a new query for updating contact records
Select the Google Sheet containing your updated contact information.
Select your source spreadsheet for contact updates
Click Export to HubSpot.
Initiate the export to HubSpot
The export wizard guides you through mapping fields and configuration.
If your sheet was imported via Superjoin, most fields map automatically (e.g., name, email, Record ID).
Review and verify mappings in the wizard
If you use a custom sheet (not imported via Superjoin), map each column to a HubSpot field manually.
Save field mappings for the update process
Define result columns from the last column onward to capture row-by-row update info. Decide whether to export empty cells:
Export empty cells: empty values overwrite existing values in HubSpot
Ignore empty cells: recommended for partial updates
Control how empty cells are handled during export
Choose which rows to export or select the entire sheet. Exporting the full sheet also captures newly added rows automatically.
Select individual rows or the entire sheet
Click Next to proceed and confirm the row count (e.g., 407 rows).
Status check before exporting rows to HubSpot
After the export runs, Superjoin adds result columns to your sheet showing row-by-row outcomes.
Each row shows whether the associated HubSpot record was updated successfully
The Record ID remains linked for instant navigation to the HubSpot contact
Results columns include outcome and direct HubSpot links
***
## What's next?
With contacts updated from Google Sheets, you have a fast, repeatable workflow for CRM maintenance. Next, try:
* Automating scheduled syncs for ongoing updates
* Connecting additional objects like Companies or Deals for broader data management
* Using Superjoin formulas for advanced data cleaning
You’re now equipped to keep HubSpot contact data up-to-date right from your spreadsheet—saving time and reducing manual errors.
# How to update existing HubSpot data from your Spreadsheet
Source: https://docs.superjoin.ai/usecases/update-hubspot-data-google-sheets
Step-by-step guide to update existing HubSpot data from Google Sheets or Microsoft Excel
In the Superjoin side panel, click on `Sources`, navigate through `Your Sources` and click on the HubSpot source you want to export the data to.
A pop-up will come up at the bottom of the side panel. Click on `Export to HubSpot`.
Choose the sheet with the data that you want to export to HubSpot and the row with the header cells of the sheet that you want to export.
Choose the HubSpot `Object` you want to export data to, from the `Object` dropdown and select `Update` under the `Action` dropdown.
If your sheet is dynamic, that is, the existing data constantly undergoes changes as well as new data keeps getting added, click on `Upsert`.
Head over to this page to get a detailed explanation on it.
Map the Google Sheets columns to the HubSpot properties to ensure accuracy.
Search for the HubSpot property you want to map your Google Sheet column to and click on it. Now repeat this for all the columns you want to map with the relevant HubSpot properties.
Once you're done with the mapping, click on `Save` and then click on `Export`.
Record IDs are mandatory to perform the `UPDATE` action. You can use the `Click here to get Record IDs` feature or retrieve the IDs manually.
Head over to this page to get a detailed explanation on it.
You can choose to export the entire sheet or only specific rows. If you want to export specific rows, further select the rows you want to export.
Verify the number of rows and click on `Update in HubSpot` button, this action exports the selected data from your Google Sheets into your HubSpot account.
This completes the process of using Superjoin to update existing HubSpot data from Google Sheets.
Below are the steps to automate this process.
Now you'll see a card called `Automatic Exports`. Click on the `Create Schedule` button.
Configure the frequency in which you want this export process to repeat.
##### Hope this guide helped you export your data from Google Sheets to HubSpot using Superjoin.
##### If you have any questions or need further assistance, please don’t hesitate to reach out to our support team. Thank you!
#### Coming Soon!
# How to Upsert data into HubSpot from your Spreadsheet
Source: https://docs.superjoin.ai/usecases/upsert-data-google-sheets-hubspot
Step-by-step guide for upserting data from Google Sheets or Microsoft Excel to HubSpot
## Understanding Upserts in HubSpot
**What is an Upsert?** An upsert operation allows you to both insert new records and update existing ones in a single action.
**Why can't we use HubSpot Record IDs?** HubSpot's native Record IDs are **read-only** fields. This means:
* ✅ You can use them to **update** existing records
* ❌ You **cannot** use them to **insert** new records (because new records don't have Record IDs yet)
**The Solution:** To enable upserts, we need to create a custom unique identifier field in HubSpot that can handle both new and existing records.
**Supported Objects:** Upserts are available for the following HubSpot objects:
**CRM Objects:** Contacts, Companies, Deals, Leads, Tickets
**Commerce Objects:** Products, Quotes, Line Items, Carts, Discounts, Fees, Invoices, Orders, Taxes
**Engagement Objects:** Calls, Emails, Meetings, Notes, Tasks, Communications, Postal Mails
***
## Part 1: Setup in HubSpot
**Why are we doing this?** We need to create a custom unique identifier field in HubSpot that works for both new and existing records, since the built-in Record ID cannot be used for inserts.
Click the `Settings` button that's on the navigation bar.
Scroll down the Settings sidebar menu on the left and click on `Properties`
Select the Object in which you want to create this new field in then click on the orange colored button on the right called `Create property`
Fill in the details of the field.
Choose `Number` as the field type.
**Important:** Make sure to check the "Unique value" option (as shown in the image). This ensures each record has a distinct identifier. Click the orange `Create` button on the top right.
**Why make it unique?** This field will be used to identify records. Making it unique prevents duplicate records and ensures accurate upserts.
***
## Part 2: Setup and Upsert in Superjoin
**What are we doing now?** We'll prepare your Google Sheets with the custom unique identifier, validate it with HubSpot, and then perform upserts.
In your Google Sheet, create a new column with the **same name** as the HubSpot field you just created.
The column name must match exactly with your HubSpot property name for proper mapping.
Now you need to fill this column with unique values:
Copy the HubSpot Record IDs into this new field
Use any unique numbers (e.g., 10001, 10002, etc.)
⚠️ **Every value in this column must be unique.** Duplicates will cause upsert failures.
**Don't have Record IDs?** If you don't have Record IDs for existing records, check out the [FAQ: What if I don't have Record IDs?](#what-if-i-dont-have-record-ids-to-fill-the-unique-field-with) below to learn how to import them from HubSpot first.
**Why this step?** Before HubSpot allows upserts using your custom field, it needs to see the field populated with data at least once. We'll do a one-time update to validate it.
Choose the `Update` action and click `Next`.
Map all the fields to their respective HubSpot fields, **including your new custom unique identifier field**. Click `Save` and then click `Export`.
Select the `Entire Sheet` option, then click `Next` and update the data.
**What happened?** Your existing records were updated with the custom unique identifier values. New records were skipped (since the `Update` action can't insert new data).
Your custom field is now validated and ready for upserts! ✅
This validation step only needs to be done once. After this, you can perform upserts freely.
**Now the magic happens!** You can update existing records AND insert new records in a single operation.
Choose the `Upsert` action and click `Next`.
Map your fields carefully:
* ✅ **Do include:** Your custom unique identifier field and all data fields you want to sync
* ❌ **Don't include:** HubSpot `Record ID` field or any Superjoin-generated metadata fields (like sync timestamps)
Click `Save` and then click `Export`.
Select the entire sheet or specific rows you want to upsert, then click `Next` and run the upsert.
🎉 **Success!** Your data has been upserted to HubSpot.
**What just happened:**
* Existing records (matched by your custom unique ID) were updated
* New records were inserted into HubSpot
* All in one seamless operation!
This completes the process of using Superjoin to upsert data from Google Sheets to HubSpot.
Below are the steps to automate this process.
Now you'll see a card called `Automatic Exports`. Click on the `Create Schedule` button.
Configure the frequency in which you want this upsert process to repeat.
***
## Summary
You've successfully set up upserts from Google Sheets to HubSpot! Here's what you accomplished:
1. ✅ Created a custom unique identifier field in HubSpot (since Record IDs are read-only)
2. ✅ Populated your Google Sheets with unique values
3. ✅ Validated the field with an initial update
4. ✅ Enabled seamless upserts that can insert new records and update existing ones
Now you can modify data in Google Sheets and push all changes to HubSpot in one operation!
***
## Frequently Asked Questions
**No, you cannot use multiple primary keys for upsert operations.**
HubSpot requires a **single unique identifier** to match and upsert records. Here's why:
* **How upserts work:** When you perform an upsert, HubSpot looks at the unique identifier field to determine if a record already exists. If it finds a match, it updates that record; if not, it creates a new one.
* **Why only one:** Having multiple primary keys would create ambiguity. For example, if Record ID matches but your custom ID doesn't, HubSpot wouldn't know whether to update the existing record or create a new one.
* **Record ID limitation:** Remember that HubSpot Record IDs cannot be used as the primary key for upserts because they are read-only and don't exist for new records yet.
**Best practice:** Use your custom unique identifier field (the one you created in this guide) as the single source of truth for all upsert operations.
This error means HubSpot doesn't have a validated unique identifier field to use for matching records during upsert operations.
**Quick fix - follow these steps:**
1. **Create a custom unique field in HubSpot:**
* Go to Settings → Properties in HubSpot
* Create a new Number field with the "Unique value" option enabled
2. **Add the field to Google Sheets:**
* Create a column with the same name as your HubSpot field
* Fill it with unique values (use Record IDs for existing records, unique numbers for new records)
3. **Validate the field:**
* Run a one-time **Update** operation (not upsert) to push the unique values to HubSpot
* This validates the field and populates existing records with your custom IDs
4. **Now try upsert again:**
* Select the **Upsert** action
* Map your custom unique identifier field
* Your upserts will now work!
**Tip:** Make sure you've completed the validation step (step 3). Without it, HubSpot won't recognize your custom field as valid for upsert operations.
**HubSpot Record IDs are read-only fields**, which creates a fundamental limitation for upsert operations.
Here's the problem:
**For existing records:**
* ✅ Record IDs work perfectly for **updates**
* Every existing record already has a Record ID assigned by HubSpot
**For new records:**
* ❌ Record IDs **don't exist yet** - they're only assigned after a record is created
* You can't provide a Record ID when inserting a new record
* This makes Record IDs incompatible with the "insert" part of "upsert"
**What is an upsert?**
* An upsert combines **insert** (create new records) + **update** (modify existing records) in one operation
* It needs a unique identifier that works for both scenarios
**The solution:**
* Create a **custom unique identifier field** that you control
* For existing records: populate it with Record IDs or other unique values
* For new records: assign unique numbers (e.g., 10001, 10002, etc.)
* This field works for both inserts and updates, enabling true upsert functionality
**In summary:** Record IDs are perfect for updates only, but upserts need a field that can handle both new and existing records - which is why you need a custom unique identifier.
If you don't already have HubSpot Record IDs in your Google Sheet, you'll need to import them first. **Record IDs are required for existing records** to properly identify and update them during upserts.
**Solution: Import data from HubSpot first**
Use Superjoin to import your existing HubSpot records into Google Sheets, which will automatically pull the Record IDs along with your data:
1. **Import your HubSpot data:**
* Use Superjoin's import feature to pull data from HubSpot
* Make sure to include the **Record ID** field in your import
* This will create a sheet with all your existing records and their HubSpot Record IDs
2. **Populate your custom unique field:**
* Copy the Record IDs from the imported data
* Paste them into your custom unique identifier field
* For any new records you want to add, use unique numbers (e.g., 10001, 10002, etc.)
3. **Continue with the upsert process:**
* Follow the validation and upsert steps from this guide
* Your existing records will be matched using the Record IDs you imported
**Why is this necessary?**
* **Existing records:** Need their original HubSpot Record IDs so the system can match and update them correctly
* **New records:** Can use any unique numbers since they don't exist in HubSpot yet
* **Without Record IDs:** You risk creating duplicate records instead of updating existing ones
**Need help importing?** Check out our [complete guide on importing data from HubSpot](/integrations/hubspot/import) to learn how to pull your existing records with their Record IDs.
***
##### Hope this guide helped you export your data from Google Sheets to HubSpot using Superjoin.
##### If you have any questions or need further assistance, please don't hesitate to reach out to our support team. Thank you!
#### Coming Soon!