Import / Export

Create an import

Start an asynchronous import job. Import creation requires owner role.

POST /api/v1/imports

string

required

Entity type: contacts, companies, or deals

string

required

URL of the file to import (must be accessible)

Example

curl -X POST https://api.mossdesk.com/api/v1/imports \
  -H "X-API-Key: moss_k_..." \
  -H "Content-Type: application/json" \
  -d '{
    "entity_type": "contacts",
    "file_url": "https://storage.example.com/contacts.csv"
  }'

Response

{
  "data": {
    "id": "imp_abc123",
    "entity_type": "contacts",
    "status": "pending",
    "created_at": "2026-02-08T12:00:00Z"
  }
}

Get import status

GET /api/v1/imports/:id

Response

{
  "data": {
    "id": "imp_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"
  }
}

Import statuses: pending, processing, completed, failed.

Create an export

Start an asynchronous export job.

POST /api/v1/exports

string

required

Entity type: contacts, companies, or deals

string

default:"csv"

Export format: csv or json

Example

curl -X POST https://api.mossdesk.com/api/v1/exports \
  -H "X-API-Key: moss_k_..." \
  -H "Content-Type: application/json" \
  -d '{ "entity_type": "contacts", "format": "csv" }'

Get export status

GET /api/v1/exports/:id

Response

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

Export statuses: pending, processing, completed, failed. The download_url is available once the status is completed.

Overview

CRM Resources

Views & Search

Operations

Create an import

Response

Get import status

Response

Create an export

Get export status

Response

​Create an import

​Response

​Get import status

​Response

​Create an export

​Get export status

​Response

Create an import

Response

Get import status

Response

Create an export

Get export status

Response