Hand a lead to the CRM as a company, a contact and optionally a deal
Create (or reuse, matched by domain and email) a CRM company and contact for this lead and link them back, so converting twice never duplicates. Send create_deal true to also open a deal on the default sales board (or pipeline_id and stage_id for a specific one); creating a deal additionally needs the service.pipelines.create scope and answers 403 deal_not_allowed without it. Answers 409 no_pipeline when the workspace has no sales board yet.
https://app.softsolz.uk/api/v1/services/my-leads/leads/{id}/convertRecent Requests
Kept only in this browserPath Params
idstringrequiredHeaders
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
create_dealbooleanAlso open a deal. Needs a sales board in Pipelines first.
pipeline_idstringSales board for the deal; defaults to the default board.
stage_idstringStage for the deal; defaults to the first stage.
contactobjectOverride the contact person: { full_name, email, phone }. Defaults to the researched contact details.
dealobjectDeal details: { title, value_cents, currency, expected_close_on, owner_user_id, notes }. Title defaults to the company name.
Response
Response Body
leadobjectThe lead with its CRM links filled in.linksobjectCRM ids now linked to the lead: { company_id, contact_id, deal_id }.createdobjectWhich records were created by this call: { company, contact, deal }.Request
curl --request POST \ --url https://app.softsolz.uk/api/v1/services/my-leads/leads/{id}/convert \ --header 'Authorization: Bearer sk_live_your_key' \ --header 'Content-Type: application/json' \ --data '{ "create_deal": false, "contact": { "full_name": "Sam Baker", "email": "sam@example.com" }, "deal": { "title": "Example Bakery - bookkeeping", "value_cents": 120000 }}'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 · 200
{ "data": { "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" }, "links": { "company_id": "c1", "contact_id": "p1", "deal_id": null }, "created": { "company": true, "contact": true, "deal": false } }}