---
title: "Assigns a contact to teams"
method: PUT
path: "/api/ext/v3/contacts/teams"
tags: ["Contacts"]
---

# Assigns a contact to teams

`PUT /api/ext/v3/contacts/teams`

## Request body

- AssignContactToTeamsRequest — Request model for assigning a contact to teams.
  - `target` string, required — The target contact in the following formats: * **`ContactId`**: The unique ID of a contact. * **`PhoneNumber`**: The contact's phone number (e.g., `14155552671`). * **`Channel:PhoneNumber`**: A combination of the channel (name or phone number) and the recipient's phone number (e.g., `MyChannel:1415552671`, `123456789:1415552671`).
  - `teams` string[], required — List of teams to assign.

## Response `200`

Returns the assign result.

- AssignContactToTeamsResponse — Response model for assigning a contact to teams.
  - `result` boolean — Result of the team assignment operation.

## Other responses

- `400` — The request is invalid.
- `401` — The request is unauthorized.
- `403` — The request is forbidden.
- `429` — Too many requests. Either the rate limit has been exceeded or usage limits have been reached.
- `500` — Unexpected error occurred. Please try again.

---

[API](https://skmtc.dev/wati/apis/api-documentation-v3.md) · [All operations](https://skmtc.dev/wati/apis/api-documentation-v3/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/wati/api-documentation-v3/revisions/dee16d2c7d41/schema)