Accept connection request

post

https://gateway.stage.bill.com/connect/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 in the Guides section for more information, sample requests, and responses.

Body Params

networkId

string

required

length ≥ 1

Payment Network ID (PNI) of the customer or vendor that sent the invitation. BILL uses the PNI to send and receive electronic payments.

type

string

enum

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

Allowed:

string | null

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 | null

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.

Headers

sessionId

string | null

API session ID generated with /v3/login

devKey

string | null

Developer key generated with your BILL developer account

Responses

200

Accept connection request response

Language

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

4XXList of errors.

5XXList of errors.