Skip to main content
POST
/
group
/
create
curl --request POST \
  --url https://api.wppfy.com/group/create \
  --header 'Content-Type: application/json' \
  --header 'token: <api-key>' \
  --data '
{
  "name": "My New Group",
  "participants": [
    "5521987905995"
  ]
}
'
{
  "JID": "jid8@g.us",
  "OwnerJID": "1232@s.whatsapp.net",
  "Name": "Grupo de Suporte",
  "NameSetAt": "2023-11-07T05:31:56Z",
  "NameSetBy": "<string>",
  "Topic": "<string>",
  "IsLocked": true,
  "IsAnnounce": true,
  "AnnounceVersionID": "<string>",
  "IsEphemeral": true,
  "DisappearingTimer": 1,
  "IsIncognito": true,
  "IsParent": true,
  "IsJoinApprovalRequired": true,
  "LinkedParentJID": "<string>",
  "IsDefaultSubGroup": true,
  "GroupCreated": "2023-11-07T05:31:56Z",
  "ParticipantVersionID": "<string>",
  "Participants": [
    "<unknown>"
  ],
  "MemberAddMode": "admin_add",
  "OwnerCanSendMessage": true,
  "OwnerIsAdmin": true,
  "DefaultSubGroupId": "<string>",
  "invite_link": "<string>",
  "request_participants": "<string>"
}

Authorizations

​
token
string
header
required

Body

application/json
​
name
string
required

Group name

Required string length: 1 - 100
Example:

"WppFy Group"

​
participants
string[]
required

List of phone numbers of the initial participants

Required array length: 1 - 50 elements

Phone number without formatting

Example:
["5521987905995", "5511912345678"]

Response

Group created successfully

Representa um grupo/conversa coletiva

​
JID
string<jid>

Identificador único do grupo

Example:

"jid8@g.us"

​
OwnerJID
string<jid>

JID do proprietário do grupo

Example:

"1232@s.whatsapp.net"

​
Name
string

Nome do grupo

Example:

"Grupo de Suporte"

​
NameSetAt
string<date-time>

Data da última alteração do nome

​
NameSetBy
string<jid>

JID do usuário que definiu o nome

​
Topic
string

Descrição do grupo

​
IsLocked
boolean

Indica se apenas administradores podem editar informações do grupo

  • true = apenas admins podem editar
  • false = todos podem editar
Example:

true

​
IsAnnounce
boolean

Indica se apenas administradores podem enviar mensagens

​
AnnounceVersionID
string

Versão da configuração de anúncios

​
IsEphemeral
boolean

Indica se as mensagens são temporárias

​
DisappearingTimer
integer

Tempo em segundos para desaparecimento de mensagens

Required range: x >= 0
​
IsIncognito
boolean

Indica se o grupo é incognito

​
IsParent
boolean

Indica se é um grupo pai (comunidade)

​
IsJoinApprovalRequired
boolean

Indica se requer aprovação para novos membros

​
LinkedParentJID
string<jid>

JID da comunidade vinculada

​
IsDefaultSubGroup
boolean

Indica se é um subgrupo padrão da comunidade

​
GroupCreated
string<date-time>

Data de criação do grupo

​
ParticipantVersionID
string

Versão da lista de participantes

​
Participants
any[]

Lista de participantes do grupo

​
MemberAddMode
enum<string>

Modo de adição de novos membros

Available options:
admin_add,
all_member_add
​
OwnerCanSendMessage
boolean

Verifica se é possível você enviar mensagens

​
OwnerIsAdmin
boolean

Verifica se você adminstrador do grupo

​
DefaultSubGroupId
string

Se o grupo atual for uma comunidade, nesse campo mostrará o ID do subgrupo de avisos

​
invite_link
string

Link de convite para entrar no grupo

​
request_participants
string

Lista de solicitações de entrada, separados por vírgula