# POST /discount-groups

**Create a discount group**

Creates a new discount group.

If successful, your response includes a copy of the new discount group entity.

**Required permissions:** `discount.write`

## Request body

- `name`: string (required) — Name of this discount group, typically something short and memorable for categorization. Not shown to customers. (Length: 1–500)

### Request example

```json
{
  "name": "Black Friday 2024"
}
```

## Response (201)

- `data`: object (required) — Represents a discount group entity.
  - `id`: string (required) — Unique Paddle ID for this discount group, prefixed with `dsg_`. (pattern: `^dsg_[a-z\d]{26}$`)
  - `name`: string (required) — Unique name of this discount group, typically something short and memorable for categorization. Not shown to customers. (Length: 1–500)
  - `status`: string (required) — Whether this entity can be used in Paddle.
  - `created_at`: string (date-time) (required) — RFC 3339 datetime string of when this entity was created. Set automatically by Paddle.
  - `updated_at`: string (date-time) (required) — RFC 3339 datetime string of when this entity was updated. Set automatically by Paddle.
  - `import_meta` (required) — Import information for this entity. `null` if this entity is not imported.
- `meta`: object (required) — Information about this response.
  - `request_id`: string (required) — Unique ID for the request relating to this response. Provide this when contacting Paddle support about a specific request.

### Response example

```json
{
  "data": {
    "id": "dsg_01js2gqehzccfkywgx1jk2mtsp",
    "status": "active",
    "name": "Black Friday 2024",
    "import_meta": null,
    "created_at": "2024-11-28T14:36:14.695Z",
    "updated_at": "2024-11-28T14:36:14.695Z"
  },
  "meta": {
    "request_id": "1681f87f-9c36-4557-a1da-bbb622afa0cc"
  }
}
```