List the owner's businesses
Every business this connection can reach. Empty means none is set up yet: offer setup_business. With several, ask which one and pass its id as business_id.
Every business this connection can reach. Empty means none is set up yet: offer setup_business. With several, ask which one and pass its id as business_id.
Create a scoped key in Benjiads → Integrations. Sent only in Authorization.
In: header
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 GET "https://example.com/businesses"{ "businesses": [ { "id": "string", "name": "string", "slug": "string", "trade": "string", "siteUrl": "http://example.com", "setupComplete": true } ]}Set up a business POST
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.
How is my business doing GET
One read for the owner's usual question: the website, the ads (ready, prepared or live), the money available for ads, leads, and what is blocking the ads (blockers) with where to fix it. Money is USD cents. Report blockers in plain words.