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

# Create group

> Creates a new WhatsApp group with a subject and an initial list of participants.



## OpenAPI

````yaml openapi.evolution-v2.json POST /group/create/{instance}
openapi: 3.1.0
info:
  title: Evolution V2 Layer
  version: 1.0.0
  description: >-
    Pilot Status API Layer — Evolution V2. Base URL
    `https://pilotstatus.com.br/api/layer/evolution-v2`. Authenticate with the
    `apikey` header (your Pilot Status `ps_` key). Instance/session endpoints
    are NOT available through the layer.
servers:
  - url: https://pilotstatus.com.br/api/layer/evolution-v2
security:
  - apiKey: []
tags:
  - name: Call & Business
  - name: Chat
  - name: Group
  - name: Label
  - name: Message
  - name: Profile
  - name: Settings & Proxy
  - name: Storage (S3)
  - name: Template
paths:
  /group/create/{instance}:
    post:
      tags:
        - Group
      summary: Create group
      description: >-
        Creates a new WhatsApp group with a subject and an initial list of
        participants.
      operationId: post__group_create_instance
      parameters:
        - name: instance
          in: path
          required: true
          schema:
            type: string
          description: The number's display name in the Pilot Status dashboard.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                subject:
                  type: string
                  description: Group name/subject.
                  example: Equipe de Vendas
                participants:
                  type: array
                  items:
                    type: string
                  description: Phone numbers (digits only) to add as members.
                  example:
                    - '5511999999999'
                    - '5511888888888'
                description:
                  type: string
                  description: Group description.
                  example: Grupo interno da equipe
                profilePicture:
                  type: string
                  description: URL of the group profile picture.
                  example: https://example.com/group.png
                promoteParticipants:
                  type: boolean
                  description: Promote the added participants to admins.
                  example: false
              required:
                - subject
                - participants
      responses:
        '200':
          description: Success — provider-native response body.
          content:
            application/json:
              schema:
                type: object
                description: >-
                  Raw Baileys group metadata of the newly created group
                  (returned by client.groupMetadata).
                properties:
                  id:
                    type: string
                    description: Group JID.
                  subject:
                    type: string
                    description: Group name/subject.
                  subjectOwner:
                    type: string
                    description: JID of the participant who last set the subject.
                  subjectTime:
                    type: integer
                    description: Unix timestamp (seconds) when the subject was last set.
                  size:
                    type: integer
                    description: Number of participants.
                  creation:
                    type: integer
                    description: Unix timestamp (seconds) when the group was created.
                  owner:
                    type: string
                    description: JID of the group owner/creator.
                  desc:
                    type: string
                    description: Group description text.
                  descId:
                    type: string
                    description: Identifier of the current description.
                  restrict:
                    type: boolean
                    description: If true, only admins can edit group info.
                  announce:
                    type: boolean
                    description: >-
                      If true, only admins can send messages (announcement
                      group).
                  isCommunity:
                    type: boolean
                    description: Whether this group is a community parent.
                  isCommunityAnnounce:
                    type: boolean
                    description: Whether this is a community announcement group.
                  joinApprovalMode:
                    type: boolean
                    description: Whether new members require admin approval to join.
                  memberAddMode:
                    type: boolean
                    description: Whether non-admin members are allowed to add participants.
                  ephemeralDuration:
                    type: integer
                    description: Disappearing-messages timer in seconds (0 when off).
                  linkedParent:
                    type: string
                    description: JID of the linked community parent, when applicable.
                  participants:
                    type: array
                    description: Group participants.
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: Participant JID.
                        admin:
                          type:
                            - string
                            - 'null'
                          enum:
                            - superadmin
                            - admin
                            - null
                          description: >-
                            Admin role: 'superadmin', 'admin', or null for a
                            regular member.
              example:
                id: 120363021234567890@g.us
                subject: Equipe Pilot Status
                subjectOwner: 5511999999999@s.whatsapp.net
                subjectTime: 1720545600
                size: 3
                creation: 1720545600
                owner: 5511999999999@s.whatsapp.net
                desc: Grupo oficial da equipe.
                descId: BAE5A1B2C3D4E5F6
                restrict: false
                announce: false
                isCommunity: false
                isCommunityAnnounce: false
                joinApprovalMode: false
                memberAddMode: false
                ephemeralDuration: 0
                participants:
                  - id: 5511999999999@s.whatsapp.net
                    admin: superadmin
                  - id: 5511988888888@s.whatsapp.net
                    admin: null
                  - id: 5511977777777@s.whatsapp.net
                    admin: null
        default:
          description: Error — provider or layer error.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                  error:
                    type: string
                  message:
                    type: string
                  response:
                    type: object
              example:
                status: 400
                error: Bad Request
                message: Invalid payload
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: apikey
      description: >-
        Your Pilot Status API key (ps_...). Evolution GO also accepts
        `Authorization: Bearer <key>`.

````