# Groups

## Modify

`client.groups.modify(GroupModifyParamsbody, RequestOptionsoptions?): GroupModifyResponse`

**post** `/api/modify-group`

Add or manage participants in a group chat (beta feature)

### Parameters

- **body:** `GroupModifyParams`

  - **group\_id:** `string`

    Group identifier

  - **modify\_type:** `"add_recipient"`

    Type of modification to perform

    - `"add_recipient"`

  - **number:** `string`

    Phone number to add/modify in E.164 format

### Returns

- `GroupModifyResponse`
  - **message:** `string`

  - **status:** `string`

### Example

```typescript
import SendblueAPI from 'sendblue-api';

const client = new SendblueAPI({
  apiKey: 'My API Key',
  apiSecret: 'My API Secret',
});

const response = await client.groups.modify({
  group_id: 'group_123456',
  modify_type: 'add_recipient',
  number: '+19998887777',
});

console.log(response.message);
```

## Send Message

`client.groups.sendMessage(GroupSendMessageParamsbody, RequestOptionsoptions?): MessageResponse`

**post** `/api/send-group-message`

Send a message to a group of recipients (beta feature)

### Parameters

- **body:** `GroupSendMessageParams`

  - **content:** `string`

    Message text content

  - **from\_number:** `string`

    **REQUIRED** - The phone number to send from. Must be one of your registered Sendblue phone numbers in E.164 format.
    Without this parameter, the message will fail to send.

  - **group\_id:** `string`

    Unique identifier for an existing group

  - **media\_url:** `string`

    URL of media file to send

  - **numbers:** `Array<string>`

    Array of recipient phone numbers in E.164 format

### Returns

- `MessageResponse`

### Example

```typescript
import SendblueAPI from 'sendblue-api';

const client = new SendblueAPI({
  apiKey: 'My API Key',
  apiSecret: 'My API Secret',
});

const messageResponse = await client.groups.sendMessage({
  content: 'Hello, everyone!',
  from_number: '+19998887777',
});

console.log(messageResponse.account_email);
```