Create a US vendor

In your POST /v3/vendors request, set the required fields to create a US vendor.

Field	Description
`name`	Vendor name
`accountType`	Vendor account type (`BUSINESS`, `PERSON`, or `NONE`)
`email`	Vendor email address
`phone`	Vendor phone number
`address`	Vendor address information. Vendor address details are required for paying the vendor by check or for inviting the vendor to join the BILL network. - `line1` - `city` - `zipOrPostalCode` - `country`
`paymentInformation`	Vendor bank account information. Vendor bank account details are required for enabling electronic payments to the vendor. - `payeeName` - `nameOnAccount` - `accountNumber` - `routingNumber`

👍
Any vendor can be enrolled to accept vendor cards
A vendor can be enrolled to accept virtual card payments even without being connected in the BILL network. See Virtual card FAQ in the BILL Help Center for more information.

See the /v3/vendors API for more information about the other vendor fields you can set.

Sample request

In this cURL example, a vendor is created with the specified details. The address and paymentInformation details are added to enable electronic payments to the vendor.

curl --request POST \
--url 'https://gateway.stage.bill.com/connect/v3/vendors' \
--header 'content-type: application/json' \
--header 'devKey: {developer_key}' \
--header 'sessionId: {session_id}' \
--data '{
  "name": "Happy Music Supplies", 
  "accountType": "BUSINESS",
  "email": "[email protected]", 
  "phone": "9876543210",
  "address": {
    "line1": "123 Main Street",
    "city": "San Jose",
    "stateOrProvince": "CA",
    "zipOrPostalCode": "95002",
    "country": "US"
  },
  "paymentInformation": {
    "payeeName": "Happy Music Supplies",
    "bankAccount": {
      "nameOnAccount": "Bill Vendorson",
      "accountNumber": "111222333",
      "routingNumber": "074000010"  
    }
  },
  "billCurrency": "USD"
}'

Response

In the response, a BILL-generated vendor id is available. The value begins with 009. You can use this vendor id for other BILL operations.

{
  "id": "{vendor_id}",
  "archived": false,
  "name": "Happy Music Supplies",
  "accountType": "BUSINESS",
  "email": "[email protected]",
  "phone": "9876543210",
  "address": {
    "line1": "123 Main St",
    "city": "San Jose",
    "stateOrProvince": "CA",
    "zipOrPostalCode": "95002",
    "country": "US"
  },
  "paymentInformation": {
    "payeeName": "Happy Music Supplies",
    "payByType": "ACH",
    "virtualCard": {
      "status": "UNENROLLED"
    },
    "bankAccount": {
      "nameOnAccount": "Bill Venderson",
      "accountNumber": "*****2333",
      "routingNumber": "074000010",
      "type": "CHECKING",
      "ownerType": "BUSINESS"
    }
  },
  "additionalInfo": {
    "track1099": false,
    "combinePayments": true
  },
  "bankAccountStatus": "NO_NET_LINKED_ACCOUNT",
  "recurringPayments": false,
  "billCurrency": "USD",
  "createdTime": "2025-12-29T23:25:27.127+00:00",
  "updatedTime": "2025-12-29T23:25:28.127+00:00",
  "balance": {
    "amount": 0
  },
  "autoPay": {
    "enabled": false
  },
  "networkStatus": "NOT_CONNECTED"
}

See the /v3/vendors API for more information about the complete list of vendor operations.

👍Any vendor can be enrolled to accept vendor cards

Sample request

Response

👍
Any vendor can be enrolled to accept vendor cards