---
title: "Add chat collaborators"
method: POST
path: "/collaborators/add"
tags: ["Collaborators"]
---

# Add chat collaborators

`POST /collaborators/add`

Adds team members to a chat as collaborators. Identify the chat with `from` (your WhatsApp Business number) and `to` (the customer number). `agentNumbers` must be phone numbers of users in your organization; they are matched after normalizing format (e.g. stripping + and spaces). You must have access to read the chat. The response reports per-number success and failure.

## Request body

- PublicChatCollaboratorsAddRemoveBodyDto
  - `from` string, required — WABA / WhatsApp Business number for the integration (matched against Integration.wabaNumber or credentials phone; digits only compared).
  - `to` string, required — Customer phone number (matched against Customer.phoneNumber; digits only compared).
  - `agentNumbers` string[], required — Phone numbers of agents to add or remove. Each must resolve to an org team member via User.phone.

## Response `200`

Collaborators updated (partial success allowed).

- PublicChatCollaboratorsAddRemoveResponseDto
  - `success` object[] — Inputs that resolved to a team member (phone + display name).
    - `number` string
    - `name` string, nullable
  - `failed` object[] — Inputs that did not resolve to an org team member (empty number, or no matching User.phone).
    - `number` string

## Other responses

- `400` — Bad request — invalid payload, chat could not be resolved, or validation failed.
- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/doubletick/apis/doubletick-public-apis.md) · [All operations](https://skmtc.net/doubletick/apis/doubletick-public-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/doubletick/doubletick-public-apis/versions/bba484527d34/schema)