---
title: "Send connection request to a vendor"
method: POST
path: "/v3/network/invitation/vendor/{vendorId}"
tags: ["network"]
---

# Send connection request to a vendor

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

## Request

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

Send a connection request to a vendor organization in the BILL Network. BILL automatically connects the vendor organization with the vendor record in your BILL organization.

If the vendor organization has auto-connections disabled, BILL sends an invitation email to the vendor email address. When the vendor accepts the invitation, BILL connects the vendor organization with the vendor record in your BILL organization.

If the vendor does not respond, you can delete the connection request (with `DELETE /v3/network/invitation/vendor/{vendorId}`) before sending a new connection request.

**Note**: If the vendor does not respond to the 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

- CreateInvitationRequestDto: Create an organization in the BILL network
  - `networkId` string, required: Payment Network ID (PNI) of the organization you want to connect with. For a verified national vendor, the value begins with `0rv`. BILL uses the PNI to send and receive electronic payments. You can retrieve `networkId` from your `GET /v3/network` search result.
  - `networkType` 'BILL' | 'RPPS', required: Network type. * Select `BILL` for BILL Network * Select `RPPS` for verified national vendor network
  - `rppsInformation` object, nullable: Additional information required if `networkType` is `RPPS`
    - `accountNumber` string, required: Your billing statement account number with the verified national vendor organization. This value must match the vendor `accountNumber` set while creating or updating a vendor.
    - `addressId` string: BILL-generated ID of the billing address for the verified national vendor organization. The value begins with `0ra`. Each address is identified by a unique ID.

## Response `200`

Send connection request to a vendor 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)