Body Required

• customer_id string

  The ID associated to be with the customer for future requests. If not provided on customer creation, Canopy will generate this field.

  Format should match the following pattern: ^(?!can_).*$.

• name_prefix string

  Prefix to the customer's name.

• name_first string Required

  Customer's first name.

• name_middle string

  Customer's middle name.

• name_last string Required

  Customer's last name.

• name_suffix string

  Suffix to the customer's name.

• phone_number string Required

  Customer's phone number in E.164 format.

• address_line_one string Required

  Address line one.

• address_line_two string

  Address line two.

• address_city string Required

  Address city.

• address_state string Required

  Address state.

• address_zip string Required

  Five digit zipcode or nine digit 'ZIP+4'.

• address_country_code string

  ISO 3166-1 alpha-2 country code for the customer.

  Values are US, GB, CA, AF, AX, AL, DZ, AS, AD, AO, AI, AQ, AG, AR, AM, AN, AW, AU, AT, AZ, BS, BH, BD, BB, BY, BE, BZ, BJ, BM, BT, BO, BA, BW, BV, BR, IO, BN, BG, BF, BI, KH, CM, CV, KY, CF, TD, CL, CN, CX, CC, CO, KM, CG, CD, CK, CR, CI, HR, CU, CY, CZ, DK, DJ, DM, DO, EC, EG, SV, GQ, ER, EE, ET, FK, FO, FJ, FI, FR, GF, PF, TF, GA, GM, GE, DE, GH, GI, GR, GL, GD, GP, GU, GT, GG, GN, GW, GY, HT, HM, VA, HN, HK, HU, IS, IN, ID, IR, IQ, IE, IM, IL, IT, JM, JP, JE, JO, KZ, KE, KI, KR, KW, KG, LA, LV, LB, LS, LR, LY, LI, LT, LU, MO, MK, MG, MW, MY, MV, ML, MT, MH, MQ, MR, MU, YT, MX, FM, MD, MC, MN, ME, MS, MA, MZ, MM, NA, NR, NP, NL, NC, NZ, NI, NE, NG, NU, NF, MP, NO, OM, PK, PW, PS, PA, PG, PY, PE, PH, PN, PL, PT, PR, QA, RE, RO, RU, RW, BL, SH, KN, LC, MF, PM, VC, WS, SM, ST, SA, SN, RS, SC, SL, SG, SK, SI, SB, SO, ZA, GS, ES, LK, SD, SR, SJ, SZ, SE, CH, SY, TW, TJ, TZ, TH, TL, TG, TK, TO, TT, TN, TR, TM, TC, TV, UG, UA, AE, UM, UY, UZ, VU, VE, VN, VG, VI, WF, EH, YE, ZM, or ZW.

  Show More
• ssn string

  Social security number of the customer.

• international_customer_id string

  Any country-specific unique identifier for the customer.

• email string(email) Required

  The Customer's email address.

• date_of_birth string(date) Required

  Customer's date of birth in ISO 8601 format.

• business_details object
  Hide business_details attributes Show business_details attributes object

  • business_legal_name string Required

    The legal name of the Business.

  • doing_business_as string Required

    The DBA name of the Business.

  • business_ein string Required

    EIN of the business.

• assign_to_accounts array[object] | null

  An array of existing accounts to which this Customer should be assigned. If left empty, the customer will not be assigned to any accounts, and can be later assigned to an account via the Update an existing customer route. Customers only become meaningful agents in Canopy's servicing system once they are assigned to accounts.

  Not more than 100 elements.

  Hide assign_to_accounts attributes Show assign_to_accounts attributes array[object] | null

  • account_id string Required

    This is generated by Canopy. A unique ID for the account.

  • customer_account_role string Required

    The role of the customer for the account.

    Values are PRIMARY or SECONDARY. Default value is PRIMARY.

  • customer_account_external_id string

    A unique number for the customer on the account. For instance, a credit card number. If none is provided, a Canopy-generated ID can be used.

  • customer_account_issuer_processor_config object
    Hide customer_account_issuer_processor_config attributes Show customer_account_issuer_processor_config attributes object

    • spend_limit integer | null

      Spending limit of card (in cents). If not provided, spending is still subject to the spend limit set at the issuer processor account (if any).

      Minimum value is 1.

    • lithic object
      Hide lithic attributes Show lithic attributes object

      • memo string

        Friendly name to identify the card.

      • type string

        The type of card created by Lithic.

        Values are SINGLE_USE, MERCHANT_LOCKED, or UNLOCKED.

      • state string

        The state of the new card.

        Values are OPEN or PAUSED.

      • card_program_token string(uuid)

        Token belonging to the card program under which to create the card.