# Set the business website

> Give a new account its website. Revnu checks the site exists, then researches the business, which takes about a minute.

Canonical: https://revnu.com/docs/setup-website
Last updated: 2026-10-15

```bash
curl -X POST -H "Authorization: Bearer $REVNU_API_TOKEN" -H "content-type: application/json" \
  -d '{"url":"acme.com","timeZone":"Europe/London"}' https://revnu.com/api/v1/setup/website
```

## Body

| Field | Type | Meaning |
|---|---|---|
| `url` | string, required | The business's own website, up to 300 characters. `acme.com` and `https://acme.com` both work. |
| `timeZone` | string | An IANA name such as `Europe/London`, used for sending windows. |

Unknown fields are a `400`.

## Response

| Code | Meaning |
|---|---|
| 200 | `{ "ok": true }`. Research has started; poll [setup status](https://revnu.com/docs/setup-status.md) until the stage is `review`. |
| 400 | `url` missing or too long, a bad `timeZone`, or an unknown field. |
| 409 | `rejected` with a `message`: the site doesn't exist or isn't answering, it is a social network rather than the business's own site, or the account already has a website. |

An account that already has a website returns `409`, unless its research failed, in which case a corrected address starts it again. One Revnu login holds one business: a different business needs a different account, signed in with that business's email.

## Frequently asked questions

### Which scope does this need?

None. It only acts while the account is still in setup.
