---
title: "Create sub-customer"
method: POST
path: "/v3/customers/{id}/sub-customers"
tags: ["Customers"]
---

# Create sub-customer

`POST /v3/customers/{id}/sub-customers`

## Path parameters

- `id` string, required

## Request body

- CreateSubCustomerDto
  - `customerName` string, required — Customer Name
  - `currency` string, required — Currency
  - `useParentContactInfo` boolean, required — Use Parent Customer's Contact Info
  - `billingEmail` string — Billing Email
  - `billingAddress` AddressV3Dto
    - `externalId` string, required — External identifier for the address
    - `city` string, required — City name
    - `state` string, required — State/province name
    - `country` string — Country Code
    - `postalCode` string, required — Postal/ZIP code
    - `line1` string, required — Primary street address
    - `line2` string, required — Secondary address line (apt, suite, etc)
    - `addressee` string — Name of recipient/addressee

## Response `201`

Created sub customer

## Other responses

- `500` — Internal server error

---

[API](https://skmtc.net/tabsplatform/apis/tabs-external-api.md) · [All operations](https://skmtc.net/tabsplatform/apis/tabs-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tabsplatform/tabs-external-api/revisions/7e8885517814/schema)