Skip to main content
POST
Create a household or company account

Authorizations

Authorization
string
header
required

Organization-scoped bearer credential: a customer API key (1club_sk_live_...) or an MCP OAuth access token.

Headers

Idempotency-Key
string

Retry-safe key; a repeat of the same request replays the first response

Maximum string length: 255

Body

application/json

Fields accepted when creating an account. Unknown fields are rejected.

type
enum<string>
required
Available options:
household,
company
contactId
integer
required

The first member, who becomes the primary contact

name
string

Required for a company. A household without one is named after its first member.

Maximum string length: 200
role
enum<string>

The first member's role. Defaults to owner for a household and employee for a company.

Available options:
owner,
adult,
dependent,
admin,
employee
Maximum string length: 200
taxNumber
string | null

VAT or tax id

Maximum string length: 100
registrationNumber
string | null

Company registration number

Maximum string length: 100
billingEmail
string<email> | null
notes
string | null
Maximum string length: 2000

Response

Account created

A household or company account: the family or employer a group of contacts belongs to, which an invoice can be addressed to.

id
integer
type
enum<string>

organization is a legacy type: it is listed, but not created here.

Available options:
household,
company,
organization
name
string | null
primaryContactId
integer | null

The member the account is addressed to by default

Maximum string length: 200
taxNumber
string | null

VAT or tax id

Maximum string length: 100
registrationNumber
string | null

Company registration number

Maximum string length: 100
billingEmail
string<email> | null
notes
string | null
Maximum string length: 2000
memberCount
integer
createdAt
string<date-time>
members
object[]