File Format

In order to facilitate a smooth data ingestion process, it is essential that the files uploaded via SFTP conform to a specified CSV format. This section outlines the required naming convention and the expected structure of the CSV files for different types of records. Adhering to these guidelines ensures your data can be processed accurately and without delay.

Naming Convention

Each file uploaded should be named according to the following pattern:

{{File Type}}-{{App Id}}-{{Timestamp}}.csv

Components Explained

  • {{File Type}}: This component specifies the type of records contained within the file, dictating the processing logic that will be applied. The available options are:

    • custom_attributes
    • events (Note: This option is Coming Soon)
    • users
  • {{App Id}}: This is an internal identifier created by Pulsate and provided to you. It is essential for naming your file correctly.

  • {{Timestamp}}: This should be a string formatted as a Unix timestamp at the time of file creation.

File Types

You can find specific details for each file type in each of the below pages.

Uploading Custom Attributes

Uploading Users


What’s Next