Zero-touch kickoff

# 1. DEDUP — anything already linked to this record of ours?
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.onramp.us/v1/projects?external_id=CD-0001&limit=1"
# → data.pagination.total == 0 means safe to create

# 2. CREATE (dates are MM/DD/YYYY here — see the footgun note below)
curl -X POST -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{
    "name": "Cascade Dental — Portland onboarding",
    "playbook_uuid": "PLAYBOOK_UUID",
    "account": "Cascade Dental",
    "start_date": "09/01/2026",
    "due_date": "09/15/2026",
    "project_owner": "csm@yourco.example",
    "customer_users": ["portland@cascadedental.example"],
    "send_invite_email_customers": false
  }' \
  "https://api.onramp.us/v1/projects"
# → note data.uuid in the response

# 3. BACK-REFERENCE — your record id becomes the dedup key
curl -X POST -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{
    "integration_uuid": "YOUR_INTEGRATION_UUID",
    "external_id": "CD-0001",
    "external_type": "site",
    "external_label": "Site CD-0001 in FleetDB",
    "external_link": "https://fleetdb.example.com/sites/CD-0001"
  }' \
  "https://api.onramp.us/v1/projects/PROJECT_UUID/external-links"

# 4. SEED DATA FIELDS — dry_run DEFAULTS TO TRUE; flip it to write
curl -X PUT ... # first look up the project's datafield value uuids, then:
curl -X POST -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"updates": {"DATAFIELD_VALUE_UUID": "2026-09-15"}, "dry_run": false}' \
  "https://api.onramp.us/v1/datafield-values"

import requests

BASE = "https://api.onramp.us/v1"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}

def kickoff(site):  # site = one row of your system's data
    # 1. DEDUP — your record id is the idempotency key
    existing = requests.get(f"{BASE}/projects", headers=HEADERS, params={
        "external_id": site["external_id"], "limit": 1,
    }).json()["data"]["pagination"]["total"]
    if existing:
        return "already exists"

    # 2. CREATE (start_date is MM/DD/YYYY — the one US-format field)
    project = requests.post(f"{BASE}/projects", headers=HEADERS, json={
        "name": f"{site['site_name']} onboarding",
        "playbook_uuid": "PLAYBOOK_UUID",
        "account": "Cascade Dental",
        "start_date": site["start_date_mmddyyyy"],
        "project_owner": "csm@yourco.example",
        "customer_users": [site["site_contact_email"]],
        "send_invite_email_customers": False,  # invite later, deliberately
    }).json()["data"]

    # 3. BACK-REFERENCE — makes step 1 work forever after
    requests.post(f"{BASE}/projects/{project['uuid']}/external-links",
                  headers=HEADERS, json={
        "integration_uuid": "YOUR_INTEGRATION_UUID",
        "external_id": site["external_id"],
        "external_type": "site",
        "external_label": f"Site {site['external_id']}",
    })
    return project["uuid"]

const BASE = "https://api.onramp.us/v1";
const HEADERS = {
  Authorization: "Bearer YOUR_API_KEY",
  "Content-Type": "application/json",
};

async function kickoff(site) {
  // 1. DEDUP
  const dupCheck = await (await fetch(
    `${BASE}/projects?external_id=${encodeURIComponent(site.external_id)}&limit=1`,
    { headers: HEADERS },
  )).json();
  if (dupCheck.data.pagination.total > 0) return "already exists";

  // 2. CREATE (start_date is MM/DD/YYYY)
  const project = (await (await fetch(`${BASE}/projects`, {
    method: "POST", headers: HEADERS,
    body: JSON.stringify({
      name: `${site.site_name} onboarding`,
      playbook_uuid: "PLAYBOOK_UUID",
      account: "Cascade Dental",
      start_date: site.start_date_mmddyyyy,
      project_owner: "csm@yourco.example",
      customer_users: [site.site_contact_email],
      send_invite_email_customers: false,
    }),
  })).json()).data;

  // 3. BACK-REFERENCE
  await fetch(`${BASE}/projects/${project.uuid}/external-links`, {
    method: "POST", headers: HEADERS,
    body: JSON.stringify({
      integration_uuid: "YOUR_INTEGRATION_UUID",
      external_id: site.external_id,
      external_type: "site",
      external_label: `Site ${site.external_id}`,
    }),
  });
  return project.uuid;
}