---
title: "Push a batch of customer master records from Boomi"
method: POST
path: "/v2/integrations/providers/boomi/customers"
tags: ["integrations"]
---

# Push a batch of customer master records from Boomi

`POST /v2/integrations/providers/boomi/customers`

## Request

- Base URL: `https://api.stuut.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.stuut.ai/v2/integrations/providers/boomi/customers`
- Auth: HTTP bearer

Maximum 100 records per request. Each record is upserted by
`<customer_code>-<company_code>` against `Partner.remote_id` within the
tenant resolved from the API key — one partner per company-code
relationship. Records without a `company_code` come back as
COMPANY_CODE_REQUIRED.

## Request body

- BoomiCustomerPayload[]
  - `customer_code` string, required: KNA1-KUNNR; maps to Partner.remote_id
  - `name1` string, required: KNA1-NAME1; maps to Partner.name
  - `name2` string, nullable: KNA1-NAME2; maps to Partner.legal_name
  - `name3` string, nullable: KNA1-NAME3; maps to Partner.name_3
  - `street` string, nullable: ADRC-STREET
  - `house_num1` string, nullable: ADRC-HOUSE_NUM1
  - `house_num2` string, nullable: ADRC-HOUSE_NUM2; maps to Address.line2
  - `post_code1` string, nullable: ADRC-POST_CODE1; maps to Address.postal_code
  - `city1` string, nullable: ADRC-CITY1; maps to Address.city
  - `city2` string, nullable: ADRC-CITY2; maps to Partner.district
  - `region` string, nullable: ADRC-REGION; maps to Address.state
  - `country` string, nullable: ADRC-COUNTRY; ISO 3166 alpha-2
  - `accounting_clerk` string, nullable: ADRC-ACCOUNTING_CLE1
  - `accounting_clerk_name` string, nullable
  - `smtp_addr` string, nullable: ADR6-SMTP_ADDR
  - `tel_number` string, nullable: ADR2-TEL_NUMBER
  - `telnr_long` string, nullable: ADR2-TELNR_LONG. Long-format / E.164 phone. If both `tel_number` and `telnr_long` are sent, `telnr_long` wins (Partner has a single phone field).
  - `tax_jurisdiction` string, nullable: KNA1-TXJCD
  - `payment_method` string, nullable: ADRC-PAYMENT_MET1
  - `search_term` string, nullable: ADRC-SEARCH_TER1
  - `vendor_account_number` string, nullable: KNA1-LIFNR
  - `company_code` string, nullable: BKPF-BUKRS — the company code this customer relationship is billed under. Stuut keys a partner on (customer_code, company_code), so a customer trading with several PE entities must be pushed once per company code. A record without it is rejected with COMPANY_CODE_REQUIRED rather than being merged onto a partner the invoice feed would never match.

## Response `200`

Successful Response

- BoomiInboundResponse
  - `received_at` string, date-time, required
  - `results` BoomiInboundResult[], required
    - `remote_id` string, required
    - `success` boolean, required
    - `stuut_id` string, nullable, required
    - `error_code` string, nullable, required
    - `message` string, nullable, required

## Other responses

- `422`: Validation Error

---

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