Getting Started

Quickstart

Create your first review queue and submit a task in 5 minutes.

Prerequisites

  • A Datashift account — sign up free
  • Node.js 18+ or Python 3.9+
1

Create a Queue

Go to Queues in the Console and click Create Queue.

NameData Enrichment
Review TypeApproval
AssignmentManual

Note the Queue Key (e.g., data-enrichment) — you'll need it in Step 3.

2

Create an API Key

Go to Settings → Credentials and click New API Key.

Copy the API key. Store it securely — you won't see it again.

bash
DATASHIFT_API_KEY=ds_xxxxxxxxxxxxxxxx
3

Submit a Task

Install the SDK:

npm install @datashift/sdk

Connect to Datashift and submit enriched data for verification:

import { Datashift } from '@datashift/sdk';

const datashift = new Datashift({
  apiKey: process.env.DATASHIFT_API_KEY,
});

// Submit enriched data for human verification
const task = await datashift.submitTask({
  queueKey: 'data-enrichment',
  data: {
    companyId: 'comp_456',
    original: { name: 'Acme Corp', industry: null, employees: null },
    enriched: { name: 'Acme Corporation', industry: 'Software', employees: '50-200' },
    source: 'clearbit',
  },
  summary: 'Verify enriched data for Acme Corp',
});

console.log('Task submitted:', task.id);

// Poll for result (or use webhooks for real-time)
let result = await datashift.getTask(task.id);
while (result.state === 'queued' || result.state === 'in_review') {
  await new Promise(r => setTimeout(r, 5000));
  result = await datashift.getTask(task.id);
}

if (result.reviews[0]?.result.includes('approved')) {
  console.log('Approved! Updating CRM...');
} else {
  console.log('Rejected:', result.reviews[0]?.feedback);
}
4

Review the Task

Open the Console and navigate to your queue. You'll see the pending task.

Click to open it, review the enriched data, and click Approve or Reject. Your agent receives the decision instantly.