---
title: "Update a business partner"
method: PATCH
path: "/v1/erp/payouts/business_partners/{id}"
tags: ["Business Partner"]
---

# Update a business partner

`PATCH /v1/erp/payouts/business_partners/{id}`

Updates a business partner's attributes, its nested `partner`, and/or its bank accounts.

Requires the `erp_business_partners_manage` permission (or company admin).

## Parameters

- `#/paths/~1v1~1erp~1payouts~1rules/get/parameters/0` — unresolved $ref
- `#/paths/~1v1~1erp~1payouts~1rules~1%7Bid%7D/get/parameters/1` — unresolved $ref

## Request body

- object — Body used to update a business partner. All fields are optional.
  - `name` string
  - `email` string
  - `payable_due_days` integer
  - `payable_payment_days` integer
  - `notify_on_payout` boolean
  - `notify_on_scheduled_payout` boolean
  - `partner` object
    - `id` string, uuid
    - `identifier` string
    - `name` string
    - `country` string
  - `business_partner_bank_accounts` object[]
    - `id` string, uuid
    - `bank_account_id` string, uuid
    - `name` string
    - `alias` string
    - `email` string
    - `default` boolean
    - `bank_account_attributes` object
      - `number` string
      - `account_type` string
      - `rut` string
      - `bank_id` string

## Response `200`

The updated business partner.

- BusinessPartner
  - `id` string, uuid, required
  - `company_id` string, uuid, required
  - `partner_id` string, uuid, required — The id of the underlying Person (partner) record shared across companies.
  - `name` string — Display name of the business partner for this company.
  - `email` string
  - `payable_due_days` integer, nullable — Default number of days used to compute the due date of new payables.
  - `payable_payment_days` integer, nullable — Default number of days used to compute the payment date of new payables.
  - `notify_on_payout` boolean
  - `notify_on_scheduled_payout` boolean
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `partner` object — The underlying Person record. Included in the `index` and `show` responses.
    - `id` string, uuid
    - `identifier` string — The RUT (or other tax identifier) of the partner.
    - `name` string
    - `country` string
  - `company` object — The company that owns this business partner relationship.
    - `id` string, uuid
    - `identifier` string
    - `name` string
  - `business_partner_bank_accounts` object[] — Bank accounts registered for this business partner. Only included in the `show` response. Each entry embeds its `bank_account`, the associated `bank_recipients`, and the `bank_recipient_ids` computed field.
    - `id` string, uuid
    - `bank_account_id` string, uuid
    - `name` string
    - `alias` string
    - `email` string
    - `default` boolean
    - `bank_recipient_ids` string[]

## Other responses

- `401` — Unauthorized
- `404` — Business partner not found
- `422` — Unprocessable Entity

---

[API](https://skmtc.dev/cardda/apis/banking-api.md) · [All operations](https://skmtc.dev/cardda/apis/banking-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cardda/banking-api/revisions/ff1aeb3fda8b/schema)