Building blocks
Websites
Two kinds of website
Add a website by pasting its address. 1DB reads the homepage and the domain’s records, and from what it finds sets the site up one of two ways. You can switch before you create it.
- An existing site
- Something is already live at the domain. 1DB fills in the site’s name, contact address and the stack it can tell it’s built with, and the lead form it shows you takes on your site’s own styles. You connect the site’s forms to 1DB; nothing about the site itself changes.
- A new site
- Nothing is live yet, the domain only shows a registrar’s placeholder, or you don’t have a domain at all and start from a name. You pick the framework and host it will be built with, and 1DB can create its GitHub repo, deploy the first version to Vercel and write a build prompt for a coding agent.
What 1DB reads about a site
When you add a site, before you’ve connected anything, 1DB looks up:
- whether anything is live at the domain, and the site’s name and contact address if it is
- who the domain is registered with, and when it expires
- whose servers run its DNS, and who receives its email
Connect your accounts under Settings → Connections and each site also shows the repository behind it (GitHub), the project that deploys it (Vercel, Cloudflare) and its traffic (PostHog). 1DB matches them to the site by domain after it’s added, so there’s nothing to link by hand.
What every website comes with
- An ingest key
- A
1db_…key that can send leads to this website and nothing else. Revoking it affects no other site. - A contact form
- Ready to use from the start, with its own slug. Add more forms for quotes, pickups or anything else.
- An Integrate tab
- The endpoint, key and form slug, and code to paste for the way your site is built.
- A health check
- 1DB says when the site is down, has no form or active key, or its leads have stopped for far longer than usual.
- Its leads
- Every submission from its forms, in the site’s own list and in the organization’s Leads list.
Status
A website is active, in development, under maintenance or archived. When a site in maintenance or archived stops getting leads, its health check says the silence may be expected.
From the terminal
The CLI adds a website the same way and writes its key and form slug into your project’s env file. It finds an existing website for the domain rather than making a second one.
npx @1db/cli init northfieldpallets.com --env-file .env.localHundreds of sites
Every website shares the organization’s contacts and destinations, so adding the three hundredth site is as quick as the first. Websites are listed in one table, with the ones that need attention first.