Sansan Connector

Intro

Sansan is a business card management service. To learn more about the Sansan APIs, visit the Sansan API documentation.

Use of the Sansan Open API is subject to the Sansan API Terms of Use, 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.

---

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.

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.

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.

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: Report Name Description Business Cards Returns the list of business cards accessible in your account. Contact Returns the list of reports by contact type. Users Returns the list of all users of your company. Departments Returns the list of all departments of your company.
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. Single date: Select the specific or relative single date. Date range: Select the specific or relative date range. 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. 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. Specific: Select a date using the date picker in the Date field.
Updated - Start Date	Select the Date Type for your report: 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. Specific: Select the first date in the range using the date selector.
Updated - End Date	Select the Date Type for your report: 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. 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.