Search documentation...

K

Salesforce Marketing Cloud File Drop

Import and extract data in Salesforce Marketing Cloud with File Drop Automations

Note on Data Extensions

This destination has been deprecated in favor of our standard SFMC destination, which now contains its own robust FTP drop that inclues the automatic creation of Data Extensions and execution of Import Definitions.
This destination only uploads a file to the SFMC server. You are required to manually configure and run an Import Definition for that file.

Setup

To get started, you will need your FTP URL, username, and credentials. You can create an FTP user in the Salesforce Marketing Cloud console under Settings > Administration > Data Management > FTP Accounts.
Port 22 will always be used.

Supported Authentication Methods

We support three authentication methods:
  • Username + password
  • Username + SSH private key
  • Username + SSH private key + passphrase
We support two formats for the SSH private key:
  • OpenSSH
  • RSA
Provide the full private key for the user, including the header and footer.
For example:
-----BEGIN OPENSSH PRIVATE KEY-----
<private key body>
<private key body>
<private key body>
-----END OPENSSH PRIVATE KEY-----

Syncing

This destination ignores the concept of additions, changes, removals and will send the full results of your model. For example, if your model has 1,000 records, your csv results file will be 1,000 records.

File Name

The file name field will allow you to specify which directory and the name of the file that you want to name your results. The parent directory for the file must exist. Import/ will be added to the beginning of the given path. For example, with the configuration in the screenshot below, the file results.csv will be written to path Import/results.csv.
You can also timestamp variables in the file name, surrounding each with {}. We currently support these timestamp variables: YYYY, MM, DD, HH, mm. All dates and times will be UTC.
For example: {YYYY}-{MM}-{DD}-{HH}-{mm}-result.csv.

Columns to Sync

For this destination, we give you the ability to export all columns as they are represented in your model.
If you need remap the fields that you're exporting, maybe because you don't want to alter your model, you can manually map fields. Only the fields that you map will be exported in this instance. In this example, we're just exporting id, email and location. These fields are mapped to the new fields in the csv as user_id, user_email and user_location respectfully. All other columns from your results are ignored.

Format and Encoding

The synced file will include a CSV header.
By default, the file will be saved in ASCII encoding. If there are any non-ASCII characters in your results, the file will be saved with utf-8 encoding.
The file will not contain a Byte Order Mark (BOM).

Other Considerations

This destination will not respect any sorting that you have in your model. It will export the target file sorted by ID.
You will need to ensure that the file that you transmit is processed from the folder before the next sync runs, or else it will be overwritten with the next sync that uses the same filename.

    Need help?

    Our team is relentlessly focused on your success. We're ready to jump on a call to help unblock you.

    • Connection issues with your data warehouse?
    • Confusing API responses from destination systems?
    • Unsupported destination objects or modes?
    • Help with complex SQL queries?

    or

    Feature Requests?

    If you see something that's missing from our app, let us know and we'll work with you to build it!

    We want to hear your suggestions for new sources, destinations, and other features that would help you activate your data.

On this page

Note on Data ExtensionsSetupSupported Authentication MethodsSyncingFile NameColumns to SyncFormat and EncodingOther Considerations

Was this page helpful?