Groups

Set group picture

Updates the group profile photo. Accepts a base64-encoded JPEG image in the request body and returns the new WhatsApp picture ID.

POST
/groups/{jid}/picture

Updates the group profile photo. Accepts a base64-encoded JPEG image in the request body and returns the new WhatsApp picture ID.

Authorization

bearerAuth
AuthorizationBearer <token>

Per-user API token (UUID v4) sent as Authorization: Bearer <token>. Identifies the tenant and user.

In: header

Path Parameters

jid*string

Group JID (e.g. 120363039000000000@g.us).

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/groups/string/picture" \  -H "Content-Type: application/json" \  -d '{    "image_base64": "/9j/4AAQSkZJRgABAQEAYABgAAD/2wBDAAUDBAQEAwUEBAQFBQUGBwwIBwcHBw8LCwkMEQ8SEhEPERETFhwXExQaFRERGCEYGh0dHx8fExciJCIeJBweHx7/2wBDAQ"  }'
{  "success": true,  "picture_id": "1718445600"}
{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}
{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}
{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}
{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}
{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}

Set disappearing message timer PUT

Sets the disappearing (ephemeral) message timer for a group. Duration is in seconds: 0 (off), 86400 (1 day), 604800 (7 days), or 7776000 (90 days).

Unlink a group from a community DELETE

Removes a child group from a WhatsApp community. The path JID is the community (parent) JID and the body carries the child group JID to be unlinked.