> This is Payabli documentation. For a complete page index, fetch https://docs.payabli.com/llms.txt — append .md to any page URL for lightweight markdown. For section-level indexes, query parameters, and other AI-optimized access methods, see https://docs.payabli.com/ai-agents.md
# Create vendors (Portal)
> Add vendors to Payabli manually, by scanning an invoice, or with a bulk import
Vendors are the entities that offer goods or services to paypoints and organizations. They're who gets paid in money out (Pay Out) transactions. Before you can use vendors in bills and payouts, you must add them. There are three ways to add vendors in the Payabli Portal: manually, by scanning an invoice, or with a bulk import.
Payabli supports payouts to US and Canadian vendors only. International vendors aren't supported, and as a best practice you should avoid adding them in Payabli.
## Add a vendor manually
To add a single vendor by entering their details yourself, follow these steps:
1. Navigate to **Pay Out > Vendors** and click **Add Vendor**.
2. Click **Enter Manually**.
3. Complete the fields in these categories:
* **Account Information** — the vendor's identifying and contact details.
* **Billing Details** — the vendor's primary billing address.
* **Remit Details** — where payments are sent, when different from the billing address. To copy the billing address into these fields, select **Remit Details are the Same as Billing Details**.
* **Custom fields** — any custom fields your organization has configured.
4. Click **Create Vendor**.
The manual form groups fields into the following categories. These fields are required: Vendor/Business Name, Vendor Number, Billing Address, City, Country, State, and ZIP Code.
**Account Information**
* Vendor/Business Name
* Contact Name
* Account Number
* Vendor Number
* Tax ID / EIN
* Phone Number
* Business Structure (dropdown)
**Billing Details**
* Email Address
* Billing Address
* Billing Address 2
* City
* Country
* State
* ZIP Code
**Remit Details** use the same fields as Billing Details and are optional. To reuse the billing address, select **Remit Details are the Same as Billing Details**.
For the validation rules Payabli applies to each field (allowed characters, address requirements, EIN and phone formats), see [Field requirements and validation](/guides/pay-out-developer-vendors-manage#field-requirements-and-validation).
## Add a vendor by scanning an invoice
If you have the vendor's invoice as a file, Payabli can scan it and prefill the vendor's details, reducing manual data entry.
1. Navigate to **Pay Out > Vendors** and click **Add Vendor**.
2. Enter a **Vendor Number**. This is required before you can scan an invoice.
3. Drag the invoice file into the upload box. You can upload `.pdf`, `.jpg`, or `.png` files, up to 30 MB in total size.
4. Click **Scan Invoice**. Payabli scans the file and attempts to fill in the vendor's fields.
5. Review the prefilled fields across the same categories as manual entry — **Account Information**, **Billing Details**, **Remit Details**, and any custom fields — and correct anything the scan missed or got wrong.
6. Click **Create Vendor**.
## Import a vendor list
To add many vendors at once, import them from a CSV file. This is useful if you already have a vendor list to bring into Payabli.
Before uploading, download the sample file and use it as a reference for the correct format and column order. For field definitions and valid values, see [Field requirements and validation](/guides/pay-out-developer-vendors-manage#field-requirements-and-validation) in the API guide.
Download sample CSV
To upload your vendor list:
1. Navigate to **Pay Out > Vendors** and click **Import**.
2. In the Import Data modal, upload your CSV file by clicking the upload area or dragging the file into it. The file must be a single `.csv` under 2 MB. You can also download a sample file from this modal by clicking **Download Sample Files (\*.csv)**.
3. Click **Accept**.
The import inserts each row as a new vendor record and returns error messages if it encounters an error preventing it from creating new vendor records.
## Related resources
See these related resources to help you get the most out of Payabli.
#### Next steps
* **[Manage vendors (Portal)](/guides/pay-out-portal-vendors-manage)** - Once a vendor exists, manage its record and payment methods from here
#### Related topics
* **[Manage vendors with the API](/guides/pay-out-developer-vendors-manage)** - Learn how to add and manage vendors with the Payabli API
* **[Manage vendor payment methods (Portal)](/guides/pay-out-portal-vendor-payment-methods-manage)** - View, add, set a default, and delete a vendor's stored payment methods in the Payabli Portal