Skip to main content
A CSV can supply many records to one Play run. Choose a Play that accepts CSV input, such as a batch prebuilt Play. Its input requirements define which columns your file needs; its results depend on what the Play does. Replace leads.csv and the email task in the prompt with your file and desired result.

In the web app

  1. Open a CSV-capable Play from Tools > Prebuilt plays.
  2. Open the Play’s start control and choose Run here.
  3. Drop your CSV into the file input, or select browse to choose it.
  4. Check the detected row count and columns. Correct any missing required headers and fill in other required inputs.
  5. Select Run when you are ready to start the work and its applicable usage.
Attaching a file selects the input. The work starts when you select Run. Run Plays and view results explains how to follow the run and inspect its results.

Prepare the file

Use a header row with the column names required by the selected Play. For example, a work-email Play can require first name, last name, and company domain. If your headers differ, rename them or ask your agent to prepare the column mapping. If a Play accepts only one record, choose a batch Play or ask your agent for a CSV-capable alternative. Use Choose a prebuilt Play to find one that accepts your CSV.
Start with a few representative rows. Keep a source ID column so you can match results back to the input. Review matches, unresolved rows, errors, and usage before running the full file.
Next, Run Plays and view results with your selected Play and prepared input. Agent guide: CLI and SDK instructions →