Skip to content

Creating a site

A site is how Expeed Relay represents one website. Every form that submits to Expeed Relay belongs to a site, and the site is where you configure the things that apply to the whole website: which browser origins may submit, which delivery providers to use, and whether CAPTCHA is required.

Create one site per website. If you run example.com and careers.example.com as separate properties with separate contact forms, they are two sites — that keeps their credentials, origins, and access lists independent.

  1. Open Sites in the left sidebar and click New site.
  2. Enter a Name. This is the human label you will see everywhere in the dashboard — use the website’s real name, like “Expeed Marketing Site”.
  3. Enter a Site key. This is the identifier the developer puts in their integration code. Use lowercase and hyphens, like expeed-marketing.
  4. Add your Allowed origins — one entry per browser origin that will submit forms. Leaving this empty disables origin checking altogether, so only do that if submissions come exclusively from a server.
  5. Click Create site.

Those three are all the dialog asks for. Everything else about a site — Requestor name and Requestor email, the CAPTCHA settings, the Active toggle, and its providers and forms — lives on the site’s own page, which you reach by clicking the new row. Nothing there is required to start receiving submissions, and a new site is active by default.

Screenshot to come
The New site dialog with Name, Site key, and Allowed origins filled in

A site with no providers cannot deliver anything, so the order matters:

  1. Add at least one delivery provider — see Configuring providers.
  2. Create a form and attach recipients — see Forms & recipients.
  3. If the form is public, turn on CAPTCHA — see CAPTCHA setup.
  4. Give the developer the Site key and the form’s key so they can wire up the integration.

Open Sites and click any row to reach the site detail page. The General tab holds everything about the site, not only what the creation dialog asked for — Name, Site key, Allowed origins, Requestor name and Requestor email, the CAPTCHA fields, and the Active toggle. Change what you need and click Save changes. The Providers and Forms tabs beside it are covered in Configuring providers and Forms & recipients.

Two things behave differently after creation:

  • Site Key cannot be changed. It is baked into the developer’s integration code, so changing it would silently break every live form. If you truly need a different key, create a new site and migrate the forms.
  • Deactivating a site (turning Active off) stops it accepting new submissions immediately. Existing submissions and their delivery history stay visible. This is the safe way to pause a website without deleting anything.

Deleting happens in two quite different forms, and the difference matters more than the interface suggests.

The delete button deactivates — it does not destroy

Section titled “The delete button deactivates — it does not destroy”

The trash icon on the Sites list performs a soft delete. The site is marked inactive and nothing else happens: every submission, delivery job, form, recipient, template, webhook, API key, and provider configuration is retained exactly as it was. The site stops accepting submissions, and it disappears for managers and viewers.

Deactivating also stops deliveries that were already queued. Anything still waiting to be sent for that site is abandoned rather than delivered, and retrying such a job by hand will refuse too. So switching a site off genuinely stops the sending, not just the receiving.

Setting Active back on from the site’s General tab reverses it completely.

Erasing a site for real is a separate, deliberate operation that is not exposed in the dashboard. There is no button for it. If you genuinely need a site and its history erased — a decommissioned property, a data-retention request — ask your Expeed Relay administrator to run it against the API for you.

In almost every case the soft delete is what you actually want. Deactivate, leave it a while, and only erase once you are certain nobody needs the history.

  • The developer says submissions return “not found”. This single message covers several distinct causes, deliberately — Expeed Relay does not reveal which one, because a detailed error would let a stranger probe for valid site keys. It means one of: the site key is wrong, the form key is wrong, the site or form is deactivated, or the browser’s origin is not in Allowed origins. Work through them in that order.
  • Submissions worked yesterday and stopped today. Check the Active toggle on both the site and the form before anything else. A deactivated site returns the same “not found” message as a wrong key.
  • The site is missing from a colleague’s list. They are a manager or viewer and the site is not in their Site assignment, or the site is inactive — non-admins do not see inactive sites at all. See Users & roles.