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, thenetworkStatus
can beNOT_CONNECTED
, but the vendor virtual cardstatus
can be set asENROLLED
.See Virtual card FAQ in the BILL Help Center for more information.
Sample vendor.created
payload
vendor.created
payloadIn 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"
}
}
Updated 13 days ago