WhatsApp Participants 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: Participants
paths:
  /{Version}/{group_id}/participants:
    post:
      summary: Add Group Participants
      description: Add participants to group
      operationId: addGroupParticipants
      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
              - participants
              properties:
                messaging_product:
                  type: string
                  enum:
                  - whatsapp
                participants:
                  type: array
                  maxItems: 8
                  minItems: 1
                  description: Array of phone numbers or WhatsApp IDs to remove (max 8 participants)
                  items:
                    type: object
                    required:
                    - user
                    properties:
                      user:
                        type: string
                        description: WhatsApp user phone number or WhatsApp user ID
                        example: '+17865347866'
      responses:
        '200':
          description: Participants addition request processed
      security:
      - bearerAuth: []
      tags:
      - Participants
    delete:
      summary: Remove Group Participants
      description: Remove participants from group
      operationId: removeGroupParticipants
      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
              - participants
              properties:
                messaging_product:
                  type: string
                  enum:
                  - whatsapp
                participants:
                  type: array
                  maxItems: 8
                  minItems: 1
                  description: Array of phone numbers or WhatsApp IDs to remove (max 8 participants)
                  items:
                    type: object
                    required:
                    - user
                    properties:
                      user:
                        type: string
                        description: WhatsApp user phone number or WhatsApp user ID
                        example: '+17865347866'
      responses:
        '200':
          description: Participants removal request processed
      security:
      - bearerAuth: []
      tags:
      - Participants
components:
  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

        '