---
title: "Create Business Linked Client"
method: POST
path: "/linkedClient"
---

# Create Business Linked Client

`POST /linkedClient`

Creates a new business linked client, representing a legal entity or organisation associated with your account. This object captures the company’s identifying, legal, and contact details as recorded with the relevant registration authority.

## Headers

- `idempotency-key` string

## Request body

- object
  - `clientType` string, required — Specifies the type of linked client being created. Defaults to `BUSINESS` for legal entities or organisations.
  - `friendlyName` string — A user-friendly label to easily identify this business linked client in your environment or dashboards. Used for internal display and management purposes only.
  - `company` object, required — An object containing details about the business entity being registered, including its name, legal structure, and sector information.
    - `companyName` string, required — The registered legal name of the business as it appears on incorporation or registration documents.
    - `companyType` 'CHARITY' | 'PARTNERSHIP' | 'PUBLIC_LIMITED_COMPANY' | 'PRIVATE_LIMITED_COMPANY' | 'SOLE_TRADER' | 'LIMITED_LIABILITY' | 'JOINT_STOCK_COMPANY' | 'FOUNDATION' | 'LIMITED_PARTNERSHIP_SERVICES' | 'TRUST' | 'PUBLICLY_LISTED_COMPANY' | 'OTHER' — The legal structure of the business entity.<br>`LIMITED_LIABILITY`, `SOLE_TRADER`, `PARTNERSHIP`, `PUBLIC_LIMITED_COMPANY`, `JOINT_STOCK_COMPANY`, `CHARITY`
    - `contactName` string — The full name of the business’s primary contact person. Used for communication and verification during onboarding or ongoing account management.
    - `email` string, required — The main business email address used for correspondence.
    - `industrySectorType` 'ADULT_DATING' | 'AFFILIATE_MARKETING' | 'FINANCIAL_SERVICES' | 'INTRODUCER' | 'PHARMACEUTICALS' | 'PROFESSIONAL_SERVICES' | 'CRYPTOCURRENCY' | 'MARKETING_SERVICES' | 'MARKETING_PROVIDER' | 'RETAIL' | 'ECOMMERCE' | 'RETAIL_LUXURY_GOODS' | 'MARKETPLACE' | 'ONLINE_MARKETPLACE' | 'GAMBLING' | 'SKILL_GAMING' | 'ENTERTAINMENT_SERVICES' | 'RESTAURANTS_FOOD_INDUSTRY' | 'IT_PROFESSIONAL_SERVICES' | 'NUTRACEUTICALS' | 'LOGISTICS_TRANSPORT' | 'HOSPITALITY' | 'TRAVEL_SERVICES' | 'MANUFACTURING_SERVICES' | 'TELECOMMUNICATION_SERVICES' | 'BAIL_BONDSMAN' | 'CBD_MARIJUANA_DISPENSARY' | 'ICO' | 'DRUG_PARAPHERNALIA' | 'FORTUNE_TELLING' | 'COUNSELLING_CENTRE' | 'MLM_PYRAMID_SCHEME' | 'PYROTECHNIC_HAZARDOUS_MATERIAL' | 'WEAPONS' | 'TIMESHARE' | 'TOBACCO' | 'LEGAL_SERVICES' | 'LEGAL_AND_PROFESSIONAL_SERVICES' | 'HOLDING_COMPANY' | 'REAL_ESTATE' | 'CONSULTANCY_SERVICES' | 'GIFT_CARDS' | 'CHARITY' | 'NON_REGISTERED_CHARITY' | 'CFD' | 'BANK' | 'CANADIAN_MSBS' | 'CRYPTO_EXCHANGE' | 'ELECTRONIC_MONEY_INSTITUTION' | 'FOREX_BROKER' | 'GAMING_OPERATOR' | 'IMPORT_AND_EXPORT' | 'LENDING_AND_BORROWING' | 'LIQUIDITY_PROVIDER_CFD' | 'LIQUIDITY_PROVIDER_DIGITAL_ASSETS' | 'LOTTERY_OPERATOR' | 'MARKET_MAKER' | 'OTC_DESK' | 'OTHER_SME' | 'P2P_TRADING' | 'PAYMENT_AGENT_CFD' | 'PAYMENT_AGENT_IGAMING' | 'PAYMENT_SERVICE_PROVIDER' | 'PAYROLL_PROVIDER_SME' | 'PENSION_PROVIDER' | 'PLAYER_ACCOUNT_MANAGEMENT' | 'PROP_TECH' | 'PROPRIETARY_TRADING_FIRM_CFD' | 'PRIME_BROKER' | 'REMITTANCE' | 'SAAS' | 'SERVICE_ENTITY_CFD' | 'SERVICE_ENTITY_DIGITAL_ASSETS' | 'SERVICE_ENTITY_IGAMING' | 'SOFTWARE_PROVIDER_IGAMING' | 'SPORTS_BETTING' | 'STABLECOIN_ISSUER' | 'SWISS_SRO' | 'TOKENISATION' | 'WALLET' | 'WEALTH_MANAGEMENT' | 'OTHER' — Specifies the general industry classification of the business e.g. `FINANCIAL_SERVICES`, `PHARMACEUTICALS`, `OTHER`.
    - `industrySectorValue` string — Further detail describing the specific sector in which the business operates. Required if `industrySectorType` is set to `OTHER`.
    - `phone` string — The primary business telephone number, including international dialing code if applicable. Should include the international dialing prefix e.g. `+44...` format.
    - `registrationNumber` string, required — The official registration or incorporation number assigned to the business by its governing authority or company registry.
    - `registeredAddress` object, required — An object containing the official registered address of the business as recorded with the relevant company registry or authority.
      - `addressLine1` string, required — The first line of the registered address, typically including building number and street name.
      - `addressLine2` string — The second line of the registered address, used for additional details such as suite, floor, or building name.
      - `city` string, required — The city or locality of the business’s registered address.
      - `state` string
      - `postCode` string — The postal or ZIP code of the registered address.
      - `country` string, required — Two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code e.g. `GB`
    - `tradingAddress` object — An object containing the operational or trading address of the business, if different from the registered address. Used to identify where the business conducts its primary operations.
      - `addressLine1` string — The first line of the trading address, typically including building number and street name.
      - `addressLine2` string — The second line of the trading address, used for additional address details where necessary.
      - `city` string — The city or locality where the business carries out its operations.
      - `state` string
      - `postCode` string — The postal or ZIP code corresponding to the trading address.
      - `country` string — Two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code e.g. `GB`

## Response `200`

---

[API](https://skmtc.net/openpayd/apis/openpayd-authorization.md) · [All operations](https://skmtc.net/openpayd/apis/openpayd-authorization/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openpayd/openpayd-authorization/versions/354ac572abda/schema)