curl --request POST \
  --url https://api.periskope.app/v1/chats/{chat_id}/add \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "participants": [
    "919537851844"
  ]
}'
{
  "919537851844@c.us": {
    "is_success": true,
    "message": "Invite sent to participant"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
x-phone
string

Please provide the number of the phone you want to call with this API in the header. The number must be in country code + number format without any characters or spaces, e.g. 919876543210; Alternatively, provide the phone_id (phone-xxxxxxxxxxxx) in the header

Example:

"{{orgPhone}}"

Path Parameters

​
chat_id
string
required
Example:

"120363371308389685@g.us"

Body

application/json
​
participants
string[]
required
  • Provide a list of participants to be added to the group (in country_code + number format).
  • Participants will be directly added to the group if they are in your phone contacts and their privacy settings allow it. If not, participants will receive an invite to join the group
Example:
["919537851844"]

Response

200 - application/json
200 OK

The response is an object with is_success value for each participant

Was this page helpful?

Generate a new invite link for a chatRemove Participant from Group