> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pocketflows.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update multiple customers

<Note>
  Batch update is done as "all or nothing." If any of the updates causes an
  error (say after updating two customers would have had the same email
  address), all updates in the batch are cancelled.
</Note>


## OpenAPI

````yaml POST /businesses/{id}/customers/batch_update
openapi: 3.0.3
info:
  title: Pocketflows API
  version: 0.0.4
servers:
  - url: https://api.pocketflows.com
    description: Production server
security:
  - HttpBasicAuth: []
paths:
  /businesses/{id}/customers/batch_update:
    post:
      tags:
        - Customers
      summary: Update multiple customers
      parameters:
        - in: path
          name: id
          schema:
            type: string
          description: The ID of the business
          required: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                customers:
                  type: array
                  items:
                    type: object
                    properties:
                      id:
                        type: string
                        description: The ID of the customer
                      phone_number:
                        type: string
                        nullable: true
                        description: The updated phone number of the customer
                      email_address:
                        type: string
                        nullable: true
                        description: The updated email address of the customer
                      metadata:
                        type: object
                        additionalProperties: true
                        nullable: true
                        description: The updated metadata of the customer
                      full_name:
                        type: string
                        nullable: true
                        description: The updated full name of the customer
                    required:
                      - id
                  description: >-
                    An array of customer data to update. Must identify every
                    customer with their ID
              required:
                - customers
      responses:
        '200':
          description: An array of updated `Customer` objects
          content:
            application/json:
              schema:
                type: object
                properties:
                  customers:
                    type: array
                    items:
                      $ref: '#/components/schemas/Customer'
                    description: An array of updated `Customer` objects
                required:
                  - customers
components:
  schemas:
    Customer:
      type: object
      properties:
        id:
          type: string
          description: The ID of the customer
        external_id:
          type: string
          nullable: true
          description: The external ID of the customer
        email_address:
          type: string
          nullable: true
          description: The email address of the customer
        phone_number:
          type: string
          nullable: true
          description: The phone number of the customer
        full_name:
          type: string
          nullable: true
          description: The full name of the customer
        metadata:
          type: object
          additionalProperties: true
          description: The metadata associated with this customer
        unsubscribed:
          type: string
          enum:
            - future
            - campaign
          nullable: true
          description: The unsubscribe status of the customer
      required:
        - id
        - external_id
        - email_address
        - phone_number
        - full_name
        - metadata
        - unsubscribed
      title: The Customer object
  securitySchemes:
    HttpBasicAuth:
      type: http
      scheme: basic

````