---
title: "Set the business website"
method: POST
path: "/api/v1/setup/website"
tags: ["API Reference"]
---

# Set the business website

`POST /api/v1/setup/website`

## Request

- Base URL: `https://revnu.com`
- URL: `https://revnu.com/api/v1/setup/website`
- Auth: HTTP bearer

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

**Response.** | Code | Meaning |
|---|---|
| 200 | `{ "ok": true }`. Research has started; poll [setup status](/docs/setup-status) 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.

## Request body

- object

## Response `200`

{ "ok": true }. Research has started; poll setup status until the stage is review.

- object
  - `ok` boolean, required

## Other responses

- `400`: url missing or too long, a bad timeZone, or an unknown field.
- `401`: Missing, malformed, unknown or revoked token.
- `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.
- `429`: Rate limited.
- `503`: Temporarily unavailable; retry the same call.

---

[API](https://skmtc.dev/revnu/apis/revnu-api.md) · [All operations](https://skmtc.dev/revnu/apis/revnu-api/llms.txt) · [OpenAPI document](https://skmtc.dev/revnu/apis/revnu-api/revisions/52e523c2db61?raw)