Start setting up a business from a template
Creates a client workspace for the business and a draft client in status draft. Nothing is built and no AI credits are spent until you call POST /clients/{id}/build. Use a live key: a test key answers 409 launchpad_live_only. The key must belong to a member, who becomes the first owner of the new workspace (403 api_key_owner_required otherwise). Errors: 400 starter_not_found, company_name_required, text_has_link (a name holds a link or an email address), invalid_email, invalid_phone or invalid_website; 402 agency_free_clients_limit when you already have the most unpaid client workspaces allowed; 409 agency_chain_refused when the key belongs to a client workspace.
https://app.softsolz.uk/api/v1/services/launchpad/clientsRecent 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
starter_idstringrequiredTemplate id from GET /templates.
company_namestringrequiredBusiness name. Also the name of the new workspace. Cannot contain a link or an email address.
contact_namestringPerson at the business you deal with. Cannot contain a link.
contact_emailstringWhere the claim link is sent by default.
website_urlstringThe business current website. The build reads it so the chatbot and the website text know the business. https:// is added when missing.
industrystringWhat the business does.
descriptionstringShort description of the business, used for the website text.
locationstringWhere the business is.
public_emailstringEmail address shown on the website.
public_phonestringPhone number shown on the website: 6 to 30 digits, spaces and the characters + ( ) . -
knowledge_textstringFacts about the business (hours, prices, policies) that the chatbot learns and the website text uses.
servicesarray of stringsServices to add to the website. Only the ones the template supports are kept. Default: forms, newsletter, blogs and smart-chat (appointments only when asked for).
logo_sourcestringgenerate (default) makes a logo with AI during the build, which spends credits; upload uses a logo added in the dashboard; none leaves the name as text.
agency_role_namestringRole your team keeps in the client workspace after the business takes over. Defaults to your agency setting (manager when not set).
handover_modestringstay keeps your team in the workspace after the business takes over; leave removes your access. Defaults to your agency setting.
notesstringPrivate notes about the client. Never shown to the business.
Response
Response Body
idstringClient id. Use it in every /clients/{id} call.workspace_idstringThe client workspace created for the business.company_namestringBusiness name.contact_namestring | nullPerson at the business you deal with.contact_emailstring | nullEmail address the claim link is sent to by default.website_urlstring | nullThe business current website, read during the build.industrystring | nullWhat the business does.descriptionstring | nullShort description of the business.locationstring | nullWhere the business is.public_emailstring | nullEmail address shown on the website.public_phonestring | nullPhone number shown on the website.has_knowledge_textbooleanWhether facts for the chatbot and the website text were given.starter_idstringTemplate the website uses.servicesarray of stringsServices the build adds to the website.logo_sourcestringWhere the logo comes from.agency_role_namestringRole your team keeps in the client workspace after the business takes over.handover_modestringstay keeps your team in the workspace with agency_role_name after the business takes over; leave removes your access.statusstringdraft (not built yet), building, ready (built, not sent), failed (build stopped, build again), sent (claim link or invite sent), signed_up (the business signed up and has not chosen a plan yet), claimed (the business runs the workspace; Launchpad can no longer change it).build_errorstring | nullWhy the last build stopped, or null.build_stepsarray of objectsBuild progress, one entry per step. Empty until the first build.preview_ends_atstring | nullWhen the free preview ends.preview_days_leftinteger | nullWhole days left in the preview; null once the business has taken over.sent_atstring | nullWhen the claim link or invite was first sent.reminder_sent_atstring | nullWhen the preview reminder was sent.opted_out_atstring | nullWhen the business asked not to be emailed about this again.signed_up_atstring | nullWhen the business signed up.claimed_atstring | nullWhen the business took over the workspace.handover_emailstring | nullEmail address a set-your-password link was sent to.handover_sent_atstring | nullWhen the set-your-password link was sent.notesstring | nullYour private notes about the client.claim_urlstring | nullLink the business opens to claim the workspace. Null until the workspace is built, and after the business opts out or takes over.siteobject | nullThe client website, or null until the build creates it.created_atstringWhen you started setting the business up.updated_atstringLast change.Request
curl --request POST \ --url https://app.softsolz.uk/api/v1/services/launchpad/clients \ --header 'Authorization: Bearer sk_live_your_key' \ --header 'Content-Type: application/json' \ --data '{ "starter_id": "restaurant", "company_name": "Northwind Bistro", "contact_name": "Maya Patel", "contact_email": "maya.patel@example.com", "industry": "Restaurant", "description": "A neighbourhood bistro serving seasonal small plates and natural wines.", "location": "Bristol, UK", "public_email": "hello@northwindbistro.co.uk", "public_phone": "+44 117 496 0123", "knowledge_text": "Open Tuesday to Sunday, 12:00 to 22:00. Walk-ins welcome; book ahead for groups of six or more. Vegetarian and vegan dishes on every menu.", "services": [ "forms", "newsletter", "blogs", "smart-chat", "appointments" ], "logo_source": "none", "agency_role_name": "manager", "handover_mode": "stay", "notes": "Met at the Clifton food market."}'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": { "id": "6f1c2b9e-4d3a-4b8e-9c1d-2a7e5f0b3c4d", "workspace_id": "0b7d5e3a-9c2f-4a1e-8d6b-5f4c3a2e1d0c", "company_name": "Northwind Bistro", "contact_name": "Maya Patel", "contact_email": "maya.patel@example.com", "website_url": null, "industry": "Restaurant", "description": "A neighbourhood bistro serving seasonal small plates.", "location": "Bristol, UK", "public_email": "hello@northwindbistro.co.uk", "public_phone": "+44 117 496 0123", "has_knowledge_text": true, "starter_id": "restaurant", "services": [ "forms", "newsletter", "blogs", "smart-chat", "appointments" ], "logo_source": "none", "agency_role_name": "manager", "handover_mode": "stay", "status": "draft", "build_error": null, "build_steps": [], "preview_ends_at": "2026-10-15T10:15:00.000Z", "preview_days_left": 14, "sent_at": null, "reminder_sent_at": null, "opted_out_at": null, "signed_up_at": null, "claimed_at": null, "handover_email": null, "handover_sent_at": null, "notes": "Met at the Clifton food market.", "claim_url": null, "site": { "address": "3f9a1c7e5b2d4e60", "status": "published", "url": null, "published_at": "2026-09-24T10:15:00.000Z", "has_logo": false }, "created_at": "2026-10-01T10:15:00.000Z", "updated_at": "2026-10-01T10:15:00.000Z" }}