---
title: "Run the same steps on several phones at once and get one job with a result per phone"
method: POST
path: "/groups"
tags: ["Groups and schedules"]
---

# Run the same steps on several phones at once and get one job with a result per phone

`POST /groups`

## Request

- Base URL: `https://api.clousd.com/v1`
- URL: `https://api.clousd.com/v1/groups`
- Auth: HTTP bearer

## Request body

- object
  - `phones` string[], required
  - `steps` object[], required
    - `op` string, required
    - `package` string
    - `action` string
    - `text` string
    - `seconds` integer
    - `vars` object
  - `stagger` integer[]: [min, max] seconds between starts, max 600
  - `vars_by_phone` object

## Response `202`

Started

- object
  - `ok` boolean
  - `job` Job
    - `id` string
    - `kind` string
    - `phone` string
    - `state` 'running' | 'done' | 'failed'
    - `started` string, date-time
    - `done` string, date-time
    - `output` string

## Other responses

- `400`: Error
- `404`: Error

---

[API](https://skmtc.dev/clousd/apis/clousd-api.md) · [All operations](https://skmtc.dev/clousd/apis/clousd-api/llms.txt) · [OpenAPI document](https://skmtc.dev/clousd/apis/clousd-api/revisions/0291ffd26ae3?raw)