📡 How often does Gable sync with the SFTP directory?
SFTP directories sync every 30 minutes following the initial synchronization. No manual refresh or configuration is required.
📂 What file formats are supported?
CSV format is required.
Other formats (TXT, XLSX, etc.) are not supported at this time.
🧭 Are there header requirements or a sample file?
Yes. A specific set of headers is required to ensure successful processing of your file.
👉 Please refer to the SFTP setup documentation under the “What you will need” section to view the required headers and sample file format.
🧹 How are inactive or terminated users handled?
When a user is removed from your SFTP file:
Gable will automatically detect the change during the next sync (within 30 minutes).
The user will move to the “Deleted” tab in Gable.
Their access to the platform will be automatically revoked.
No manual steps are required.
📝 Are there character length limits or special character restrictions?
No — there are no character limits or restrictions on special characters for SFTP file fields.
👤 How do workflow approvals work with SFTP?
Approvals are defined within the Gable platform, not in the SFTP file itself.
Approval roles can be configured in Company Users.
Approval thresholds and workflows are set in Settings.
Department heads or admins can be designated as approvers.
🧾 Which fields are required?
Field Name | Required | Notes |
First Name | ✅ | Preferred or legal — your choice |
Last Name | ✅ | Preferred or legal — your choice |
Email Address | ✅ | Also used as a unique identifier |
Location | ✅ | For invoicing and recommendation logic |
Department | Optional | Useful for budgeting, reporting, and access control |
Job Title | Optional | Included for reporting clarity |
User ID (or Person ID) | ✅ | Can be email or another unique identifier |
Cost Center / BU / Div. | Optional | Useful if you’re doing chargebacks or cost reporting |
Manager First/Last Name | Optional | Used if you want to include managers as approvers in the platform |
🏠 Do we need to include personal addresses?
No. Gable does not require or recommend including personal home addresses.
You can provide only city, state, or country level data — depending on how granular your reporting, budgeting, or restrictions need to be.
💡 If your company uses Gable Company Offices, mapping office names to a column can help calculate office occupancy and utilization.
🏢 What about employment location (office vs. remote)?
You can provide:
Office name (if using Gable Company Offices)
Or leave blank if this is not relevant to your setup.
This is used to:
Improve booking recommendations
Inform reporting and utilization metrics
🧮 Department, Division, and Cost Center
These fields are optional but recommended if your organization wants to:
Invoice by department or cost center
Apply booking restrictions or budget caps
Report usage trends by department
👩💼 Manager Information
Manager names can be included in the file if you want to assign approvals to department heads.
Approvals are still be managed through Gable Admin settings.
Automated mapping for managers is planned in a future update.
🧭 Additional Notes & Best Practices
🕒 Keep file updates consistent — changes are picked up automatically on the next 30-minute sync.
📋 Avoid unnecessary fields.
🧑💻 Department and location fields enable better budgeting, reporting, and access control in Gable.
✅ Reference the linked guide here if you have any further questions or concerns.
🆘 Need Support?
If you run into issues with your SFTP connection or file format:
💬 Chat with us through the in-app widget
📧 Email support@gable.to