← Back to onboarding education
Using CSV upload for orders
How to submit orders via CSV: template, columns, and workflow. Start with CSV and add API when you're ready.
Many merchants manage orders or stops in spreadsheets. We support CSV upload so you can send us runs without building an integration first. You get a template or specification; you fill it, upload (or email), and we run the route. This page covers how CSV upload works and how to use it for recurring or one-off delivery.
Template and columns
We provide a CSV template or spec with the required columns: delivery address (or street, city, postal), contact name, phone or email, and any time window or reference ID. Optional columns might include notes, special instructions, or weight. Once you’re set up, you can reuse the same format for every run. We’ll confirm the exact columns and any rules (e.g. date format, phone format) during onboarding so your file is accepted every time.
How to submit
You upload the CSV through our portal or send it by email, depending on how we’ve set you up. The file is validated and turned into stops for the run. You’ll get confirmation and can track the route in your dashboard. For recurring routes, you send an updated file each cycle (e.g. every Monday for Tuesday delivery). Same process, same format — no need to re-enter data manually.
Moving to API later
CSV is a great way to start. When you’re ready to automate, we support API so your system can push orders directly. Many merchants start with CSV and add API when their volume or workflow justifies it. We’ll help with the transition so there’s no disruption — same data, same routing, just a different submission method.