WhatsApp Meta Graph API Application Connected Client Businesses API

openapi: 3.2.0
info:
  title: Meta Graph API - Application Connected Client Businesses…
  version: v23.0
  description: 'API for retrieving connected client businesses associated with a Meta application.


    This endpoint allows applications to retrieve information about businesses that have

    established client connections through the application. This is essential for managing

    business relationships and understanding client business configurations.'
  contact:
    name: Meta Business Platform Team
    url: https://developers.facebook.com/support
  license:
    name: Meta Platform Terms
    url: https://developers.facebook.com/terms
  termsOfService: https://developers.facebook.com/terms
servers:
- url: https://graph.facebook.com
  description: Production Graph API server
- url: https://graph.facebook.com
- url: https://graph.facebook.com
  description: WhatsApp Business Cloud API
- url: https://graph.facebook.com
  description: Meta Graph API production server
tags:
- name: Meta Graph API Application Connected Client Businesses
paths:
  /{Version}/{group_id}:
    get:
      summary: Get Group Info
      description: Retrieve metadata about a single group
      operationId: getGroupInfo
      parameters:
      - $ref: '#/components/parameters/UserAgent'
      - $ref: '#/components/parameters/Authorization'
      - name: Version
        in: path
        required: true
        schema:
          type: string
      - name: group_id
        in: path
        required: true
        description: Group ID
        schema:
          type: string
        example: Y2FwaV9ncm91cDoxOTUwNTU1MDA3OToxMjAzNjMzOTQzMjAdOTY0MTUZD
      - name: fields
        in: query
        description: Comma-separated list of fields to return
        schema:
          type: string
        example: subject,description,participants,join_approval_mode
      responses:
        '200':
          description: Group information
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GroupInfo'
      security:
      - bearerAuth: []
      tags:
      - Meta Graph API Application Connected Client Businesses
    delete:
      summary: Delete Group
      description: Delete the group and remove all participants, including the business
      operationId: deleteGroup
      parameters:
      - $ref: '#/components/parameters/UserAgent'
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/ContentType'
      - name: Version
        in: path
        required: true
        schema:
          type: string
      - name: group_id
        in: path
        required: true
        description: Group ID
        schema:
          type: string
      responses:
        '200':
          description: Group deletion successful
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
      security:
      - bearerAuth: []
      tags:
      - Meta Graph API Application Connected Client Businesses
    post:
      summary: Update Group Settings
      description: Update the subject, description, and photo of a group
      operationId: updateGroupSettings
      parameters:
      - $ref: '#/components/parameters/UserAgent'
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/ContentType'
      - name: Version
        in: path
        required: true
        schema:
          type: string
      - name: group_id
        in: path
        required: true
        description: Group ID
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - messaging_product
              properties:
                messaging_product:
                  type: string
                  enum:
                  - whatsapp
                subject:
                  type: string
                  maxLength: 128
                  description: The new subject for the group
                  example: Watch Enthusiasts
                description:
                  type: string
                  maxLength: 2048
                  description: The new description for the group
                  example: Join our community to discuss the latest timepieces, share watch reviews, and connect with fellow horology enthusiasts.
                profile_picture_file:
                  type: string
                  description: Path to an image file for group profile picture
          multipart/form-data:
            schema:
              type: object
              properties:
                messaging_product:
                  type: string
                  enum:
                  - whatsapp
                file:
                  type: string
                  format: binary
                  description: Image file for group profile picture (JPEG, max 5MB, square format, min 192x192)
      responses:
        '200':
          description: Group settings updated successfully
      security:
      - bearerAuth: []
      tags:
      - Meta Graph API Application Connected Client Businesses
components:
  schemas:
    GroupInfo:
      type: object
      properties:
        id:
          type: string
          description: Group ID
        messaging_product:
          type: string
          example: whatsapp
        join_approval_mode:
          type: string
          enum:
          - approval_required
          - auto_approve
          description: Join approval mode for the group
        subject:
          type: string
          description: Group subject
          example: Artificial Intelligence Insights
        description:
          type: string
          description: Group description
          example: Explore AI developments, share knowledge, and discuss the future of artificial intelligence with fellow enthusiasts and experts.
        suspended:
          type: boolean
          description: Returns true if the group has been suspended by WhatsApp
        creation_timestamp:
          type: integer
          description: UNIX timestamp in seconds at which the group was created
          example: 683731200
        participants:
          type: array
          description: List of participants in the group
          items:
            type: object
            properties:
              wa_id:
                type: string
                description: WhatsApp user ID
        total_participant_count:
          type: integer
          description: Total number of participants in the group, excluding your business
          example: 6
  parameters:
    Authorization:
      name: Authorization
      in: header
      description: 'Bearer token for API authentication. This should be a valid access token obtained through the appropriate OAuth flow or system user token.

        '
      required: true
      schema:
        type: string
        pattern: ^Bearer\s+[A-Za-z0-9\-_.]+.*$
        example: Bearer EAABwzLixnjYBOzYmNMJJGfHq9DgNh...
    UserAgent:
      name: User-Agent
      in: header
      description: The user agent string identifying the client software making the request.
      required: false
      schema:
        type: string
        default: Meta-Business-Messaging-OpenAPI/1.0.0;spec=2025-10-21
        pattern: ^[a-zA-Z0-9\-_]+\/[0-9]+\.[0-9]+\.[0-9]+(;[a-zA-Z0-9\-=\.]+)?(\s+[a-zA-Z0-9\-_]+\/[0-9\-\.]+)?$
        example: Meta-Business-Messaging-OpenAPI/1.0.0;spec=2025-10-21
    ContentType:
      name: Content-Type
      in: header
      description: Media type of the request body
      required: true
      schema:
        type: string
        enum:
        - application/json
        - application/x-www-form-urlencoded
        - multipart/form-data
        default: application/json
        example: application/json
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: 'System user access token with whatsapp_business_management permission. Format: Bearer YOUR_SYSTEM_USER_ACCESS_TOKEN

        '