---
title: "Promote Groups"
method: POST
path: "/promote/groups"
tags: ["Promotions"]
---

# Promote Groups

`POST /promote/groups`

## Request

- Base URL: `https://env.unqork.io/api/1.0`
- URL: `https://env.unqork.io/api/1.0/promote/groups`
- Auth: OAuth 2
  - Client credentials
  - Password
  - Token URL: `https://xyzfinancial.unqork.io/api/1.0/oauth2/access_token`
- TypeScript: <https://skmtc.dev/unqork/apis/unqork-customer-api/docs/promote/groups/post.ts> (a function with typed inputs; its response is checked against the schema)

Promote specific groups or all groups
### Authorization Required:
  - Designer Administrator

## Request body

- PromotionGroupExecuteRequest
  - `clientName` string, required: Target environment name
  - `clientLevel` string, required: Level of the environment (qa, uat, production, etc.)
  - `groupNames` string[]: Names of the groups to promote

## Response `204`

Job Executed

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/unqork/apis/unqork-customer-api.md) - [All operations](https://skmtc.dev/unqork/apis/unqork-customer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/unqork/apis/unqork-customer-api/revisions/13dad4096373?raw)