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

# Send connection request to a customer

`POST /v3/network/invitation/customer/{customerId}`

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

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

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

**Note**: If the customer 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

- `customerId` string, required — BILL-generated ID of the customer record in your organization. The value begins with `0cu`.

## 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 customer response

## Other responses

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

---

[API](https://skmtc.net/bill/apis/bill-v3-api.md) · [All operations](https://skmtc.net/bill/apis/bill-v3-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bill/bill-v3-api/revisions/0483350c434e/schema)