# Onboarding New Biller
source: https://developer.mastercard.com/rpps-biller-maintenance-service/documentation/use-cases/add-biller/index.md

### Onboarding New Biller {#onboarding-new-biller}

Concentrators can add their new billers via the Remote Payment and Presentment Service (RPPS) Biller Maintenance Service directly from their system. The API will ensure all the business rules are being met, and if not, will advise the Concentrator when issues arise and how to correct them. This is accomplished by calling the biller-request path.

## Adding a Biller {#adding-a-biller}

### Request - Static Test Data {#request---static-test-data}

Below is an example request body for onboarding a new biller.

```json
[
  {
    "billerRecordAction": "Add",
    "effectiveDate": "2030/12/31",
    "rppsBiller": {
      "billerInfo": {
        "rppsId": "01234567",
        "billerId": "0123456789",
        "billerName": "ABC Lawn Service",
        "batchName": "ABC Lawn",
        "billerClass": "INS",
        "billerType": "CRE",
        "remittanceRTN": 111111111,
        "remittanceDDA": 654321,
        "preNotes": "Y",
        "externalNotes": "Please remove all dashes from the consumer's account number before matching to the RPPS account mask and sending the payment."
      },
      "addresses": [
        {
          "type": "Sta",
          "address1": "PO BOX 1",
          "city": "O'FALLON",
          "state": "MO",
          "postalCode": "63368-0000"
        }
      ],
      "masks": [
        {
          "maskFormat": "##########",
          "maskDescriptions": [
            "auto"
          ]
        }
      ],
      "akas": [
        {
          "name": "Capital"
        }
      ]
    }
  }
]
```

### Response - Success {#response---success}

```json
{
  "billerRecordAction": "Add",
  "billerId": "0123456789",
  "statusDescription": "Successfully created workflow request.",
  "workRequestId": 123456,
  "effectiveDate": "2030/12/31"
}
```

### Response - Error {#response---error}

Example error showing what would happen if the client id used did not have access to onboard a biller.

```json
{
  "Errors": {
    "Error": [
      {
        "Source": "Bill Pay Biller Maintenance Service",
        "ReasonCode": "BPBCMAPIBLR_ERR_0004",
        "Description": "User Error",
        "Recoverable": true,
        "Details": "Client ID client-id-1234567890 does not have access to manage Billers\n"
      }
    ]
  }
}
```

## Next Steps {#next-steps}

For what is required in the payload, please refer to [Parameters](https://developer.mastercard.com/rpps-biller-maintenance-service/documentation/parameters/add-biller-parameters/index.md).

Please continue to [Work Request Status](https://developer.mastercard.com/rpps-biller-maintenance-service/documentation/use-cases/work-request-status/index.md).