---
title: "Send connection request to a vendor not in the BILL Network"
method: POST
path: "/v3/network/invitation/vendor/{vendorId}/email"
tags: ["network"]
---

# Send connection request to a vendor not in the BILL Network

`POST /v3/network/invitation/vendor/{vendorId}/email`

## Request

- Base URL: `https://gateway.stage.bill.com/connect`
- URL: `https://gateway.stage.bill.com/connect/v3/network/invitation/vendor/{vendorId}/email`
- Auth: none declared

Send a connection request to a vendor not in the BILL Network.

BILL sends an invitation email to the provided vendor email address. When the vendor accepts the invitation and sets up a BILL account, BILL connects the vendor organization with the vendor record in your BILL organization.

**Note**:
* The vendor organization must exist before BILL can send an invitation email.
* If the vendor does not respond to a connection request for 60 days, the request expires.

See [BILL Network](https://developer.bill.com/docs/bill-network) in the Guides section for more information, sample requests, and responses.

## Path parameters

- `vendorId` string, required: BILL-generated ID of the vendor record in your organization. The value begins with `009`.

## Headers

- `sessionId` string, nullable: API session ID generated with `/v3/login`
- `devKey` string, nullable: Developer key generated with your BILL developer account

## Request body

- InviteVendorNotInBillNetworkRequestDto: Invite a vendor not in BILL network
  - `email` string, required: Vendor email address

## Response `200`

Send connection request to a vendor not in the BILL Network response

## Other responses

- `4XX`: List of errors.
- `5XX`: List of errors.

---

[API](https://skmtc.dev/bill/apis/bill-v3-api.md) - [All operations](https://skmtc.dev/bill/apis/bill-v3-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bill/apis/bill-v3-api/revisions/54edddceb0a5?raw)