v1

latestOpenAPI 3.0.12026-07-24310590875.6 KB

network

Accept connection request

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.

post/v3/network/invitation/accept

Headers

sessionIdstring nullable

API session ID generated with /v3/login

Example:{{session_id}}

devKeystring nullable

Developer key generated with your BILL developer account

Example:{{developer_key}}

Request body

networkIdstring 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

idstring 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.

namestring 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

Accept connection request response