# Create an Associated Identity

Create an associated  for every owner with 25% or more ownership over the merchant.


Endpoint: POST /identities/{identity_id}/associated_identities
Version: 2022-02-01
Security: BasicAuth

## Path parameters:

  - `identity_id` (string, required)
    The  ID of the beneficial owner from which you wish to create the associated identity.

## Request fields (application/json):

  - `entity` (object)

  - `entity.amex_mid` (integer,null)
    Assigned amexMid value. If a value is passed, it must be 10 or 11 digits.

  - `entity.annual_card_volume` (integer,null)
    The annual credit card sales (in cents) expected to be processed by this merchant (max 19 characters).

  - `entity.business_address` (object,null)
    The primary address for the legal entity.

  - `entity.business_address.line1` (string,null)
    First line of the address (max 35 characters).

  - `entity.business_address.line2` (string,null)
    Second line of the address (max 35 characters).

  - `entity.business_address.city` (string,null)
    City (max 20 characters).

  - `entity.business_address.region` (string,null)
    2-letter state code.

  - `entity.business_address.postal_code` (string,null)
    Zip or Postal code (max 7 characters).

  - `entity.business_address.country` (string,null)
    3-Letter Country code (e.g. USA).

  - `entity.business_name` (string,null)
    The merchant's legal business name (max 120 characters).If INDIVIDUAL_SOLE_PROPRIETORSHIP, pass the owner's legal first name, last name, and middle initial.

  - `entity.business_phone` (string,null)
    Customer service phone number where the merchant can be reached (max 10 characters).

  - `entity.business_tax_id` (string)
    :

Nine digit Tax Identification Number (TIN), Employer Identification Number (EIN). If the  is  and they do not have an EIN, use the sole proprietor''s Social Security Number (SSN).

:

