---
title: "Create Counterparty"
method: POST
path: "/counterparties"
---

# Create Counterparty

`POST /counterparties`

Create a new counterparty.

## Request body

- object
  - `name` string, required — A human friendly name for this counterparty.
  - `accounts` object[] — The accounts for this counterparty.
    - `account_type` string
    - `party_name` string
    - `party_type` string
    - `party_address` object
      - `line1` string
      - `line2` string
      - `locality` string
      - `region` string
      - `postal_code` string
      - `country` string
    - `account_details` object[]
      - `account_number` string, required
      - `account_number_type` string
    - `routing_details` object[]
      - `routing_number` string, required
      - `routing_number_type` string, required
      - `payment_type` string
    - `plaid_processor_token` string — If you've enabled the Modern Treasury + Plaid integration in your Plaid account, you can pass the processor token in this field.
  - `email` string — An optional email to assign to the counterparty.
  - `metadata` string, json — Metadata to be added to the counterparty. Must be a JSON object.
  - `send_remittance_advice` boolean
  - `taxpayer_identifier` string — Valid tax payer ID for counterparty's region.
  - `accounting` object — An object of references to auto-sync the counterparty to your accounting system. Can send `type` which is either `customer` or `vendor`.
  - `legal_entity` object
    - `legal_entity_type` string, required — The type of legal entity. One of: `individual`, `business`
    - `risk_rating` string — The risk rating of legal entity. One of: `low`, `medium`, `high`.
    - `prefix` string — An individual's prefix.
    - `first_name` string — An individual's first name.
    - `middle_name` string — An individual's middle name.
    - `last_name` string — An individual's last name.
    - `suffix` string — An individual's suffix.
    - `preferred_name` string — An individual's preferred name.
    - `citizenship_country` string — The ISO 3166-1 alpha-2 country code of the individual's citizenship country.
    - `politically_exposed_person` boolean — Whether the individual is a politically exposed person.
    - `date_of_birth` string, date — An individual's data of birth (YYYY-MM-DD).
    - `date_formed` string, date — The business's formation date (YYYY-MM-DD).
    - `business_name` string — The business's legal business name.
    - `doing_business_as_names` string[] — A list of "Doing Business As" (DBA) / trade names for a business, different than their legal business name.
    - `legal_structure` string — The business's legal structure. One of: `corporation`, `llc`, `non_profit`, `partnership`, `sole_proprietorship`, `trust`.
    - `phone_numbers` object[] — A list of phone numbers in E.164 format.
      - `phone_number` string — A phone number in E.164 format. This format is strictly validated: include a leading + and country code, followed by digits only (no spaces or dashes), e.g. +12025551234.
    - `bank_settings` object — Additional bank-specific settings for a legal entity.
      - `enable_backup_withholding` boolean — Whether backup withholding is enabled. See more here - https://www.irs.gov/businesses/small-businesses-self-employed/backup-withholding
      - `backup_withholding_percentage` integer — The percentage of backup withholding to apply to the legal entity.
      - `privacy_opt_out` boolean — Cross River Bank specific setting to opt out of privacy policy.
      - `regulation_o` boolean — It covers, among other types of insider loans, extensions of credit by a member bank to an executive officer, director, or principal shareholder of the member bank; a bank holding company of which the member bank is a subsidiary; and any other subsidiary of that bank holding company.
    - `wealth_and_employment_details` object — Wealth and employment details for an individual.
      - `employment_status` '"employed"' | '"retired"' | '"self_employed"' | '"student"' | '"unemployed"' — The employment status of the individual.
      - `occupation` '"consulting"' | '"executive"' | '"finance_accounting"' | '"food_services"' | '"government"' | '"healthcare"' | '"legal_services"' | '"manufacturing"' | '"other"' | '"sales"' | '"science_engineering"' | '"technology"' — The occupation of the individual's employment.
      - `industry` '"accounting"' | '"agriculture"' | '"automotive"' | '"chemical_manufacturing"' | '"construction"' | '"educational_medical"' | '"food_service"' | '"finance"' | '"gasoline"' | '"health_stores"' | '"laundry"' | '"maintenance"' | '"manufacturing"' | '"merchant_wholesale"' | '"mining"' | '"performing_arts"' | '"professional_non_legal"' | '"public_administration"' | '"publishing"' | '"real_estate"' | '"recreation_gambling"' | '"religious_charity"' | '"rental_services"' | '"retail_clothing"' | '"retail_electronics"' | '"retail_food"' | '"retail_furnishing"' | '"retail_home"' | '"retail_non_store"' | '"retail_sporting"' | '"transportation"' | '"travel"' | '"utilities"' — The industry of the individual's employment.
      - `income_source` '"family_support"' | '"government_benefits"' | '"inheritance"' | '"investments"' | '"rental_income"' | '"retirement"' | '"salary"' | '"self_employed"' — The source of the individual's income.
      - `income_state` string — The state in which the individual's income is earned.
      - `income_country` string — The ISO 3166-1 alpha-2 country code in which the individual's income is earned.
      - `employer_name` string — The name of the employer.
      - `employer_state` string — The state in which the employer is located. This field is free-form text; for US states, we recommend a two-letter abbreviation (e.g. CA).
      - `employer_country` string — The ISO 3166-1 alpha-2 country code in which the employer is located.
      - `source_of_funds` '"alimony"' | '"annuity"' | '"business_owner"' | '"general_employee"' | '"government_benefits"' | '"homemaker"' | '"inheritance_gift"' | '"investment"' | '"legal_settlement"' | '"lottery"' | '"real_estate"' | '"retired"' | '"retirement"' | '"salary"' | '"self_employed"' | '"senior_executive"' | '"trust_income"' — The source of the individual's funds.
      - `wealth_source` '"business_sale"' | '"family_support"' | '"government_benefits"' | '"inheritance"' | '"investments"' | '"other"' | '"rental_income"' | '"retirement"' | '"salary"' | '"self_employed"' — The source of the individual's wealth.
      - `annual_income` integer — The annual income of the individual.
    - `email` string — The entity's primary email.
    - `website` string — The entity's primary website URL.
    - `metadata` string, json — Additional data represented as key-value pairs. Both the key and value must be strings.
    - `addresses` object[] — A list of addresses for the entity.
      - `address_types` string[] — The types of this address. Possible values: `business`, `mailing`, `other`, `po_box`, `residential`.
      - `line1` string, required — Address line 1
      - `line2` string — Address line 2
      - `locality` string, required — Locality or City. Use the full city name rather than an abbreviation (e.g. San Francisco).
      - `region` string, required — Region or State. This field is free-form; for US states, we recommend a two-letter code (e.g. CA). Full state names are also accepted.
      - `postal_code` string, required — The postal code of the address.
      - `country` string, required — Country code conforms to [ISO 3166-1 alpha-2]
      - `primary` boolean — Designates if this is the primary address for the LegalEntity
    - `identifications` object[] — A list of identifications for the legal entity.
      - `id_number` string, required — The ID number of identification document.
      - `id_type` string, required — The type of ID number. See list of [Identifications](https://docs.moderntreasury.com/platform/reference/identifications)
      - `issuing_country` string — The ISO 3166-1 alpha-2 country code of the country that issued the identification.
      - `issuing_region` string — The region in which the identification was issued.
      - `expiration_date` string, date — The date when the Identification is no longer considered valid by the issuing authority
    - `legal_entity_associations` object[] — The legal entity associations and its child legal entities.
      - `relationship_types` string[], required — A list of relationship types for how the child entity relates to parent entity.
      - `title` string — The job title of the child entity at the parent entity.
      - `ownership_percentage` integer — The child entity's ownership percentage if they are a beneficial owner.
      - `child_legal_entity` object — The child legal entity object.
        - `legal_entity_type` string, required — The type of legal entity. One of: `individual`, `business`
        - `risk_rating` string — The risk rating of legal entity. One of: `low`, `medium`, `high`.
        - `prefix` string — An individual's prefix.
        - `first_name` string — An individual's first name.
        - `middle_name` string — An individual's middle name.
        - `last_name` string — An individual's last name.
        - `suffix` string — An individual's suffix.
        - `preferred_name` string — An individual's preferred name
        - `citizenship_country` string — The ISO 3166-1 alpha-2 country code of the individual's citizenship country.
        - `politically_exposed_person` boolean — Whether the individual is a politically exposed person.
        - `date_of_birth` string, date — An individual's data of birth (YYYY-MM-DD).
        - `date_formed` string, date — The business's formation date (YYYY-MM-DD).
        - `business_name` string — The business's legal business name.
        - `doing_business_as_names` string[] — A list of "Doing Business As" (DBA) / trade names for a business, different than their legal business name.
        - `legal_structure` string — The business's legal structure. One of: `corporation`, `llc`, `non_profit`, `partnership`, `sole_proprietorship`, `trust`.
        - `phone_numbers` object[] — A list of phone numbers in E.164 format.
          - `phone_number` string — A phone number in E.164 format. This format is strictly validated: include a leading + and country code, followed by digits only (no spaces or dashes), e.g. +12025551234.
        - `bank_settings` object — Additional bank-specific settings for a legal entity.
          - `enable_backup_withholding` boolean — Whether backup withholding is enabled. See more here - https://www.irs.gov/businesses/small-businesses-self-employed/backup-withholding
          - `backup_withholding_percentage` integer — The percentage of backup withholding to apply to the legal entity.
          - `privacy_opt_out` boolean — Cross River Bank specific setting to opt out of privacy policy.
          - `regulation_o` boolean — It covers, among other types of insider loans, extensions of credit by a member bank to an executive officer, director, or principal shareholder of the member bank; a bank holding company of which the member bank is a subsidiary; and any other subsidiary of that bank holding company.
        - `wealth_and_employment_details` object — Wealth and employment details for an individual.
          - `employment_status` '"employed"' | '"retired"' | '"self_employed"' | '"student"' | '"unemployed"' — The employment status of the individual.
          - `occupation` '"consulting"' | '"executive"' | '"finance_accounting"' | '"food_services"' | '"government"' | '"healthcare"' | '"legal_services"' | '"manufacturing"' | '"other"' | '"sales"' | '"science_engineering"' | '"technology"' — The occupation of the individual's employment.
          - `industry` '"accounting"' | '"agriculture"' | '"automotive"' | '"chemical_manufacturing"' | '"construction"' | '"educational_medical"' | '"food_service"' | '"finance"' | '"gasoline"' | '"health_stores"' | '"laundry"' | '"maintenance"' | '"manufacturing"' | '"merchant_wholesale"' | '"mining"' | '"performing_arts"' | '"professional_non_legal"' | '"public_administration"' | '"publishing"' | '"real_estate"' | '"recreation_gambling"' | '"religious_charity"' | '"rental_services"' | '"retail_clothing"' | '"retail_electronics"' | '"retail_food"' | '"retail_furnishing"' | '"retail_home"' | '"retail_non_store"' | '"retail_sporting"' | '"transportation"' | '"travel"' | '"utilities"' — The industry of the individual's employment.
          - `income_source` '"family_support"' | '"government_benefits"' | '"inheritance"' | '"investments"' | '"rental_income"' | '"retirement"' | '"salary"' | '"self_employed"' — The source of the individual's income.
          - `income_state` string — The state in which the individual's income is earned.
          - `income_country` string — The ISO 3166-1 alpha-2 country code in which the individual's income is earned.
          - `employer_name` string — The name of the employer.
          - `employer_state` string — The state in which the employer is located. This field is free-form text; for US states, we recommend a two-letter abbreviation (e.g. CA).
          - `employer_country` string — The ISO 3166-1 alpha-2 country code in which the employer is located.
          - `source_of_funds` '"alimony"' | '"annuity"' | '"business_owner"' | '"general_employee"' | '"government_benefits"' | '"homemaker"' | '"inheritance_gift"' | '"investment"' | '"legal_settlement"' | '"lottery"' | '"real_estate"' | '"retired"' | '"retirement"' | '"salary"' | '"self_employed"' | '"senior_executive"' | '"trust_income"' — The source of the individual's funds.
          - `wealth_source` '"business_sale"' | '"family_support"' | '"government_benefits"' | '"inheritance"' | '"investments"' | '"other"' | '"rental_income"' | '"retirement"' | '"salary"' | '"self_employed"' — The source of the individual's wealth.
          - `annual_income` integer — The annual income of the individual.
        - `email` string — The entity's primary email.
        - `website` string — The entity's primary website URL.
        - `metadata` string, json — Additional data represented as key-value pairs. Both the key and value must be strings.
        - `addresses` object[] — A list of addresses for the entity.
          - `address_types` string[] — The types of this address. Possible values: `business`, `mailing`, `other`, `po_box`, `residential`.
          - `line1` string, required — Address line 1
          - `line2` string — Address line 2
          - `locality` string, required — Locality or City. Use the full city name rather than an abbreviation (e.g. San Francisco).
          - `region` string, required — Region or State. This field is free-form; for US states, we recommend a two-letter code (e.g. CA). Full state names are also accepted.
          - `postal_code` string, required — The postal code of the address.
          - `country` string, required — Country code conforms to [ISO 3166-1 alpha-2]
          - `primary` boolean — Designates if this is the primary address for the LegalEntity
        - `identifications` object[] — A list of identifications for the legal entity.
          - `id_number` string, required — The ID number of identification document.
          - `id_type` string, required — The type of ID number. See list of [Identifications](https://docs.moderntreasury.com/platform/reference/identifications)
          - `issuing_country` string — The ISO 3166-1 alpha-2 country code of the country that issued the identification.
          - `issuing_region` string — The region in which the identification was issued.
          - `expiration_date` string, date — The date when the Identification is no longer considered valid by the issuing authority
      - `child_legal_entity_id` string — The ID of the child legal entity.
  - `legal_entity_id` string
  - `external_id` string — An optional user-defined 180 character unique identifier

## Response `201`

201

- object
  - `id` string
  - `object` string
  - `name` string
  - `email` string
  - `metadata` object
  - `accounts` object[]
    - `id` string
    - `account_type` unknown
    - `party_name` string
    - `party_type` string
    - `party_address` unknown
    - `account_details` object[]
      - `id` string
      - `account_number_safe` string
      - `account_number_type` unknown
    - `routing_details` object[]
      - `id` string
      - `payment_type` unknown
      - `routing_number` string
      - `routing_number_type` string
  - `created_at` string
  - `updated_at` string

---

[API](https://skmtc.net/modern-treasury/apis/modern-treasury-api.md) · [All operations](https://skmtc.net/modern-treasury/apis/modern-treasury-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/modern-treasury/modern-treasury-api/versions/ed0431a2dcd0/schema)