Configuration Guide

Prerequisites:

Prior to this section, we recommend that you create a customer. While Accounts in Canopy can exist fully independent of a customer record, we strongly recommend including a Customer to contextualize the loan details. The customer <> account pairing is relevant for downstream services as well, such as Statements or Metro2 report generation.

📒

Note:

In the Create Account API call, you will need to link the customer ID from the Create Customer API call. If you are using one of Canopy’s out-of-the-box front-ends, unlinked Customers and unlinked Accounts will not be visible in the UI.

Create an Account

🔗 Create an Account

(Computational data like interest rate, loan amount, etc)
This is used for Revolving lines of credit, Installment loans, and MultiLoan products, and other hybrid-type loan agreements.

To build a more detailed understanding of how to structure your account creation payload, check out our Account Fundamentals pages. However, we recommend getting started with a simple payload from one of our Recipes.

💡

Tip

Customers and Accounts in Canopy have a many-to-many relationship. So, for example, you could set up two customers with a joint account (two customers to one account), or you could have a single customer with an installment loan and a charge card (one customer with two accounts).

Testing and Validation:

To validate account creation, you can retrieve your newly created account via the Get a specific Account API request.

Webhooks and Event Handling:

Account Creation and Account Update webhooks help you manage any systems that need to respond to changes in account state. Check out our Webhooks documentation to learn more.