---
title: "Accept connection request"
method: POST
path: "/v3/network/invitation/accept"
tags: ["network"]
---

# Accept connection request

`POST /v3/network/invitation/accept`

Accept a connection request sent by a vendor or customer.

The organization receiving the connection request must have auto-connections disabled. If auto-connections are not disabled, BILL automatically connects the organizations in the BILL Network.

When the invitation is accepted, BILL connects the two organizations in the BILL Network.

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

## Headers

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

## Request body

- AcceptInvitationRequestDto — Accept network invitation
  - `networkId` string, required — Payment Network ID (PNI) of the customer or vendor that sent the invitation. BILL uses the PNI to send and receive electronic payments.
  - `type` 'VENDOR' | 'CUSTOMER', required — Type of organization that sent the invitation. * Select `VENDOR` to accept a connection request from a vendor * Select `CUSTOMER` to accept a connection request from a customer
  - `id` string, nullable — BILL-generated ID of the existing vendor or customer record in your organization that you want to connect with. The value begins with `009` (vendor) or `0cu` (customer). When you set this field, you cannot set `name` in your request.
  - `name` string, nullable — Name of the new vendor or customer record that you want to add in your organization. BILL creates a new record with this name. When you set this field, you cannot set `id` in your request.

## Response `200`

Accept connection request 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)
