How to create new payees and send bulk payments

Only paying payees already saved in Loop? See How to send bulk payments to saved payees instead.

Before you start

You need Admin or Account Owner access, or the Manage payments or Create payee payments permission. You must also be signed in using multi-factor authentication (MFA).

1. Download the template

Go to Send Payments → Bulk Payments → Import Instructions and download the CSV template.

Keep the column headers unchanged.

2. Add each payee and their payment

Use one row per payment. For each new payee, complete the following sections.

Payee information

Use the company or individual name fields depending on the payee type.

Column	What to enter
`payee_type`	`company` or `individual`. Required.
`company_name`	Legal company name. Required for companies.
`first_name` and `last_name`	First and last names, entered in their respective columns. Required for individuals. Neither can contain digits.
`email`	A valid email address. Optional.
`loop_display_nickname`	A display nickname for the payee. Optional.

Payee address

All address fields are required.

Column	What to enter
`street`	Street address.
`city`	City.
`state_or_province`	State or province code, such as `ON` or `CA`.
`postal_code`	Postal or ZIP code.
`country`	Two-letter country code, such as `CA`, `US` or `GB`.

Bank account information

Complete the banking fields below. Routing requirements vary by country and payment currency; see Bank details by country and currency below.

Column	What to enter
`bank_name`	Bank name. Required.
`bank_country`	The bank’s two-letter country code, such as `CA`, `US` or `GB`. Required.
`account_number`	Bank account number. Required. Use the IBAN for EUR accounts or the CLABE for MXN accounts.
`routing_code_value`	The routing code required for the country and payment currency.
`swift_bic_code`	SWIFT/BIC code. Required for international transfers and EUR accounts.

Keep leading zeros: Excel and Google Sheets may remove zeros at the beginning of account numbers or routing codes. Add an apostrophe before the value, such as '00112345, to preserve them. Loop ignores the apostrophe during import.

Payment information

Include an amount, currency and reason for each payment. The remaining fields are optional.

Column	What to enter
`payment_amount`	A positive number, such as `1000.00`. Required.
`payment_currency`	The payment currency, such as `CAD` or `USD`. Required.
`payment_reason`	A description of the payment. Required. For INR payments, use an accepted reason listed below.
`source_account`	The account to pay from. Leave blank to use your Loop account in the payment currency, or use one of the formats below.
`notes`	Additional notes to include in the payment email. Optional.
`send_confirmation_email`	Enter `true` to email the payee a confirmation. Leave blank or enter `false` to send no confirmation email.

For a Loop account, enter INTERNAL_CAD, INTERNAL_USD, INTERNAL_EUR or INTERNAL_GBP.

For a Linked Account, use EXTERNAL_{CURRENCY}_{LAST4}, where LAST4 is the account number’s last four digits. Examples: EXTERNAL_CAD_1234 or EXTERNAL_USD_5678.

3. Upload and review

Save your file as a CSV and upload it under Send Payments → Bulk Payments → Upload & Process.

Review the payee and payment details, then approve the batch when you’re ready. No funds move before your review and approval.

If a payee is already saved: A matching email tells Loop to use the saved payee’s details and ignore any different payee information in that row. When email is blank, Loop can also match saved payees by bank details.

Bank details by country and currency

Use the requirements below alongside the banking fields above.

Country (payment currency)	What to enter
Canada (CAD)	Set `bank_country` to `CA`. In `routing_code_value`, enter the 3-digit institution number followed by the 5-digit transit number. Example: `00112345`, where `001` is the institution and `12345` is the transit.
United States (USD)	Set `bank_country` to `US`. Enter the ABA routing number in `routing_code_value`. Example: `021000021`.
United Kingdom (GBP)	Set `bank_country` to `GB`. Enter the sort code in `routing_code_value`. Example: `123456`.
Eurozone (EUR)	Enter the IBAN in `account_number` and complete `swift_bic_code`. Example IBAN: `DE89370400440532013000`. `routing_code_value` is not required. Use a bank country code from the list below this table.
Mexico (MXN)	Set `bank_country` to `MX`. Enter the CLABE in `account_number`. Example: `032180000118359719`. `routing_code_value` is not required.
India (INR)	Enter the IFSC code in `routing_code_value`. Example: `SBIN0001234`. Use an accepted payment reason from the list below this table.
Australia (AUD)	Enter the BSB code in `routing_code_value`. Example: `062000`.
Other country and currency combinations	Complete `account_number` and `swift_bic_code`.

Bank country codes for EUR payments

Use one of these values in bank_country:

AT, BE, GR, CY, DE, EE, ES, FI, FR, HR, IE, IT, LT, LU, LV, MT, NL, PT, SI, SK.

Payment reasons for INR payments

Enter one of these exact values in payment_reason:

advertising, advisor_fees, construction, education, exports, fund_investment, goods, hotel, insurance_claims, insurance_premium, loan_repayment, medical, other_fees, property_purchase, property_rental, royalties, services, share_investment, tax, transfer, travel, utilities.