What we need from you
Share the items below with your Conflixis contact to begin provisioning your SFTP integration. Use the secure channel they provide for anything marked sensitive — do not send secrets over email.
Connection details
Section titled “Connection details”| Field | Example | Notes |
|---|---|---|
host |
sftp.example.com |
Hostname or IP Conflixis will connect to. |
port |
22 |
Standard SFTP port; non-standard ports are supported. |
username |
conflixis |
A dedicated user scoped only to the import folder. |
basePath |
/uploads/conflixis |
Absolute path to the folder we should monitor. |
filePattern |
*.csv |
Glob that describes which files we should pick up. |
Authentication
Section titled “Authentication”Pick one of the two supported methods. Key authentication is strongly preferred.
- RSA key authentication — you generate a keypair, install the public key on your SFTP server, and securely share the private key with Conflixis.
- Password authentication — you set a password on the dedicated user and share it with Conflixis.
File details
Section titled “File details”| Field | Example | Notes |
|---|---|---|
| File type | people |
What Conflixis should do with matching files. Supported: people, supplier. |
| Column headers | See below | The CSV → field mapping is configured once in the Conflixis app — not sent with the connection details. |
| Expected cadence | Weekly, Mondays |
So we can alert if a file is unexpectedly late. |
Column mapping
Section titled “Column mapping”You don’t need to rename your CSV headers or send us a mapping file. The CSV → field mapping is configured once, inside the Conflixis app, and remembered for every future delivery.
The first time a file arrives for an organization that has no saved mapping, Conflixis parks it (it is not auto-imported) and an admin maps the columns in the import UI. From then on, files of the same shape import automatically.
To make that first setup quick, share your file’s header names — and which Conflixis field each one represents — with your Conflixis contact ahead of your first delivery. For example:
First Name → first_nameLast Name → last_nameWork Email → emailStaff No. → employee_idYour Conflixis contact will provide the full list of supported field keys for the file type you’re loading.
If a later file drops or renames a column the saved mapping depends on, that file is rejected with a schema-drift error and parked until an admin updates the mapping in the app.
Network access
Section titled “Network access”If your SFTP server is behind a firewall or allowlist, your network team will need to permit inbound connections from Conflixis. Your Conflixis contact will provide the current source IP range for our ingestion worker.
Summary checklist
Section titled “Summary checklist”- Host, port, and username for a dedicated Conflixis SFTP user.
- Absolute
basePathto a folder used only for this integration. - File pattern (for example,
*.csv). - File type (
peopleorsupplier). - Your file’s header names shared with your Conflixis contact (the mapping itself is configured in-app after the first delivery).
- One authentication method selected (key or password).
- Network/firewall allowlist updated if required.
- Expected upload cadence communicated to your Conflixis contact.