Register the authenticated Supabase identity as a mother account

POST

/mother/accounts

const url = 'https://example.com/mother/accounts';
const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': 'example',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: '{"expectedProfileRevision":0,"expectedAddressRevision":0,"fullName":"example","birthDate":"2026-04-15","address":{"postalCode":"example","roadAddress":"example","detailAddress":"example"},"consentAcceptances":[{"policyKey":"example","versionLabel":"example"}]}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://example.com/mother/accounts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: example' \
  --data '{ "expectedProfileRevision": 0, "expectedAddressRevision": 0, "fullName": "example", "birthDate": "2026-04-15", "address": { "postalCode": "example", "roadAddress": "example", "detailAddress": "example" }, "consentAcceptances": [ { "policyKey": "example", "versionLabel": "example" } ] }'

Native Supabase Auth signup, identity linking, and contact verification happen before this operation. The provider is re-read from the bearer session; this API never accepts credentials, OTP material, provider tokens, actor role, member id, or branch scope in the request body.

Authorizations

supabaseBearerAuth

Parameters

Header Parameters

Idempotency-Key

required

string

>= 1 characters <= 255 characters /^\S(?:.*\S)?$/

Request Body^required

application/json

RegisterMotherAccountRequest

object

expectedProfileRevision

required

expectedAddressRevision

required

fullName

required

string

>= 1 characters <= 100 characters /\S/

birthDate

required

string format: date

address

required

object

postalCode

required

string

/^[0-9]{5}$/

roadAddress

required

string

>= 1 characters <= 300 characters /\S/

detailAddress

required

One of:

string
null

string

>= 1 characters <= 300 characters /\S/

key

additional properties

consentAcceptances

required

Array<object>

>= 1 items unique items

object

policyKey

required

string

>= 1 characters <= 120 characters /^[a-z][a-z0-9_.:-]*$/

versionLabel

required

string

>= 1 characters <= 120 characters /^[a-z0-9][a-z0-9_.:-]*$/

key

additional properties

key

additional properties

Responses

200

Exact replay returns the original authoritative account profile

application/json

object

motherAccountId

required

string

>= 1 characters <= 255 characters /^\S(?:.*\S)?$/

motherProfileId

required

string

>= 1 characters <= 255 characters /^\S(?:.*\S)?$/

accountLifecycle

required

string

Allowed values: active withdrawal_pending withdrawn

profileCompleteness

required

string

Allowed values: incomplete complete

profileRevision

required

integer

>= 1

addressRevision

required

integer

>= 1

fullName

required

string

>= 1 characters <= 100 characters /\S/

birthDate

required

string format: date

email

required

One of:

string
null

string format: email

<= 254 characters

primaryPhoneNumber

required

One of:

string
null

string

/^\+[1-9][0-9]{7,14}$/

address

required

object

postalCode

required

string

/^[0-9]{5}$/

roadAddress

required

string

>= 1 characters <= 300 characters /\S/

detailAddress

required

One of:

string
null

string

>= 1 characters <= 300 characters /\S/

key

additional properties

verifiedContacts

required

object

email

required

One of:

object
null

object

receiptId

required

string

>= 1 characters <= 255 characters /^\S(?:.*\S)?$/

normalizedValue

required

string format: email

<= 254 characters

verifiedAt

required

string format: date-time

verificationAuthority

required

Allowed value: supabase_auth

key

additional properties

phone

required

One of:

object
null

object

receiptId

required

string

>= 1 characters <= 255 characters /^\S(?:.*\S)?$/

normalizedValue

required

string

/^\+[1-9][0-9]{7,14}$/

verifiedAt

required

string format: date-time

verificationAuthority

required

Allowed value: supabase_auth

key

additional properties

key

additional properties

consentReceipts

required

Array<object>

object

consentReceiptId

required

string

>= 1 characters <= 255 characters /^\S(?:.*\S)?$/

policyKey

required

string

>= 1 characters <= 120 characters /^[a-z][a-z0-9_.:-]*$/

versionLabel

required

string

>= 1 characters <= 120 characters /^[a-z0-9][a-z0-9_.:-]*$/

acceptedAt

required

string format: date-time

captureSource

required

Allowed value: explicit_mother_action

key

additional properties

ownershipRelationship

required

object

state

required

string

Allowed values: pending applied repair_required

relationshipReceiptId

required

One of:

string
null

