---
updatedAt: 2025-10-02T22:25:50.000Z
agentTools:
  projectIndex: https://developer.bill.com/v2/llms.txt
---

# Invite a vendor not in the BILL network

Send an invitation to connect your organization with a vendor organization not in the BILL network. If the invited vendor does not have a BILL account, they can open a subscription-free Basic Receivables account and add a bank account to receive payments.

The default BILL email invitation is sent to the organization email address. Use the BILL web app to customize your vendor invitation and to send a reminder to a vendor. See [Connect to a vendor and set up ePayments](https://help.bill.com/hc/en-us/articles/115005307443-Connect-to-a-vendor-and-set-up-ePayments) in the BILL Help Center for more information.

When the invited vendor sets up their BILL account, BILL connects this vendor with your created vendor. If the invited vendor does not respond, cancel the invite (with `/v2/CancelInvite.json`) before sending a new invitation.  

**Note**: If the invited vendor does not respond to an invitation for 60 days, the invitation expires.

### Prerequisites
This is an MFA protected endpoint. Create an MFA-protected API session with `/v2/Login.json` before using `/v2/SendVendorInvite.json`.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "BILL network operations",
    "version": "2.0",
    "description": "BILL is a cloud-based cash flow management system for an organization's Accounts Payable (AP) and Accounts Receivable (AR) automation.\n * **AP**: Automate workflows to pay vendors bills at scale for the goods and services they provide. Pay vendors with a wide range of payment methods. Generate vendor credits, bill credits, and payment disbursement reports.\n * **AR**: Automate workflows to get paid by customers at scale for the goods and services you provide. Generate and send invoices on a schedule, generate customer and invoice credits, and seamlessly charge authorized customers.\n * **Organization**: Manage your bank accounts (for sending and receiving payments), users (with user roles), and sync with your choice of accounting software.\n\nIntegrate with the BILL API to send and receive payments for your business. See [Support Center](https://help.bill.com/hc/en-us) for resources about using the BILL web app.",
    "contact": {
      "email": "developerprogram@hq.bill.com"
    }
  },
  "servers": [
    {
      "url": "https://api-stage.bill.com/api/v2",
      "description": "Sandbox base URL"
    }
  ],
  "x-readme": {
    "samples-languages": [
      "curl",
      "java",
      "javascript",
      "python",
      "ruby"
    ],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "paths": {
    "/SendVendorInvite.json": {
      "post": {
        "summary": "Invite a vendor not in the BILL network",
        "operationId": "network-sendvendorinvite",
        "description": "Send an invitation to connect your organization with a vendor organization not in the BILL network. If the invited vendor does not have a BILL account, they can open a subscription-free Basic Receivables account and add a bank account to receive payments.\n\nThe default BILL email invitation is sent to the organization email address. Use the BILL web app to customize your vendor invitation and to send a reminder to a vendor. See [Connect to a vendor and set up ePayments](https://help.bill.com/hc/en-us/articles/115005307443-Connect-to-a-vendor-and-set-up-ePayments) in the BILL Help Center for more information.\n\nWhen the invited vendor sets up their BILL account, BILL connects this vendor with your created vendor. If the invited vendor does not respond, cancel the invite (with `/v2/CancelInvite.json`) before sending a new invitation.  \n\n**Note**: If the invited vendor does not respond to an invitation for 60 days, the invitation expires.\n\n### Prerequisites\nThis is an MFA protected endpoint. Create an MFA-protected API session with `/v2/Login.json` before using `/v2/SendVendorInvite.json`.",
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SendVendorInviteResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "required": [
                  "devKey",
                  "sessionId",
                  "data"
                ],
                "properties": {
                  "devKey": {
                    "type": "string",
                    "description": "Developer key generated with your BILL developer account"
                  },
                  "sessionId": {
                    "type": "string",
                    "description": "API session ID generated with [`/v2/Login.json`](ref:auth-login)"
                  },
                  "data": {
                    "$ref": "#/components/schemas/SendVendorInviteRequest"
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Network operations"
        ]
      },
      "parameters": []
    }
  },
  "components": {
    "schemas": {
      "SendVendorInviteRequest": {
        "type": "object",
        "required": [
          "vendorId",
          "email"
        ],
        "properties": {
          "vendorId": {
            "type": "string",
            "description": "BILL-generated ID of your vendor organization account. The value begins with `009`. Retrieve the `id` with `/v2/List/Vendor.json`."
          },
          "email": {
            "type": "string",
            "description": "Email address of the invited vendor"
          }
        }
      },
      "SendVendorInviteResponse": {
        "type": "object",
        "properties": {
          "response_status": {
            "type": "integer",
            "description": "Response status.\n* `0`: Success response\n* `1`: Error response. Only `error_code` and `error_message` is returned in `response_data`."
          },
          "response_message": {
            "type": "string",
            "description": "Response status.\n* `Success`: Success response\n* `Error`: Error response. Only `error_code` and `error_message` is returned in `response_data`."
          },
          "response_data": {
            "type": "string",
            "description": "Invitation request ID.\n\nYou can use this ID to cancel your invite with `/v2/CancelInvite.json`."
          }
        }
      }
    }
  }
}
```