Upload an email list

curl "https://simplecold.com/api/v1/api-validation/bulk" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "[email protected];type=text/csv"

import { readFile } from "node:fs/promises";
import { basename } from "node:path";

const API = "https://simplecold.com/api/v1";
const apiKey = process.env.SIMPLECOLD_API_KEY;

async function upload(path) {
  const form = new FormData();
  const blob = new Blob([await readFile(path)], { type: "text/csv" });
  form.append("file", blob, basename(path));

  const res = await fetch(`${API}/api-validation/bulk`, {
    method: "POST",
    headers: { Authorization: `Bearer ${apiKey}` }, // no Content-Type: fetch adds the multipart boundary
    body: form,
  });
  const body = await res.json();
  if (!res.ok) throw new Error(`upload failed: ${body.message ?? body.error}`);
  return body.payload;
}

const job = await upload("q3-webinar-leads.csv");
console.log(`job ${job.id}: ${job.totalEmails} emails, ${job.status}`);

import os
import requests

API = "https://simplecold.com/api/v1"
API_KEY = os.environ["SIMPLECOLD_API_KEY"]

with open("q3-webinar-leads.csv", "rb") as f:
    res = requests.post(
        f"{API}/api-validation/bulk",
        headers={"Authorization": f"Bearer {API_KEY}"},
        files={"file": ("q3-webinar-leads.csv", f, "text/csv")},
        timeout=300,
    )

body = res.json()
if not res.ok:
    raise RuntimeError(f"upload failed: {body.get('message') or body.get('error')}")

job = body["payload"]
print(job["id"], job["totalEmails"], job["status"])

<?php
const API = 'https://simplecold.com/api/v1';

$ch = curl_init(API . '/api-validation/bulk');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    // No Content-Type header: curl sets multipart/form-data with the boundary.
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('SIMPLECOLD_API_KEY')],
    CURLOPT_POSTFIELDS => [
        'file' => new CURLFile('q3-webinar-leads.csv', 'text/csv', 'q3-webinar-leads.csv'),
    ],
    CURLOPT_TIMEOUT => 300,
]);
$body = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
if ($status >= 400) {
    throw new RuntimeException('upload failed: ' . ($body['message'] ?? $body['error'] ?? $status));
}

$job = $body['payload'];
echo $job['id'], ' ', $job['totalEmails'], ' ', $job['status'], PHP_EOL;