string

>= 1 characters <= 255 characters /^\S(?:.*\S)?$/

appliedAt

required

One of:

string
null

string format: date-time

key

additional properties

allowedNextActions

required

Array<string>

unique items

Allowed values: verify_contact accept_current_consent complete_profile update_profile start_reservation request_withdrawal

createdAt

required

string format: date-time

updatedAt

required

string format: date-time

idempotentReplay

required

boolean

idempotentReplay

201

Active mother account, complete profile, receipts, and ownership relationship created

application/json

object

motherAccountId

required

string

>= 1 characters <= 255 characters /^\S(?:.*\S)?$/

motherProfileId

required

string

>= 1 characters <= 255 characters /^\S(?:.*\S)?$/

accountLifecycle

required

string

Allowed values: active withdrawal_pending withdrawn

profileCompleteness

required

string

Allowed values: incomplete complete

profileRevision

required

integer

>= 1

addressRevision

required

integer

>= 1

fullName

required

string

>= 1 characters <= 100 characters /\S/

birthDate

required

string format: date

email

required

One of:

string
null

string format: email

<= 254 characters

primaryPhoneNumber

required

One of:

string
null

string

/^\+[1-9][0-9]{7,14}$/

address

required

object

postalCode

required

string

/^[0-9]{5}$/

roadAddress

required

string

>= 1 characters <= 300 characters /\S/

detailAddress

required

One of:

string
null

string

>= 1 characters <= 300 characters /\S/

key

additional properties

verifiedContacts

required

object

email

required

One of:

object
null

object

receiptId

required

string

>= 1 characters <= 255 characters /^\S(?:.*\S)?$/

normalizedValue

required

string format: email

<= 254 characters

verifiedAt

required

string format: date-time

verificationAuthority

required

Allowed value: supabase_auth

key

additional properties

phone

required

One of:

object
null

object

receiptId

required

string

>= 1 characters <= 255 characters /^\S(?:.*\S)?$/

normalizedValue

required

string

/^\+[1-9][0-9]{7,14}$/

verifiedAt

required

string format: date-time

verificationAuthority

required

Allowed value: supabase_auth

key

additional properties

key

additional properties

consentReceipts

required

Array<object>

object

consentReceiptId

required

string

>= 1 characters <= 255 characters /^\S(?:.*\S)?$/

policyKey

required

string

>= 1 characters <= 120 characters /^[a-z][a-z0-9_.:-]*$/

versionLabel

required

string

>= 1 characters <= 120 characters /^[a-z0-9][a-z0-9_.:-]*$/

acceptedAt

required

string format: date-time

captureSource

required

Allowed value: explicit_mother_action

key

additional properties

ownershipRelationship

required

object

state

required

string

Allowed values: pending applied repair_required

relationshipReceiptId

required

One of:

string
null

string

>= 1 characters <= 255 characters /^\S(?:.*\S)?$/

appliedAt

required

One of:

string
null

string format: date-time

key

additional properties

allowedNextActions

required

Array<string>

unique items

Allowed values: verify_contact accept_current_consent complete_profile update_profile start_reservation request_withdrawal

createdAt

required

string format: date-time

updatedAt

required

string format: date-time

idempotentReplay

required

boolean

idempotentReplay

401

A valid Supabase bearer session is required

application/json

One of:

object

status

required

Allowed value: 401

code

required

Allowed value: authentication_required

retryable

required

key

additional properties

403

Authenticated staff or unsupported actor identity cannot create a mother account

application/json

One of:

object

status

required

Allowed value: 401

code

required

Allowed value: authentication_required

retryable

required

key

additional properties

409

Account identity or idempotency facts conflict without exposing another account

application/json

One of:

object

status

required

Allowed value: 401

code

required

Allowed value: authentication_required

retryable

required

key

additional properties

422

Profile input is invalid, contact is unverified, or a consent version is not published

application/json

One of:

object

status

required

Allowed value: 401

code

required

Allowed value: authentication_required

retryable

required

key

additional properties

503

Account creation did not reach a safe success state; repair reference may be returned

application/json

One of:

object

status

required

Allowed value: 401

code

required

Allowed value: authentication_required

retryable

required

key

additional properties

Register the authenticated Supabase identity as a mother account

Authorizations

Parameters

Header Parameters

Request Bodyrequired

Responses

200

201

401

403

409

422

503

Request Body^required