Set up a business
Create the owner's business from what they already said: puts its website live and starts its 8 ready-made ads. Free; nothing is charged or launched. Pass what you know: the trade (a list_verticals slug) when you know it, the owner's own words about what they do in what (always, verbatim: "soccer coach", "we clean pools"; a specialty inside the trade adapts the page's words and header photo while the trade stays the closest one offered), the cities ("City, ST"), the website if they have one. Call right away: never ask for services (all of the trade's services are included), prices, photos, phone or budget, and don't ask a name (one is proposed when missing). status needs_answer carries exactly one question: ask it, then call again with the same arguments plus the answer. status needs_details lists the trade's required questions (a licence number in some states): ask them, then call again with the answers in facts. ready carries the website and a preview link (page, ads and estimate) to show the owner, and focus ("Your page is set up for soccer coaching.") when the page was adapted: tell the owner. Calling again with the same name resumes; it never creates a duplicate.
Create the owner's business from what they already said: puts its website live and starts its 8 ready-made ads. Free; nothing is charged or launched. Pass what you know: the trade (a list_verticals slug) when you know it, the owner's own words about what they do in what (always, verbatim: "soccer coach", "we clean pools"; a specialty inside the trade adapts the page's words and header photo while the trade stays the closest one offered), the cities ("City, ST"), the website if they have one. Call right away: never ask for services (all of the trade's services are included), prices, photos, phone or budget, and don't ask a name (one is proposed when missing). status needs_answer carries exactly one question: ask it, then call again with the same arguments plus the answer. status needs_details lists the trade's required questions (a licence number in some states): ask them, then call again with the answers in facts. ready carries the website and a preview link (page, ads and estimate) to show the owner, and focus ("Your page is set up for soccer coaching.") when the page was adapted: tell the owner. Calling again with the same name resumes; it never creates a duplicate.
Create a scoped key in Benjiads → Integrations. Sent only in Authorization.
In: header
Header Parameters
8–80 letters, digits, underscores or hyphens. Reuse the same key and arguments for retries. Completed mutations replay for at least 90 days; a pending operation returns 409 and must be reconciled before using a new key.
^[A-Za-z0-9_-]+$8 <= length <= 80Request Body
application/json
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/businesses" \ -H "Idempotency-Key: stringst" \ -H "Content-Type: application/json" \ -d '{}'{ "status": "ready", "business": { "id": "string", "name": "string", "slug": "string", "trade": "string", "siteUrl": "http://example.com", "setupComplete": true }, "missing": [ { "key": "string", "label": "string", "why": "string", "kind": "boolean", "required": true } ], "notice": "string", "next": "string", "focus": "string", "question": { "key": "trade", "text": "string", "options": [ "string" ] }, "preview": { "url": "http://example.com", "siteUrl": "http://example.com", "adImages": [ "http://example.com" ] }}