> ## 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 community

> Creates a new community with the given name.



## OpenAPI

````yaml openapi.evolution-go.json POST /community/create
openapi: 3.1.0
info:
  title: Evolution GO Layer
  version: 1.0.0
  description: >-
    Pilot Status API Layer — Evolution GO. Base URL
    `https://pilotstatus.com.br/api/layer/evolution-go`. Authenticate with the
    `apikey` header (your Pilot Status `ps_` key) or `Authorization: Bearer`.
    Instance/session endpoints are NOT available through the layer.
servers:
  - url: https://pilotstatus.com.br/api/layer/evolution-go
security:
  - apiKey: []
tags:
  - name: Call (voice)
  - name: Chat
  - name: Community
  - name: Group
  - name: Label
  - name: Message
  - name: Newsletter / Channels
  - name: Send (load-balanced)
  - name: User / Contacts
paths:
  /community/create:
    post:
      tags:
        - Community
      summary: Create community
      description: Creates a new community with the given name.
      operationId: post__community_create
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                communityName:
                  type: string
                  description: Display name of the community to create.
                  example: Pilot Status Community
              required:
                - communityName
      responses:
        '200':
          description: Success — provider-native response body.
          content:
            application/json:
              schema:
                type: object
                description: >-
                  Envelope wrapping the created community (parent group)
                  metadata returned by whatsmeow (types.GroupInfo).
                properties:
                  message:
                    type: string
                    description: Constant success indicator ("success").
                  data:
                    type: object
                    description: >-
                      Full group metadata for the newly created community/parent
                      group.
                    properties:
                      JID:
                        type: string
                        description: Community (parent group) JID.
                      OwnerJID:
                        type: string
                        description: JID of the community owner/creator.
                      OwnerPN:
                        type: string
                        description: Owner phone-number JID (may be empty).
                      Name:
                        type: string
                        description: Community name.
                      NameSetAt:
                        type: string
                        format: date-time
                        description: When the name was set.
                      NameSetBy:
                        type: string
                        description: JID that set the name.
                      NameSetByPN:
                        type: string
                        description: Phone-number JID that set the name (may be empty).
                      Topic:
                        type: string
                        description: Community topic/description.
                      TopicID:
                        type: string
                        description: Identifier of the current topic.
                      TopicSetAt:
                        type: string
                        format: date-time
                        description: When the topic was set.
                      TopicSetBy:
                        type: string
                        description: JID that set the topic.
                      TopicSetByPN:
                        type: string
                        description: Phone-number JID that set the topic (may be empty).
                      TopicDeleted:
                        type: boolean
                        description: Whether the topic has been deleted.
                      IsLocked:
                        type: boolean
                        description: Whether group info can only be edited by admins.
                      IsAnnounce:
                        type: boolean
                        description: Whether only admins can send messages.
                      AnnounceVersionID:
                        type: string
                        description: Version id of the announce setting.
                      IsEphemeral:
                        type: boolean
                        description: Whether disappearing messages are enabled.
                      DisappearingTimer:
                        type: integer
                        description: Disappearing-messages timer in seconds.
                      IsIncognito:
                        type: boolean
                        description: Whether the group is incognito.
                      IsParent:
                        type: boolean
                        description: True for a community parent group.
                      DefaultMembershipApprovalMode:
                        type: string
                        description: >-
                          Default membership approval mode for sub-groups (e.g.
                          request_required).
                      LinkedParentJID:
                        type: string
                        description: >-
                          Parent community JID this group is linked to (empty
                          for a parent).
                      IsDefaultSubGroup:
                        type: boolean
                        description: Whether this is the default sub-group of a community.
                      IsJoinApprovalRequired:
                        type: boolean
                        description: Whether joining requires admin approval.
                      AddressingMode:
                        type: string
                        description: Addressing mode used by the group (e.g. pn or lid).
                      GroupCreated:
                        type: string
                        format: date-time
                        description: Community creation timestamp.
                      CreatorCountryCode:
                        type: string
                        description: Country code of the creator.
                      ParticipantVersionID:
                        type: string
                        description: Version id of the participant list.
                      Participants:
                        type: array
                        description: Members of the parent group.
                        items:
                          type: object
                          properties:
                            JID:
                              type: string
                              description: Primary JID used to message the participant.
                            PhoneNumber:
                              type: string
                              description: Phone-number JID of the participant.
                            LID:
                              type: string
                              description: LID JID of the participant.
                            IsAdmin:
                              type: boolean
                              description: Whether the participant is an admin.
                            IsSuperAdmin:
                              type: boolean
                              description: >-
                                Whether the participant is the
                                super-admin/owner.
                            DisplayName:
                              type: string
                              description: Display name (only for anonymous users).
                            Error:
                              type: integer
                              description: >-
                                Error code if adding this participant failed (0
                                on success).
                      ParticipantCount:
                        type: integer
                        description: Number of participants.
                      MemberAddMode:
                        type: string
                        description: Who may add members (admin_add or all_member_add).
                      Suspended:
                        type: boolean
                        description: Whether the group is currently suspended.
              example:
                message: success
                data:
                  JID: 120363313346837932@g.us
                  OwnerJID: 5511999999999@s.whatsapp.net
                  OwnerPN: 5511999999999@s.whatsapp.net
                  Name: Pilot Status Community
                  NameSetAt: '2026-07-10T13:45:12Z'
                  NameSetBy: 5511999999999@s.whatsapp.net
                  NameSetByPN: 5511999999999@s.whatsapp.net
                  Topic: ''
                  TopicID: ''
                  TopicSetAt: '0001-01-01T00:00:00Z'
                  TopicSetBy: ''
                  TopicSetByPN: ''
                  TopicDeleted: false
                  IsLocked: false
                  IsAnnounce: false
                  AnnounceVersionID: ''
                  IsEphemeral: false
                  DisappearingTimer: 0
                  IsIncognito: false
                  IsParent: true
                  DefaultMembershipApprovalMode: request_required
                  LinkedParentJID: ''
                  IsDefaultSubGroup: false
                  IsJoinApprovalRequired: false
                  AddressingMode: pn
                  GroupCreated: '2026-07-10T13:45:12Z'
                  CreatorCountryCode: BR
                  ParticipantVersionID: 1720619112-1
                  Participants:
                    - JID: 5511999999999@s.whatsapp.net
                      PhoneNumber: 5511999999999@s.whatsapp.net
                      LID: ''
                      IsAdmin: true
                      IsSuperAdmin: true
                      DisplayName: ''
                      Error: 0
                  ParticipantCount: 1
                  MemberAddMode: all_member_add
                  Suspended: false
        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>`.

````