Add or merge up to 200 leads in one call
Save a batch of researched companies. Prefer this over POST /leads when you have more than one. Default on_duplicate is merge, so re-researching a company refreshes it instead of duplicating it. Each row is saved independently and reported in results with created, merged, skipped or failed plus an error message for failed rows; the call still succeeds when some rows fail. Answers 402 free_plan_limit_reached when the batch would cross the free plan cap.
https://app.softsolz.uk/api/v1/services/my-leads/leads/bulkRecent Requests
Kept only in this browserHeaders
AuthorizationstringrequiredBearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.
Idempotency-KeystringOptional idempotency key for safe retries.
Body Params
leadsarray of objectsrequiredUp to 200 leads, each shaped like the POST /leads body.
on_duplicatestringWhat to do when a lead with the same external_id, domain or contact email already exists: error (409 duplicate_lead with existing_id), merge (fill blanks, merge sections, union tags), skip, or create a second record.
Response
Response Body
resultsarray of objectsOne entry per row, in request order.countsobjectTotals: { created, merged, skipped, failed }.Request
curl --request POST \ --url https://app.softsolz.uk/api/v1/services/my-leads/leads/bulk \ --header 'Authorization: Bearer sk_live_your_key' \ --header 'Content-Type: application/json' \ --data '{ "leads": [ { "name": "Example Bakery", "website": "example.com", "fit_score": 87 } ], "on_duplicate": "merge"}'Credentials
Sent as a Bearer token and used in the samples above and in Try it. Kept only in this browser tab until you close it. Use an sk_test_ key to stay in your sandbox.
Response · 201
{ "data": { "results": [ { "index": 0, "action": "created", "matched_on": null, "lead": { "id": 42, "run_id": null, "name": "Example Bakery", "website": "https://example.com", "domain": "example.com", "external_id": "crm-1001", "source": "api", "via": "connected_app", "via_label": "Claude", "fit_score": 87, "lead_score": 64, "confidence": 0.8, "verification_tier": "verified", "verified_contact_count": 2, "lead_status": "new", "industry": "Food", "city": "Manchester", "state": "Greater Manchester", "country": "United Kingdom", "employee_band": "11-50", "revenue_band": "1M-10M", "source_url": "https://example.com/about", "owner_user_id": 7, "owner_name": "Priya", "owner_email": "priya@example.com", "tags": [ "manchester", "q4" ], "last_contacted_at": null, "company_id": null, "contact_id": null, "deal_id": null, "result": { "description": "Independent bakery chain with four shops in Manchester.", "contact": { "contact_email": "hello@example.com", "phone": "+44 161 000 0000" }, "social": { "linkedin": "https://linkedin.com/company/example" }, "insights": { "why_fit": "Growing fast, still on spreadsheets.", "pain_points": [ "manual invoicing" ] }, "fit_breakdown": { "industry": { "weight": 0.4, "subscore": 90 } }, "analysis": { "what_they_do": "Retail bakery", "decision_maker": "Owner" }, "size_detail": { "years_in_business": 12 }, "tech_stack": { "cms": "Shopify", "technologies": [ "Klaviyo" ] }, "financial_indicators": { "funding": "Bootstrapped" }, "website_intel": { "has_pricing_page": true }, "registry_info": { "legal_name": "Example Bakery Ltd" }, "activity": { "latest_news": [ "Opened a fifth shop in 2026" ] }, "hiring": { "hiring_active": true, "open_roles": [ "Shop manager" ] }, "reviews": { "google_rating": 4.6, "google_review_count": 312 }, "sources": [ "https://example.com/about" ], "employee_estimate": 45, "revenue_estimate_usd": 2500000, "num_locations": 4, "cities_operating": [ "Manchester", "Salford" ], "crm": "HubSpot", "erp": "Odoo" }, "created_at": "2026-09-01T09:00:00.000Z", "updated_at": "2026-09-02T09:00:00.000Z" }, "error": null } ], "counts": { "created": 8, "merged": 2, "skipped": 0, "failed": 0 } }}