SPspurnow
WhatsApp Groups

Update the subject and/or description of a WhatsApp group (asynchronous)

Asks Meta to update the group settings. Meta only acknowledges the request; the authoritative per-field result arrives on the group_settings_update webhook, which persists successes. The response carries the current (pre-update) conversation — clients should update optimistically and reconcile on the webhook-driven groupSettingsUpdate socket event.

post/v2/groups/{id}/settings

Request

  • Base URL
    https://api.spurnow.com
  • Auth
    HTTP bearer

Path parameters

idnumber required

Internal group conversation id.

Request body

subjectstring

New group subject (trimmed, 1-128 characters).

descriptionstring

New group description (trimmed, up to 2048 characters). An empty string clears the description.

Response

idnumber required
metaGroupIdstring nullable required
channelIdnumber required
requestIdstring nullable required
subjectstring nullable required
descriptionstring nullable required
notesstring nullable required

Internal group-level notes used as AI context. Never sent to WhatsApp.

inviteLinkstring nullable required
profilePictureUrlstring nullable required

S3 URL of the group icon Meta accepted. Rendered by the UI; Meta stores its own copy for delivery to WhatsApp. Null if never set or if a subsequent update was rejected by Meta.

lifecycleStatus'creating' | 'active' | 'suspended' | 'deleted' required
conversationStatus'OPEN' | 'CLOSED' required
assignedAgentIdnumber nullable required
assignedTeamIdnumber nullable required
lastMessageAtstring date-time nullable required
agentLastSeenAtstring date-time nullable required
createdAtstring date-time required
updatedAtstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.