Skip to Content

Connect Sansan to Your AI Agent

Ask your AI assistant to find people, save new contacts, digitize business card photos, and record meetings. Administrators can also maintain teams and access settings.

27 toolsAPI key

20,000 free app calls every month(paid services billed separately)

Try a Sansan Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo SkillSansan

Find the right contacts

Search by company or name and inspect the latest contact information and tags.

/oo Sansan: Find Sansan contacts at [company], inspect their latest business cards and tags, and summarize their roles and available contact details.

Review recent contact changes

Collect business cards updated during a chosen period, including historical cards when useful.

/oo Sansan: List Sansan business cards updated between [start] and [end], include tags, follow all pages, and group the returned records by company.

Prepare a meeting brief

Combine business card details with recorded meetings, calls, and emails.

/oo Sansan: Prepare for a meeting with [company]. Find the relevant Sansan business cards and contact reports updated between [start] and [end]. Summarize supported facts, identify gaps, and suggest follow-up questions.

Check the connected account

Identify which Sansan user owns the connection and review their role and departments.

/oo Sansan: Show which Sansan user is connected, their role, and their departments.

Save contacts after an event

Create a card from contact details or submit card photos for Sansan digitization. Download an existing card image when verification is needed.

/oo Sansan: Create a Sansan business card from [contact details]. If I supply [front JPEG URL] and [back JPEG URL], submit the photos for paid digitization with exchange date [date] and tags [tag IDs].

Record a customer conversation

Save the conversation’s times, participants, location, and notes, optionally for a named owner when using an administrator account.

/oo Sansan: Create a Sansan contact report for [meeting details] with internal participants [user IDs] and external attendees [names and companies]. Use start [time] and end [time], and save [notes].

Maintain the organization directory

Export users and departments, validate proposed changes, submit an import, and retrieve its processing report.

/oo Sansan: Export the Sansan user and department directory. Validate the changes in [user CSV URL] and [department CSV URL], report any errors, and submit the approved changes. Follow the job until its result report is available.

Manage department access and defaults

Inspect and maintain access patterns, assign them to departments, and set the default email client for new users.

/oo Sansan: List Sansan departments and access patterns. Show the pattern assigned to [department]. Apply the specified rules [rules] to pattern [pattern ID] and assign it to [department ID].

Start Working with Sansan

  1. Install OOMOL

    Set up oo CLI and the oo Skill in your agent.

    Install OOMOL →
  2. Connect Sansan

    Connect using a Sansan API Key.

    Connect Sansan→
  3. Give Your Agent a Task

    Use /oo with the pages to read, the changes to make, and where to save the result.

    Connection Guide →
  • A Sansan account with API integration permission and an issued API Key.
  • Available operations inherit the connected user’s permissions; organization and management operations require a system administrator.
  • Business card photo digitization is billed by Sansan. Contact report creation also creates business cards for the supplied external attendees.
  • Organization imports can add, update, or delete users and departments; review the import data and use validation before submission.
  • Image uploads accept JPEG URLs; CSV sources accept UTF-8 file URLs or structured user and department rows.
  • You can connect with an API Key without file transit. Downloading business card images, exporting organization CSV files, and downloading import validation or result reports require file transit to be configured on the Connector service.

Sansan Tools

This integration covers Sansan business cards, people, tags, contact reports, organization exports and imports, department access patterns, and default email client settings.

Find the right contacts

Search by company or name and inspect the latest contact information and tags.

Review recent contact changes

Collect business cards updated during a chosen period, including historical cards when useful.

Prepare a meeting brief

Combine business card details with recorded meetings, calls, and emails.

Check the connected account

Identify which Sansan user owns the connection and review their role and departments.

Save contacts after an event

Create a card from contact details or submit card photos for Sansan digitization. Download an existing card image when verification is needed.

Record a customer conversation

Save the conversation’s times, participants, location, and notes, optionally for a named owner when using an administrator account.

Maintain the organization directory

