> ## Documentation Index
> Fetch the complete documentation index at: https://www.domo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Sansan Connector

## Intro

Sansan is a business card management service. To learn more about the Sansan APIs, visit the [Sansan API documentation](https://docs.ap.sansan.com/en/api/).

Use of the Sansan Open API is subject to the [Sansan API Terms of Use](https://agreement.sansan.com/en/rule/api.html), and use of the API constitutes acceptance of the Sansan API Terms of Service.

You can connect to your Sansan account in the Data Center. This article covers the fields and menus that are specific to the Sansan connector. To add DataSets, set update schedules, and edit DataSet information, see [Adding a DataSet Using a Connector](/docs/s/article/360042926274).

***

## Prerequisites

To connect to your Sansan account and create a DataSet, you need the API key associated with your Sansan account.

To find your API key, see [Steps for using Sansan APIs](https://docs.ap.sansan.com/en/api/index.html).

## Connect to Your Sansan Account

This section enumerates the options in the **Credentials** and **Details** panes on the Sansan Connector page. The components of the other panes on this page, **Scheduling** and **Name & Describe Your DataSet**, are universal across most connector types and are discussed in detail in [Adding a DataSet Using a Connector](/docs/s/article/360042926274).

## Credentials Pane

This pane contains fields for entering credentials to connect to your Sansan account. The following table describes what is needed for each field:

| Field   | Description                                            |
| ------- | ------------------------------------------------------ |
| API Key | Enter the API key associated with your Sansan account. |

Once you have entered valid Sansan credentials, you can use the same account at any time to create a new Sansan DataSet. You can manage connector accounts in the **Accounts** tab in the Data Center. For more information about this tab, see [Manage Connector Accounts](/docs/s/article/360042926054).

## Details Pane

This pane contains a primary **Reports** menu, along with various other menus that may or may not appear depending on the report type you select.

| Menu                  | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Report                | Select the Sansan report you want to run. The following reports are available:<br /><table><thead><tr><th>Report Name</th><th>Description</th></tr></thead><tbody><tr><td>Business Cards</td><td>Returns the list of business cards accessible in your account.</td></tr><tr><td>Contact</td><td>Returns the list of reports by contact type.</td></tr><tr><td>Users</td><td>Returns the list of all users of your company.</td></tr><tr><td>Departments</td><td>Returns the list of all departments of your company.</td></tr></tbody></table> |
| Updated               | In the Date selection, select either a single day, a date range, or a time period when filtering the results by the update date of items.<br />**Single date:** Select the specific or relative single date.<br />**Date range:** Select the specific or relative date range.<br />**Time period:** Select the time period from the **Time period** dropdown for your report.                                                                                                                                                                   |
| Updated - Date        | Select the **Date Type** to specify whether the report should use a specific date or a relative number of days from today.<br />**Relative**: Enter the number of days back in the **Days Back** field. For example, enter **0** for today, **1** for yesterday, or **7** for data from the past seven days.<br />**Specific**: Select a date using the date picker in the **Date** field.                                                                                                                                                      |
| Updated - Start Date  | Select the **Date Type** for your report:<br />**Relative**: Enter the number of days back to use as the start date. Use this together with **End Date** to define the date range. *Example*: If you enter **10** for **Start Date** and **5** for **End Date**, the report includes data from 10 days ago through 5 days ago.<br />**Specific**: Select the first date in the range using the date selector.                                                                                                                                   |
| Updated - End Date    | Select the **Date Type** for your report:<br />**Relative**: Enter the number of days back to use as the end date. Use this together with **Start Date** to define the date range. *Example*: If you enter **10** for **Start Date** and **5** for **End Date**, the report includes data from 10 days ago through 5 days ago.<br />**Specific**: Select the last date in the range using the date selector.                                                                                                                                    |
| Updated - Time period | Choose the time period for which you want to receive the data.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Contact type          | Select the contact type. The available options are **Meeting**, **Call**, **Email**, **BizCardExchange**, and **OnlineMeeting**.                                                                                                                                                                                                                                                                                                                                                                                                                |
| Category type         | Select whether you want to apply category filters.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |

## Other Panes

For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see [Adding a DataSet Using a Connector](/docs/s/article/360042926274).