Skip to main content

Update Contact Group (v1)

Method & Path​

PATCH /api/v1/workspace/:workspaceId/sms/contact-groups/:groupId

Description​

Updates a contact group name and/or mobiles list.

Authentication​

Required: Workspace auth.

Persona Access:

  • Workspace Owner: Allowed
  • Staff (role-based): Requires sms.send
  • Customer(client): Not allowed

Headers​

  • Authorization: Bearer <workspaceToken>
  • Content-Type: application/json
  • X-Staff-Id: <staffId> (optional; required when acting as Staff)

Path Parameters​

NameTypeRequiredDescription
workspaceIdstringYesWorkspace ID
groupIdstringYesGroup ID

Request Body​

{
  "name": "VIP Updated",
  "mobiles": ["+970599000000"]
}

Response 200 OK​

{
  "group": {
    "id": "66f2...",
    "workspaceId": "66f0...",
    "name": "VIP Updated",
    "mobiles": ["+970599000000"],
    "createdAt": "2026-01-14T10:00:00.000Z",
    "updatedAt": "2026-01-14T10:10:00.000Z"
  }
}

Common Errors​

  • 400 Bad Request: Invalid identifiers
  • 401 Unauthorized: Missing/invalid workspace token
  • 403 Forbidden: Staff missing sms.send
  • 404 Not Found: Group not found
  • 422 Unprocessable Entity: Validation failed
  • 500 Internal Server Error: Unexpected error