Export users and departments, validate proposed changes, submit an import, and retrieve its processing report.

Manage department access and defaults

Inspect and maintain access patterns, assign them to departments, and set the default email client for new users.

27 tools

Create Business Card

Create a Sansan business card, optionally for another user through the administrator import API.

sansan.create_business_card

Upload Business Card Image

Submit JPEG business card images for paid Sansan digitization. Optionally use administrator import for another owner.

sansan.upload_business_card_image

Get Business Card Image

Download the front or back of a Sansan business card as a JPEG file URL.

sansan.get_business_card_image

Create Contact Report

Create a Sansan contact report. External attendee details also create new business cards; optionally import for another owner as an administrator.

sansan.create_contact_report

Export Organization Users

Export Sansan organization users as a CSV download. System administrator only.

sansan.export_organization_users

Export Organization Departments

Export Sansan organization departments as a CSV download. System administrator only.

sansan.export_organization_departments

Check Organization Import

Validate user and department import data without applying changes. System administrator only; returns a downloadable CSV report if errors exist.

sansan.check_organization_import

Submit Organization Import

Submit user and department additions, updates, or deletions. System administrator only. DeleteFlag can delete users or departments; preserve the import ID to retrieve results.

sansan.submit_organization_import

Get Organization Import Status

Get the current organization import status. System administrator only.

sansan.get_organization_import_status

Get Organization Import Result

Check an organization import and return its result CSV when completed or failed. System administrator only. The report includes created IDs and row-level errors.

sansan.get_organization_import_result

List Departments

List administrative department IDs, names, and parents. System administrator only.

sansan.list_departments

Get Department Access Control

Get the access control pattern assigned to a department. System administrator only.

sansan.get_department_access_control

Set Department Access Control

Assign an access control pattern to a department. System administrator only.

sansan.set_department_access_control

List Access Control Patterns

List access control patterns, optionally filtering by a name substring. System administrator only.

sansan.list_access_control_patterns

Create Access Control Pattern

Create an access control pattern with department access rules. System administrator only.

sansan.create_access_control_pattern

Update Access Control Pattern

Update an access control pattern and its department rules. System administrator only.

sansan.update_access_control_pattern

Delete Access Control Pattern

Delete an access control pattern. System administrator only; Sansan may reject a pattern still in use.

sansan.delete_access_control_pattern

Get Default Email Client

Get the default email client settings for new users. System administrator only.

sansan.get_default_email_client

Set Default Email Client

Set the default email client for subsequently added users; users may change it later. System administrator only.

sansan.set_default_email_client

Get Current User

Get the Sansan user and permissions associated with the connected API key.

sansan.get_current_user

List Business Cards

List business cards updated within a time interval, with optional historical cards and tags. Use nextPageToken to continue.

sansan.list_business_cards

Search Business Cards

Search accessible Sansan business cards by company, name, email, telephone, mobile, and tags.

sansan.search_business_cards

Get Business Card

Get a business card by ID. Sansan may return the latest merged card with a different ID.

sansan.get_business_card

Get Person

Get the latest business card for a Sansan person, optionally including tags.

sansan.get_person

List Business Card Tags

List tags attached to a Sansan business card.

sansan.list_business_card_tags

List Tags

List Sansan tags by ownership, visibility, owner user, and tag name.

sansan.list_tags

List Contact Reports

List Sansan contact reports updated within a time interval, including meetings, calls, emails, and business card exchanges.

sansan.list_contact_reports

Frequently Asked Questions

Can I search every company’s contacts?

No. Sansan exposes your organization’s records that the connected user is permitted to access.

Why can a retrieved card have a different ID?

Sansan can return the latest card after records are merged.

Are contact reports email inbox messages?

No. They are interactions recorded in Sansan, such as meetings, calls, and emails.

Does image digitization cost extra?

Sansan bills business cards submitted through its image digitization API.

Who can manage organization data?

The organization and management APIs require a Sansan system administrator. An API key alone does not grant those permissions.