How Do I Set Up a File Upload Integration?

Last updated: November 16, 2026

A File Upload integration is for data you upload by hand, one file at a time, from inside Ambition. There are no servers or credentials involved, which makes it handy for weekly or monthly totals that come from a spreadsheet.

Required permissions:

  • The Integrations: Edit permission is required to set up a File Upload integration.

Enable the File Upload Integration

  1. Navigate to Admin --> Data --> Integrations.

  2. Search for "File Upload" in the Find an integration search box on the Available tab.

  3. Click on Enable in the File Upload row, and the integration's Settings page will load.

Add the Integration Owner's Name and Contact Information

  1. Give the integration a clear name in the Integration Name field, such as "Monthly Revenue Upload".

  2. Type the contact email for upload problems in the Admin Email Address field.

  3. Click on Save to keep your changes.

Add the Record Fields to the Data Format Page

  1. Click on Data Format under Setup in the integration's side menu.

  2. Select the CSV or JSON radio button in the Data Format section to match the type of file you'll upload.

  3. Select a radio button in the Data Schema section to describe how your file's rows are built:

    • Records means each row is one item, such as a single sale or call.

    • Daily Totals means each row is one employee's total for one day.

  4. Click on Add Field Mapping to add a row for one column in your file.

  5. Type the column's name, exactly as it appears in your file, in the Field Key field.

  6. Type the name you want shown across Ambition in the Display Name field.

  7. Select the kind of information the column holds, such as Email Address, Date, or Number, from the Field Type drop-down menu.

  8. Repeat steps 4–7 for every column you want Ambition to read.

Save Your Changes

  1. Click on Save Data Format, and the Please confirm before saving pop-up will show a summary of how users and dates will be read.

  2. Type "I UNDERSTAND" in the text box.

  3. Click on Confirm to save the format.

Note:

  • The File Upload Integration will automatically be set to Sandbox Mode, which is standard for all new integrations.


Related Articles