---
title: "Create a business partner"
method: POST
path: "/v1/erp/payouts/business_partners"
tags: ["Business Partner"]
---

# Create a business partner

`POST /v1/erp/payouts/business_partners`

## Request

- Base URL: `https://api.cardda.com`
- URL: `https://api.cardda.com/v1/erp/payouts/business_partners`
- Auth: HTTP bearer

Creates a business partner for the company. Provide either an existing `partner_id`
or a nested `partner` object with an `identifier`; when the identifier does not yet
match an existing Person, a new Person is created and linked.

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

## Parameters

- `#/paths/~1v1~1erp~1payouts~1rules/get/parameters/0` (unresolved $ref)

## Request body

- object: Body used to create a business partner. Either `partner_id` (an existing Person) or a nested `partner` object with an `identifier` must be provided so the partner can be resolved or created.
  - `company_id` string, uuid: Company the business partner belongs to. Defaults to the `company-id` header.
  - `partner_id` string, uuid: Id of an existing Person to link as the partner.
  - `name` string
  - `email` string
  - `payable_due_days` integer
  - `payable_payment_days` integer
  - `notify_on_payout` boolean
  - `notify_on_scheduled_payout` boolean
  - `partner` object: Nested Person attributes. If `identifier` is present and no Person with that identifier exists yet, a new Person is created.
    - `id` string, uuid
    - `identifier` string: RUT (or other tax identifier) of the partner.
    - `name` string
    - `country` string
  - `business_partner_bank_accounts` object[]: Bank accounts to register for this business partner.
    - `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 `201`

The created 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
- `422`: Unprocessable Entity — validation failed (e.g. duplicate partner for the company).

---

[API](https://skmtc.dev/cardda/apis/banking-api.md) - [All operations](https://skmtc.dev/cardda/apis/banking-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cardda/apis/banking-api/revisions/ff1aeb3fda8b?raw)