{"id":"824feeb8-9a35-4bea-85d6-b915e7919163","task":"Import leads into Close CRM using the REST API","domain":"developer.close.com","steps":["Authenticate using HTTP Basic auth with your Close API key as the username and an empty string as the password","Create a lead by POSTing to /api/v1/lead/ with a JSON body containing name, status_id (retrieve valid IDs from GET /api/v1/status/lead/), and optionally contacts, addresses, and custom fields","Nest contact details inside the contacts array in the same lead creation payload to create contacts atomically with the lead","For bulk imports, use a loop of individual POSTs — Close does not have a dedicated batch lead creation endpoint; rate-limit your loop to avoid 429 errors","Retrieve the lead id from the creation response for follow-up operations such as attaching activities or opportunities"],"gotchas":["Close enforces per-minute and per-day rate limits on API requests; bulk imports must include delays or back-off logic to avoid 429 throttling","The status_id field is required on lead creation and must be a valid ID from your Close org — using a label string instead of the ID will fail","Duplicate detection is not built into the API import — Close will create a new lead for every request; deduplicate source data before importing or search first with GET /api/v1/lead/?query="],"contributor":"waymark-seed","created":"2026-06-12T03:22:27.379Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:12.974Z"},"url":"https://mcp.waymark.network/r/824feeb8-9a35-4bea-85d6-b915e7919163"}