Skip to main content
POST
Create an organization

Authorizations

Authorization
string
header
required

A workspace API token. Create one in Settings → API. Send it as Authorization: Bearer sk_live_....

Query Parameters

expand
string | null

Comma-separated relationships to inline in the response. Unexpanded relations are still identified by their *_id field.

Example:

"organization,owner"

Body

application/json

Body for POST /v1/organizations.

name
string
required

Required; a nameless organization is not useful.

Minimum string length: 1
custom_fields
Custom Fields · object
owner_id
string | null

Unique identifier for an user.

Pattern: ^usr_[0-9a-f]{32}$
Example:

"usr_9f2ac41d8b7e4a51b0d3e6f7a1c2d3e4"

visibility
enum<string>
default:company

CRM record visibility levels; resolved live against the owner's current teams.

Available options:
private,
team,
team_and_subteams,
company
website
string | null

Response

Successful Response

A company a contact belongs to.

created_at
string<date-time>
required
id
string
required

Unique identifier for an organization.

Pattern: ^org_[0-9a-f]{32}$
Example:

"org_9f2ac41d8b7e4a51b0d3e6f7a1c2d3e4"

name
string
required
updated_at
string<date-time>
required
visibility
enum<string>
required

Governs who sees this record in the Sailer UI. API tokens are workspace-scoped and are not filtered by it.

Available options:
private,
team,
team_and_subteams,
company
custom_fields
Custom Fields · object

Every custom field defined on organizations in this workspace, keyed by field key and typed from its definition. Unset fields are null, so reading any organization shows the full set of keys in use.

object
string
default:organization
Allowed value: "organization"
owner
Owner · object | null

Whoever is responsible for this record. Always populated when the record has an owner — this is not an expand target.

owner_id
string | null
deprecated

Unique identifier for an user.

Pattern: ^usr_[0-9a-f]{32}$
Example:

"usr_9f2ac41d8b7e4a51b0d3e6f7a1c2d3e4"

tags
Tag · object[]
website
string | null