> ## Documentation Index > Fetch the complete documentation index at: https://docs.api.stuut.co/llms.txt > Use this file to discover all available pages before exploring further. # Push a batch of customer master records from Boomi > Maximum 100 records per request. Each record is upserted by `customer_code` against `Partner.remote_id` within the tenant resolved from the API key. ## OpenAPI ````yaml https://api.stuut.ai/openapi.json post /v2/integrations/providers/boomi/customers openapi: 3.1.0 info: title: Stuut API termsOfService: https://stuut.ai/terms-and-conditions contact: name: Stuut Support url: https://stuut.ai/ email: devs@stuut.co version: 2.0.0 servers: [] security: - HTTPBearer: [] tags: - name: adjustments description: Operations for managing payment adjustments (fees, discounts, write-offs). x-displayName: Adjustments - name: aether description: Operations for aether. x-displayName: Aether - name: analytics description: Operations for retrieving analytics and dashboard data. x-displayName: Analytics - name: assistant description: Operations for the in-app chat assistant. x-displayName: Assistant - name: audit-log description: Operations for retrieving the organization's audit log. x-displayName: Audit Log - name: bank-accounts description: Operations for retrieving and managing bank accounts. x-displayName: Bank Accounts - name: bank-statements description: Operations for retrieving and managing bank statements. x-displayName: Bank Statements - name: bank-transactions description: Operations for retrieving and managing bank transactions. x-displayName: Bank Transactions - name: business-units description: Operations for listing and managing business units. x-displayName: Business Units - name: call-agent description: >- Operations for initiating and managing real-time voice calls with partners. x-displayName: Call Agent - name: calls description: Operations for retrieving and managing voice call records. x-displayName: Calls - name: cash-app description: Operations for cash application — matching incoming payments to invoices. x-displayName: Cash Application - name: chats description: Operations for managing chat conversations. x-displayName: Chats - name: cnam-registration description: Operations for managing CNAM (caller ID name) registration. x-displayName: CNAM Registration - name: credit-memos description: Operations for retrieving and searching credit memos. x-displayName: Credit Memos - name: custom-table-templates description: >- Operations for managing custom table templates used in email template variables. x-displayName: Custom Table Templates - name: customer-segments description: Operations for managing customer segments. x-displayName: Customer Segments - name: deductions-knowledge description: Operations for managing deduction processing knowledge entries. x-displayName: Deductions Knowledge - name: email-threads description: Operations for managing email threads. x-displayName: Email Threads - name: emails description: Operations for retrieving and managing emails. x-displayName: Emails - name: exports description: Operations for requesting and retrieving async data exports. x-displayName: Exports - name: integrations description: >- Operations for managing integrations with external systems (e.g. ERP, CRM, etc.). x-displayName: Integrations - name: internal-contacts description: >- Operations for managing internal contacts (CSMs, account managers, etc.) and their assignments to partners. x-displayName: Internal Contacts - name: invoices description: Operations for retrieving and managing invoices. x-displayName: Invoices - name: kyb description: Operations for Know Your Business (KYB) verification. x-displayName: KYB - name: ledger-accounts description: Operations for retrieving and managing ledger accounts. x-displayName: Ledger Accounts - name: mailbox-settings description: >- Operations for an organization's mailbox provider configuration: Microsoft admin consent, shared-mailbox discovery, and provider health. x-displayName: Mailbox Settings - name: mailboxes description: >- Operations for connecting, listing, updating, and archiving user and shared mailboxes, including delegated OAuth sign-in. x-displayName: Mailboxes - name: media description: >- Operations for signing direct-to-storage media uploads (e.g. signature images). x-displayName: Media - name: organizations description: Operations for retrieving and managing the current organization. x-displayName: Organizations - name: outreach-workflows description: Operations for managing automated collections outreach workflows. x-displayName: Outreach Workflows - name: partners description: Operations for retrieving and managing customers. x-displayName: Partners - name: payments description: Operations for approving and managing payments. x-displayName: Payments - name: report-configs description: >- Operations for managing report configurations (frequency, recipients, schedule). x-displayName: Report Configs - name: sms-campaign-registration description: Operations for managing A2P 10DLC SMS campaign registration. x-displayName: SMS Campaign Registration - name: sms-templates description: >- Operations for defining, storing, and managing parameterized SMS message templates. x-displayName: SMS Templates - name: sms-threads description: Operations for retrieving and managing SMS conversation threads. x-displayName: SMS Threads - name: users description: Operations for retrieving and managing users. x-displayName: Users - name: users-ooo description: Operations for managing user out-of-office (OOO) status and coverage. x-displayName: Users OOO paths: /v2/integrations/providers/boomi/customers: post: tags: - integrations summary: Push a batch of customer master records from Boomi description: >- Maximum 100 records per request. Each record is upserted by `customer_code` against `Partner.remote_id` within the tenant resolved from the API key. operationId: PostIntegrationsProvidersBoomiCustomers requestBody: content: application/json: schema: items: $ref: '#/components/schemas/BoomiCustomerPayload' type: array required: true responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/BoomiInboundResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - HTTPBearer: [] components: schemas: BoomiCustomerPayload: properties: customer_code: type: string title: '' description: KNA1-KUNNR; maps to Partner.remote_id name1: type: string title: '' description: KNA1-NAME1; maps to Partner.name name2: anyOf: - type: string - type: 'null' title: '' description: KNA1-NAME2; maps to Partner.legal_name name3: anyOf: - type: string - type: 'null' title: '' description: KNA1-NAME3; maps to Partner.name_3 street: anyOf: - type: string - type: 'null' title: '' description: ADRC-STREET house_num1: anyOf: - type: string - type: 'null' title: '' description: ADRC-HOUSE_NUM1 house_num2: anyOf: - type: string - type: 'null' title: '' description: ADRC-HOUSE_NUM2; maps to Address.line2 post_code1: anyOf: - type: string - type: 'null' title: '' description: ADRC-POST_CODE1; maps to Address.postal_code city1: anyOf: - type: string - type: 'null' title: '' description: ADRC-CITY1; maps to Address.city city2: anyOf: - type: string - type: 'null' title: '' description: ADRC-CITY2; maps to Partner.district region: anyOf: - type: string - type: 'null' title: '' description: ADRC-REGION; maps to Address.state country: anyOf: - type: string - type: 'null' title: '' description: ADRC-COUNTRY; ISO 3166 alpha-2 accounting_clerk: anyOf: - type: string - type: 'null' title: '' description: ADRC-ACCOUNTING_CLE1 accounting_clerk_name: anyOf: - type: string - type: 'null' title: '' smtp_addr: anyOf: - type: string - type: 'null' title: '' description: ADR6-SMTP_ADDR tel_number: anyOf: - type: string - type: 'null' title: '' description: ADR2-TEL_NUMBER telnr_long: anyOf: - type: string - type: 'null' title: '' description: >- 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: anyOf: - type: string - type: 'null' title: '' description: KNA1-TXJCD payment_method: anyOf: - type: string - type: 'null' title: '' description: ADRC-PAYMENT_MET1 search_term: anyOf: - type: string - type: 'null' title: '' description: ADRC-SEARCH_TER1 vendor_account_number: anyOf: - type: string - type: 'null' title: '' description: KNA1-LIFNR company_code: anyOf: - type: string - type: 'null' title: '' description: >- BKPF-BUKRS of any document under which this customer was posted. Optional — tenant routing is via the inbound Bearer key. Stored as a custom field if provided. type: object required: - customer_code - name1 title: BoomiCustomerPayload description: |- Customer master record per SAP KNA1 + ADRC. Field names follow the SAP technical fields the Boomi team is sending, matching the V.4 mapping sheet shared with Perkin-Elmer. BoomiInboundResponse: properties: received_at: type: string format: date-time title: '' results: items: $ref: '#/components/schemas/BoomiInboundResult' type: array title: '' type: object required: - received_at - results title: BoomiInboundResponse HTTPValidationError: $defs: ValidationError: properties: loc: items: anyOf: - type: string - type: integer title: Location type: array msg: title: Message type: string type: title: Type type: string required: - loc - msg - type title: ValidationError type: object x-speakeasy-include: true properties: type: const: request-validation title: Type type: string detail: anyOf: - type: string - type: 'null' default: null description: Human-readable description of this specific problem. title: Detail x-speakeasy-error-message: true status: const: 422 title: Status type: integer title: description: Short human-readable summary of the problem. title: Title type: string x-speakeasy-error-message: true errors: items: $ref: '#/components/schemas/ValidationError' title: Errors type: array required: - type - status - title - errors title: APIError type: object BoomiInboundResult: properties: remote_id: type: string title: '' success: type: boolean title: '' stuut_id: anyOf: - type: string - type: 'null' title: '' error_code: anyOf: - type: string - type: 'null' title: '' message: anyOf: - type: string - type: 'null' title: '' type: object required: - remote_id - success - stuut_id - error_code - message title: BoomiInboundResult ValidationError: properties: loc: items: anyOf: - type: string - type: integer title: Location type: array msg: title: Message type: string type: type: string title: Type required: - loc - msg - type title: ValidationError type: object x-speakeasy-include: true securitySchemes: HTTPBearer: type: http scheme: bearer ````