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

# Push a batch of customer contact records from Boomi

`POST /v2/integrations/providers/boomi/contacts`

## 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/contacts`
- Auth: HTTP bearer

Maximum 100 records per request. Each contact is upserted by `remote_id`
under every company-code partner of the customer named by `customer_code`,
so the same person is reachable from each entity's statements and dunning.

## Request body

- BoomiContactPayload[]
  - `remote_id` string, required: SAP contact identifier (Contact.remote_id)
  - `customer_code` string, required: KNA1-KUNNR of the parent customer
  - `name` string, nullable
  - `email` string, nullable: ADR6-SMTP_ADDR. Optional — a missing/null/blank email is stored as an empty string rather than rejecting the record.
  - `phone` string, nullable
  - `job_title` string, nullable
  - `company_code` string, nullable: BKPF-BUKRS of the parent customer. Optional — tenant routing is via the inbound Bearer key.

## 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)