import / export

Import and export let you move data in and out of MossDesk in bulk. Use import template to get the right CSV format, import create to upload, and export create to download your data.

Import Commands

moss import template

Generate a CSV template with the correct headers and an example row. Use this to prepare your import file.

moss import template --entity-type contacts
moss import template --entity-type companies
moss import template --entity-type deals

Option	Required	Description
`--entity-type <type>`	Yes	Entity type: `contacts`, `companies`, or `deals`

Example output for contacts:

first_name,last_name,email,phone,title,linkedin_url,notes
Jane,Smith,jane@acme.com,+1-555-0100,CTO,https://linkedin.com/in/janesmith,Met at SaaStr 2026

Run moss import template --entity-type contacts > contacts.csv, fill in your data, then upload it.

moss import create

Start a data import job. The file must be accessible via URL.

moss import create \
  --entity-type contacts \
  --file-url "https://storage.example.com/contacts.csv"

Option	Required	Description
`--entity-type <type>`	Yes	Entity type: `contacts`, `companies`, or `deals`
`--file-url <url>`	Yes	URL of the file to import

Returns a job ID that you can use to check status.

moss import status

Check the status of an import job.

moss import status --id job_abc123

Option	Required	Description
`--id <id>`	Yes	Import job ID

moss import status --id job_abc123 --json

{
  "data": {
    "id": "job_abc123",
    "entity_type": "contacts",
    "status": "completed",
    "total_rows": 150,
    "imported_rows": 148,
    "failed_rows": 2,
    "created_at": "2026-02-08T12:00:00Z",
    "completed_at": "2026-02-08T12:01:30Z"
  }
}

Export Commands

moss export create

Start a data export job.

moss export create --entity-type contacts --format csv

Option	Required	Description
`--entity-type <type>`	Yes	Entity type: `contacts`, `companies`, or `deals`
`--format <format>`	No	Export format: `csv` (default) or `json`

Returns a job ID that you can use to check status and download the file.

moss export status

Check the status of an export job.

moss export status --id job_def456

Option	Required	Description
`--id <id>`	Yes	Export job ID

moss export status --id job_def456 --json

{
  "data": {
    "id": "job_def456",
    "entity_type": "contacts",
    "format": "csv",
    "status": "completed",
    "download_url": "https://storage.mossdesk.com/exports/job_def456.csv",
    "created_at": "2026-02-08T12:00:00Z",
    "completed_at": "2026-02-08T12:00:45Z"
  }
}

Overview

Authentication

CRM Data

Views & Search

Operations

Import Commands

moss import template

moss import create

moss import status

Export Commands

moss export create

moss export status

​Import Commands

​moss import template

​moss import create

​moss import status

​Export Commands

​moss export create

​moss export status

Import Commands

moss import template

moss import create

moss import status

Export Commands

moss export create

moss export status