> Fetch clean Markdown by appending `.md` to any page URL under https://signalwire.com/docs or requesting it with the HTTP header `Accept: text/markdown`. The root index at https://signalwire.com/docs/llms.txt lists the available documentation indexes.

# Number Groups

> Manage number groups and membership.

[restclient]: /docs/server-sdks/reference/typescript/rest/client

[list]: /docs/server-sdks/reference/typescript/rest/number-groups/list

[create]: /docs/server-sdks/reference/typescript/rest/number-groups/create

[get]: /docs/server-sdks/reference/typescript/rest/number-groups/get

[update]: /docs/server-sdks/reference/typescript/rest/number-groups/update

[delete]: /docs/server-sdks/reference/typescript/rest/number-groups/delete

[listmemberships]: /docs/server-sdks/reference/typescript/rest/number-groups/list-memberships

[addmembership]: /docs/server-sdks/reference/typescript/rest/number-groups/add-membership

[getmembership]: /docs/server-sdks/reference/typescript/rest/number-groups/get-membership

[deletemembership]: /docs/server-sdks/reference/typescript/rest/number-groups/delete-membership

Manage number groups and their memberships. Number groups let you organize phone
numbers into logical collections for routing, billing, or management purposes.
This resource provides full CRUD on groups (with PUT for updates) plus membership
operations for adding and removing numbers.

Access via `client.numberGroups` on a [`RestClient`][restclient] instance.

```typescript {9}
import { RestClient } from "@signalwire/sdk";

const client = new RestClient({
  project: "your-project-id",
  token: "your-api-token",
  host: "your-space.signalwire.com"
});

const groups = await client.numberGroups.list();
for (const group of groups.data ?? []) {
    console.log(group.id, group.name);
}
```

## **Methods**

#### [list](/docs/server-sdks/reference/typescript/rest/number-groups/list)

List number groups in the project.

#### [create](/docs/server-sdks/reference/typescript/rest/number-groups/create)

Create a new number group.

#### [get](/docs/server-sdks/reference/typescript/rest/number-groups/get)

Retrieve a specific number group.

#### [update](/docs/server-sdks/reference/typescript/rest/number-groups/update)

Update a number group.

#### [delete](/docs/server-sdks/reference/typescript/rest/number-groups/delete)

Delete a number group.

#### [listMemberships](/docs/server-sdks/reference/typescript/rest/number-groups/list-memberships)

List phone numbers that belong to a group.

#### [addMembership](/docs/server-sdks/reference/typescript/rest/number-groups/add-membership)

Add a phone number to a group.

#### [getMembership](/docs/server-sdks/reference/typescript/rest/number-groups/get-membership)

Retrieve a specific membership.

#### [deleteMembership](/docs/server-sdks/reference/typescript/rest/number-groups/delete-membership)

Remove a phone number from a group.

> Manage number groups and membership.

## Docs

- [addMembership](https://signalwire.com/docs/server-sdks/reference/typescript/rest/number-groups/add-membership.md): Add a phone number to a group.
- [create](https://signalwire.com/docs/server-sdks/reference/typescript/rest/number-groups/create.md): Create a new number group.
- [delete](https://signalwire.com/docs/server-sdks/reference/typescript/rest/number-groups/delete.md): Delete a number group.
- [deleteMembership](https://signalwire.com/docs/server-sdks/reference/typescript/rest/number-groups/delete-membership.md): Remove a phone number from a group.
- [get](https://signalwire.com/docs/server-sdks/reference/typescript/rest/number-groups/get.md): Retrieve a specific number group.
- [getMembership](https://signalwire.com/docs/server-sdks/reference/typescript/rest/number-groups/get-membership.md): Retrieve a specific membership.
- [list](https://signalwire.com/docs/server-sdks/reference/typescript/rest/number-groups/list.md): List number groups in the project.
- [listMemberships](https://signalwire.com/docs/server-sdks/reference/typescript/rest/number-groups/list-memberships.md): List phone numbers that belong to a group.
- [update](https://signalwire.com/docs/server-sdks/reference/typescript/rest/number-groups/update.md): Update a number group.