UUpward API
v1
POST/api/public/v1/create-company
Requires x-auth-key

Create company

Provision a company with branding and an owner account.

Creates the company, its owner profile and the default pipelines. The web address is sanitised to letters and numbers and must be unique across Upward.

Body fields

marketstring (uuid)required

Key from GET /markets.

web_address_namestring (2–63)required

Subdomain for the company. Letters and numbers only.

first_namestring (1–80)required

Owner first name.

last_namestring (1–80)required

Owner last name.

emailstring (email)required

Owner email; the login is created against this address.

phonestring (≤40)optional

Owner phone number.

referrerstring (≤200)optional

Where the signup came from.

company_namestring (≤160)optional

Display name; defaults to the web address when omitted.

header_background_colorstring (≤40)optional

Hex colour for the site header background.

primary_background_colorstring (≤40)optional

Hex colour used as the brand primary.

primary_text_colorstring (≤40)optional

Hex colour for text on the brand primary.

header_logostring url (≤2000)optional

Logo shown in the header.

company_dark_logostring url (≤2000)optional

Logo for dark backgrounds.

company_light_logostring url (≤2000)optional

Logo for light backgrounds.

company_admin_photostring url (≤2000)optional

Headshot for the owner profile.

Responses

201CreatedThe company was provisioned.
{
  "id": "0f2c9c1a-5b6d-4b0e-9a63-1c7d4f8e2a90",
  "company_name": "Mydomain12",
  "web_address_name": "mydomain12",
  "market": { "Name": "Solar", "Key": "6a0f1c2e-…" },
  "public_url": "https://mydomain12.upward.page"
}
401UnauthorizedMissing, invalid, disabled or expired key.
{ "error": "Invalid API key" }
409ConflictThe web address is already taken.
{ "error": "That web address is already in use" }
422UnprocessableValidation failed or the market is unknown/inactive.
{
  "error": "Validation failed",
  "issues": ["email: Invalid email"]
}
POST/api/public/v1/create-company

Key from GET /markets.

Subdomain for the company. Letters and numbers only.

Owner first name.

Owner last name.

Owner email; the login is created against this address.

Owner phone number.

Where the signup came from.

Display name; defaults to the web address when omitted.

Hex colour for the site header background.

Hex colour used as the brand primary.

Hex colour for text on the brand primary.

Logo shown in the header.

Logo for dark backgrounds.

Logo for light backgrounds.

Headshot for the owner profile.

ResponseNot sent yet