3D Secure Sessions2

Authorizations5

Balance Adjustments2

Balances4

Compliance Forms3

Devices6

Disbursement Rules2

Disputes12

Fee Profiles3

Fees4

Files8

Gateway Integrations3

Identities7

Merchants5

Microdeposits2

Onboarding Forms3

Payment Instrument Associations4

Payment Instruments8

Receipts4

Settlement Queue Entries3

Settlements11

Split Transfers2

Subscription Plans4

Subscriptions8

Transfer Attempts2

Transfers6

Users3

Verifications3

Webhooks4

post/identities/{identity_id}/verificationsVerify an Identity

Identities

Create an Associated Identity

Changed on Aug 22, 2026

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

post/identities/{identity_id}/associated_identities

Request

Base URL
https://finix.sandbox-payments-api.com
Auth
HTTP basic
TypeScript
https://skmtc.dev/finix/apis/finix-api-reference/docs/identities/:identity_id/associated_identities/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

Response

Associated Identity successfully created.

idstring

The ID of the resource.

created_atstring date-time

Timestamp of when the object was created.

updated_atstring date-time

Timestamp of when the object was last updated.

applicationstring

ID of the Application associated with the resource.

identity_rolesstring[]

The set of roles available to the Identity. If none is provided, the Identity will be assigned BUYER.

type'PERSONAL' | 'BUSINESS'

The Identity type.

tagsTags nullable

Include up to 50 key: value pairs to annotate requests with custom metadata.

Maximum character length for individual keys is 40.
Maximum character length for individual values is 500. (For example, order_number: 25, item_type: produce, department: sales)

Changes

Aug 22, 20267919e33b4853 Revision changes
- breaking
  added the new required request property //
- breaking
  added the new required request property //
- breaking
  added the new required request property //
- breaking
  added the new required request property //
- breaking
  added the new required request property //
- breaking
  the / request property type changed from no type to object
- breaking
  the response property / became nullable for the status
- breaking
  the / response's property type changed from no type to object for status
- warning
  removed from the / request property allOf list
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property //
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  the request property / became nullable
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  removed from the / response property allOf list for the response status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
Aug 8, 20265426f6f99c52 Revision changes
- breaking
  the / request property's maxLength was decreased to 20

Operation history

Create an Associated Identity

Request

Request body

Response 201Created

Changes

Response