Importing Data into Better Data

Connect your ERP, WMS, or OMS to Better Data using the import API or CSV upload.

Overview

Better Data accepts data via a REST import API. All imports are:

• Async - each request returns a jobId; poll GET /api/import/status/[jobId] for completion
• Idempotent - re-running an import with the same external reference IDs will not create duplicates
• Partial-success - row-level errors are reported per record; a single bad row does not fail the whole batch

Import Order

Always import in this sequence. Later resources depend on earlier ones.

Locations are configured during account setup and are not imported via the API. Contact support to add or modify locations.

Quick Start

Download a CSV template, fill it in, and upload via the API or the in-app importer.

Download templates

Get pre-formatted CSV templates for every resource.

API reference

Full REST API docs for all import endpoints.

Fivetran / ERP connectors

Map your NetSuite, SAP, or Shopify data to Better Data fields.

Field mappings

Field-by-field reference with ERP analogs and constraints.

Authentication

All import endpoints require an API key in the x-api-key header.

curl -X POST https://api.betterdata.co/api/import/catalog \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "products": [...] }'

Generate API keys at: apps.betterdata.co -> Settings -> API Keys

Checking Import Status

curl https://api.betterdata.co/api/import/status/job_abc123 \
  -H "x-api-key: YOUR_API_KEY"

Response:

{
  "jobId": "job_abc123",
  "status": "COMPLETED",
  "rowCount": 142,
  "processedCount": 142,
  "failedCount": 0,
  "errors": [],
  "completedAt": "2026-03-01T10:00:04Z"
}

Status values: PENDING -> PROCESSING -> COMPLETED | FAILED