Nine-digit Business Number (BN) issued by the Canada Revenue Agency (CRA) for business tax purposes. If the business_type is INDIVIDUAL_SOLE_PROPRIETORSHIP and they do not have a Business Number, use the sole proprietor’s Social Insurance Number (SIN).

  - `entity.business_type` (string,null)
    Include the value that best applies to the merchant.

  - `entity.default_statement_descriptor` (string,null)
    The description of the  that appears on the buyer's bank or card statement.

  - `entity.discover_mid` (integer,null)
    Assigned discoverMid value.

  - `entity.dob` (object,null)
    The control owner's date of birth.

  - `entity.dob.day` (integer)
    Day of birth (between 1 and 31).

  - `entity.dob.month` (integer)
    Month of birth (between 1 and 12).

  - `entity.dob.year` (integer)
    Year of birth (4-digit). Year must be greater than 1900.

  - `entity.doing_business_as` (string,null)
    Alternate names of the business. If there are no other names, pass the same value used for  (max 60 characters).

  - `entity.email` (string,null)
    The email address of the principal control owner where they can be reached (max 100 characters).

  - `entity.first_name` (string,null)
    The legal first name of the merchant's control owner (max 20 characters).

  - `entity.has_accepted_credit_cards_previously` (boolean)
    Defaults to  if not passed.

  - `entity.incorporation_date` (object,null)
    The date the company was founded and registered.

  - `entity.incorporation_date.day` (integer)
    Day business was incorporated (between 1 and 31).

  - `entity.incorporation_date.month` (integer)
    Month business was incorporated (between 1 and 12).

  - `entity.incorporation_date.year` (integer)
    Year business was incorporated (4-digit).

  - `entity.last_name` (string,null)
    The legal last name of the merchant's control owner (max 20 characters).

  - `entity.max_transaction_amount` (integer,null)
    The maximum amount (in cents) that can be charged for a single transaction (max 12 characters).

  - `entity.mcc` (string,null)
    The Merchant Category Code ([MCC](http://www.dm.usda.gov/procurement/card/card\_x/mcc.pdf)) that this merchant will be classified under. For a list of approved MCCs, see [Approved Merchant Category Codes.](/guides/managing-operations/security-compliance/approved-merchant-category-codes)

  - `entity.ownership_type` (string,null)
    Values can be either: PUBLIC to indicate a publicly-traded company.PRIVATE for privately-held businesses.
    Enum: "PUBLIC", "PRIVATE"

  - `entity.personal_address` (object,null)
    The entity's personal address.

  - `entity.personal_address.region` (string,null)
    2-letter State code.

  - `entity.personal_address.country` (string,null)
    3-Letter country code (e.g. USA).

  - `entity.phone` (string,null)
    The principal control owner's phone number (max 10 characters).

  - `entity.principal_percentage_ownership` (integer,null)
    Percentage of the company owned by the principal control owner (min 0; max 100).

  - `entity.short_business_name` (string,null)
    Abbreviated names of the business. If there are no abbreviated name, leave this field blank.

  - `entity.tax_authority` (string,null)
    Only required when onboarding a merchant with a MCC of 9311.The tax_authority is the tax gathering entity (e.g., San Francisco Water Authority).

  - `entity.title` (string,null)
    The corporate title of the control owner (e.g. Chief Executive Officer, CFO, etc. Max 60 characters).

  - `entity.url` (string,null)
    The URL of the merchant's public website.

## Response 400 fields (application/json):

  - `total` (integer, required)
    Total number of errors returned.

  - `_embedded` (object, required)
    Container for embedded error objects.

  - `_embedded.errors` (array)
    List of individual error objects.

  - `_embedded.errors.code` (string)
    The error code. The  error code is returned for a 401 Unauthorized or 403 Forbidden request.

  - `_embedded.errors.logref` (object)

  - `_embedded.errors.message` (string)
    A human-friendly error message.

  - `_embedded.errors._links` (object)
    Links related to this error.

  - `_embedded.errors._links.source` (object)
    Link to the resource related to the error.

  - `_embedded.errors._links.source.href` (string)
    URL of the related resource.

## Response 401 fields (application/json):

  - `total` (integer, required)
    Total number of errors returned.

  - `_embedded` (object, required)
    Container for embedded error objects.

  - `_embedded.errors` (array)
    List of individual error objects.

  - `_embedded.errors.code` (string)
    The error code. The  error code is returned for a 401 Unauthorized or 403 Forbidden request.

  - `_embedded.errors.logref` (object)

  - `_embedded.errors.message` (string)
    A human-friendly error message.

  - `_embedded.errors._links` (object)
    Links related to this error.

  - `_embedded.errors._links.source` (object)
    Link to the resource related to the error.

  - `_embedded.errors._links.source.href` (string)
    URL of the related resource.

## Response 403 fields (application/json):

  - `total` (integer, required)
    Total number of errors returned.

  - `_embedded` (object, required)
    Container for embedded error objects.

  - `_embedded.errors` (array)
    List of individual error objects.

  - `_embedded.errors.code` (string)
    The error code. The  error code is returned for a 401 Unauthorized or 403 Forbidden request.

  - `_embedded.errors.logref` (object)

  - `_embedded.errors.message` (string)
    A human-friendly error message.

  - `_embedded.errors._links` (object)
    Links related to this error.

  - `_embedded.errors._links.source` (object)
    Link to the resource related to the error.

  - `_embedded.errors._links.source.href` (string)
    URL of the related resource.

## Response 404 fields (application/json):

  - `total` (integer, required)
    Total number of errors returned.

  - `_embedded` (object, required)
    Container for embedded error objects.

  - `_embedded.errors` (array)
    List of individual error objects.

  - `_embedded.errors.code` (string)
    The error code. The  error code is returned for a 401 Unauthorized or 403 Forbidden request.

  - `_embedded.errors.logref` (object)

  - `_embedded.errors.message` (string)
    A human-friendly error message.

  - `_embedded.errors._links` (object)
    Links related to this error.

  - `_embedded.errors._links.source` (object)
    Link to the resource related to the error.

  - `_embedded.errors._links.source.href` (string)
    URL of the related resource.

## Response 406 fields (application/json):

  - `total` (integer, required)
    Total number of errors returned.

  - `_embedded` (object, required)
    Container for embedded error objects.

  - `_embedded.errors` (array)
    List of individual error objects.

  - `_embedded.errors.code` (string)
    The error code. The  error code is returned for a 401 Unauthorized or 403 Forbidden request.

  - `_embedded.errors.logref` (object)

  - `_embedded.errors.message` (string)
    A human-friendly error message.

  - `_embedded.errors._links` (object)
    Links related to this error.

  - `_embedded.errors._links.source` (object)
    Link to the resource related to the error.

  - `_embedded.errors._links.source.href` (string)
    URL of the related resource.