---
title: "Create number group"
method: POST
path: "/api/relay/rest/number_groups"
tags: ["Number Groups"]
---

# Create number group

`POST /api/relay/rest/number_groups`

Creates a named pool for project-owned phone numbers, with optional sticky-sender behavior. Use it when outbound traffic should select from a managed group rather than one fixed number; add numbers afterward with [Create number group membership](/docs/apis/rest/number-groups/create-number-group-membership). This operation does not purchase phone numbers.

#### Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Numbers_.

[Learn more about API scopes](/docs/platform/your-signalwire-api-space).

## Request body

- CreateNumberGroupRequest — Request body for creating a number group.
  - `name` string, required — The name given to the number group. Helps to distinguish different groups within your project.
  - `sticky_sender` boolean — Whether the number group uses the same 'From' number for outbound requests to a number, or chooses a random one.

## Response `200`

The request has succeeded.

- NumberGroupResponse — Response containing a single number group.
  - `id` string, uuid, required — Universal Unique Identifier.
  - `name` string, required — The name given to the number group. Helps to distinguish different groups within your project.
  - `sticky_sender` boolean, required — Whether the number group uses the same 'From' number for outbound requests to a number, or chooses a random one.
  - `phone_number_count` integer, required — The number of phone numbers within the group.

## Other responses

- `401` — Access is unauthorized.
- `422` — The request failed validation. See errors for details.
- `500` — An internal server error occurred.

---

[API](https://skmtc.dev/signalwire/apis/signalwire-rest-api.md) · [All operations](https://skmtc.dev/signalwire/apis/signalwire-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/signalwire/signalwire-rest-api/revisions/792d5b8e2970/schema)