Vendor created notification payloads

When you subscribe to the vendor.created event, BILL sends a notification when a vendor is created.

👍

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. In a vendor.created payload, the networkStatus can be NOT_CONNECTED, but the vendor virtual card status can be set as ENROLLED.

See Virtual card FAQ in the BILL Help Center for more information.

Sample vendor.created payload

In this sample unescaped JSON payload, the details of a created vendor are available. All the fields are included in each vendor.created payload.

{
    "metadata": {
        "eventId": "{event_id}",
        "subscriptionId": "{subscription_id}",
        "organizationId": "{organization_id}",
        "eventType": "vendor.created",
        "version": "1"
    },
    "vendor": {
        "id": "{vendor_id}",
        "name": "Happy Music Supplies",
        "archived": false,
        "email": "[email protected]",
        "phone": "9876543210",
        "networkStatus": "NOT_CONNECTED",
        "accountNumber": 987000654,
        "address": {
            "line1": "123 Main St",
            "line2": "Suite 200",
            "city": "San Jose",
            "stateOrProvince": "CA",
            "zipOrPostalCode": "95002",
            "country": "US"
        },
        "paymentInformation": {
            "payeeName": "Happy Music Supplies",
            "email": "[email protected]",
            "payByType": "CHECK",
            "virtualCard": {
                "status": "UNKNOWN"
            }
        },
        "additionalInfo": {
            "taxId": "9998887777",
            "taxIdType": "SSN",
            "track1099": true,
            "leadTimeInDays": 10,
            "combinePayments": true,
            "companyName": "Happy Music Supplies"
        },
        "recurringPayments": false,
        "billCurrency": "USD",
        "balance": {
            "amount": 0
        },
        "autoPay": {
            "enabled": false
        },
        "createdTime": "2025-12-15T22:53:15.127+00:00",
        "updatedTime": "2025-12-15T22:53:15.127+00:00" 
    }
}