Skip to main content

Importing Data via sFTP (for integrated customers)

E
Written by Elbert Pranoto

1. sFTP Connection Details

Protocol

SFTP (SSH File Transfer Protocol)

Port

22

Supported Authentication Method

SSH Authentication

Each Sapia.ai data center operates its own dedicated SFTP server. Please connect to the appropriate region based on your server location and use the IP addresses listed below for whitelisting purposes if required. If you are not sure about your region, contact Sapia.ai

Region

sFTP Endpoint URL

IP Addresses

AU
(ap-southeast-2)

s-68b2a2cc4a4f49f9a.server.transfer.ap-southeast-2.amazonaws.com

15.134.76.92

13.237.199.78

EMEA
(eu-west-1)

s-7fb77caa27314a839.server.transfer.eu-west-1.amazonaws.com

54.155.36.192

54.195.21.137

US
(us-east-1)

s-a09eae11de474a8c8.server.transfer.us-east-1.amazonaws.com

52.0.164.228

54.204.101.64

2. Setup and Requirements

  1. Generate your SSH key pair (public and private keys) with the supported algorithm (See below)

  2. Submit your public key (.pub file) to Sapia.ai

  3. Sapia.ai will issue your SFTP username, the SFTP address and other details upon receipt

Important: Keep your private key secure and never share it. Only the public key should be sent to Sapia.ai.

3. Supported Algorithms for SSH/SFTP Authentication

Use one of the following algorithms when generating SSH key pairs:

  • RSA (Recommended)

Compatible with most SSH clients and servers, and FIPS-compliant. Use with SHA-2 hashing for enhanced security:

rsa-sha2-256

rsa-sha2-512

  • ECDSA

ecdsa-sha2-nistp256

ecdsa-sha2-nistp384

ecdsa-sha2-nistp521

4. How to connect

To establish SFTP connectivity, you'll need:

  • SFTP Username: Provided by Sapia.ai after SFTP account setup is complete and your public key file has been received.

  • Private Key File: For secure authentication (you retain this)

  • Public Key File: Must be supplied to Sapia.ai

  • SFTP Address: Provided by Sapia.ai after SFTP account setup is complete and your public key file has been received.

5. Important Setup Notes

  • SFTP Account Structure
    Each Sapia.ai customer ID is assigned one dedicated SFTP account. If your organization uses multiple customer IDs, you will have a separate SFTP connection for each.

  • User Permissions
    SFTP accounts have the following permissions:

    • Read and write access to files

    • No permissions to create, modify, or delete folders

  • Folder Structure
    Sapia.ai creates and maintains all folders in your SFTP directory. These folders are organized by data type:

    • StatusChangeData — Status change data (outcome) of candidate applications progressing post Sapia.ai's assessment

    • DemographicsData — Candidate demographic information

    • LeaverData — Candidate/Employee departure data

    • Additional folders as configured for your tenant (if any)


    Files placed in these folders will be processed automatically according to the field mapping and configuration set in your Sapia.ai tenant.

Did this answer your question?