Set the business website
POST/api/v1/setup/website
Give a new account its website. Revnu checks the site exists, then researches the business, which takes about a minute.
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/websiteBody
| 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 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.