---
title: "Assign teams to a campaign"
method: POST
path: "/api/v4/campaigns/{campaign_id}/teams"
tags: ["Campaigns"]
---

# Assign teams to a campaign

`POST /api/v4/campaigns/{campaign_id}/teams`

## Request

- Base URL: `https://{cluster_id}.voiso.com`
- URL: `https://{cluster_id}.voiso.com/api/v4/campaigns/{campaign_id}/teams`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/voiso/apis/voiso-api/docs/api/v4/campaigns/:campaign_id/teams/post.ts> (a function with typed inputs; its response is checked against the schema)

Assigns teams to the specified campaign. The agents of an assigned team join the campaign, and later team membership changes reach the campaign. The campaign users list answers with those agents from the response on. AI agents of the team do not join: assign an AI agent to the campaign as a user.

## Path parameters

- `campaign_id` integer, required

## Request body

- object
  - `team_ids` integer[], required: List of team IDs to assign to the campaign.

## Response `200`

OK

- object
  - `added_teams` Team[]: Teams assigned to the campaign.
    - `id` integer: The unique identifier of the team.
    - `name` string: The name of the team.
    - `max_call_attempts` integer: The maximum number of call attempts allowed for the team.
    - `wrapup_code_group` WrapupCodeGroupShort
      - `id` integer: The unique identifier of the wrap-up code group.
      - `name` string: The name of the wrap-up code group.
    - `created_at` string, date-time: Timestamp when the team was created (ISO 8601).
    - `updated_at` string, date-time: Timestamp when the team was last updated (ISO 8601).

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `409`: Conflict
- `422`: Unprocessable Entity
- `429`: Too many requests

## Changes

- **2026-11-03** `5a6ea146bd21`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/voiso/apis/voiso-api/changes/api/v4/campaigns/:campaign_id/teams/post.md)

---

[API](https://skmtc.dev/voiso/apis/voiso-api.md) - [All operations](https://skmtc.dev/voiso/apis/voiso-api/llms.txt) - [OpenAPI document](https://skmtc.dev/voiso/apis/voiso-api/revisions/5a6ea146bd21?raw)