Accept Incoming Address Book Request

This recipe outlines the steps to accept an incoming address book request sent by another Customers Bank customer. By accepting an address book request the user is establishing a connection between the accounts, enabling both the receipt and initiation of book transfers.

Step 1: Authenticate API

Endpoint: https://cubi-sandbox-api.customersbank.com/security/v1/authenticate/token

Description: Authenticate and receive an API token

Example Request:

POST /security/v1/authenticate/token HTTP/1.1
Host: cubi-sandbox-api.customersbank.com
Content-Type: application/json
Content-Length: 125

{
    "clientId": "ebb8a62b-e559-43d4-ae44-c7cdc5567320",
    "clientSecret": "12~3F~11111111111111111111111111111111"
}

Step 2: View Incoming Requests

Endpoint: https://cubi-sandbox-api.customersbank.com/transfers/v1/AddressBook/requests

Description: View all incoming requests that are pending approval or denial

Example Request:

Step 3: Approve Request

Endpoint: https://cubi-sandbox-api.customersbank.com/transfers/v1/AddressBook/requests/{id}/approve

Description: Approve a specific request to connect

Example Request:

Step 4: View Connections

Endpoint: https://cubi-sandbox-api.customersbank.com/transfers/v1/AddressBook/entries

Description: (Optional) View all address book connections to confirm the connection approved has been added

Example Request: