Skip to main content
POST
/
accounts
/
create-child
Create child account
curl --request POST \
  --url https://api.interchange.io/api/v2/accounts/create-child \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Nike",
  "customerRole": "BUYER"
}
'
{
  "user": {},
  "customer": {},
  "customers": [
    {}
  ],
  "showTosBox": true,
  "hasContract": true,
  "latestTosVersion": "<string>",
  "convertedFromStandalone": true,
  "organizationContractMissing": true
}

Authorizations

​
Authorization
string
header
required

API key or access token

Body

application/json

Request body for creating a child customer account

​
name
string
required

Name for the new child account

Required string length: 1 - 255
Example:

"Nike"

​
customerRole
enum<string>
required

Whether the account is a buyer or seller

Available options:
BUYER,
SELLER
Example:

"BUYER"

​
parentName
string

Name for the parent account created during standalone conversion. Defaults to "{company} (Admin)" if omitted.

Required string length: 1 - 255
Example:

"Acme HQ"

​
customerDomain
string

Registered organization domain. For SELLER accounts, also seeds the auto-created storefront's publisher and operator domain.

Maximum string length: 255
Pattern: ^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)+$
Example:

"nike.com"

Response

Create child account

Full user context scoped to the new child customer

​
user
object
required

User profile data

​
customer
object
required

Customer context for the newly created child

​
customers
object[]
required

All accessible customer accounts

​
showTosBox
boolean
required

Whether to show the ToS acceptance dialog

​
hasContract
boolean
required

Whether the customer has an active contract

​
latestTosVersion
string
required

Latest embedded sales agent version identifier

​
convertedFromStandalone
boolean
required

True if the request triggered a standalone-to-parent conversion

​
organizationContractMissing
boolean

True when the newly created account cannot operate because the organization it inherits from has no active contract. UI should render a block page until an organization admin accepts ToS.