Create Depositor | Modernfi

curl -X POST https://api.modernfi.com/digital-banking/v1/depositors \
     -H "idempotency-key: idempotency-key" \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "tin": "string"
}'

{
  "id": "string",
  "institution_id": "string",
  "institution_depositor_id": "string",
  "first_name": "string",
  "last_name": "string",
  "entity_name": "string",
  "is_organization": true,
  "phone_numbers": [
    {
      "number": "string",
      "is_primary": true
    }
  ],
  "emails": [
    {
      "email_address": "string",
      "is_primary": true
    }
  ],
  "addresses": [
    {
      "street": "string",
      "city": "string",
      "state": "string",
      "zip": "string",
      "country_code": "string",
      "is_primary": true
    }
  ],
  "depositor_type": "CONSUMER",
  "ownership_category": "JOINT",
  "account_officer": "string",
  "notes": "string",
  "tin": "string"
}

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

tinstringRequired<=64 characters

TIN must be unique per institution

first_namestring or nullOptional<=32 characters

last_namestring or nullOptional<=32 characters

entity_namestring or nullOptional<=64 characters

is_organizationbooleanOptionalDefaults to false

institution_depositor_idstring or nullOptional<=64 characters

phone_numberslist of objects or nullOptional

emailslist of objects or nullOptional

addresseslist of objects or nullOptional

account_idslist of strings or nullOptional

depositor_typeenum or nullOptional

ownership_categoryenum or nullOptional

account_officerstring or nullOptional<=128 characters

notesstring or nullOptional<=256 characters

Response

Successful Response

idstring

institution_idstring

institution_depositor_idstring or null

first_namestring or null

last_namestring or null

entity_namestring or null

is_organizationboolean

phone_numberslist of objects

emailslist of objects

addresseslist of objects

depositor_typeenum

ownership_categoryenum or null

account_officerstring or null

notesstring or null

tinstring or nullDeprecated

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

422

Unprocessable Entity Error

500

Internal Server Error

Authentication

Headers

Request

Response

Errors