---
title: "Move a number to another profile"
method: PATCH
path: "/v1/whatsapp/phone-numbers/{id}/profile"
tags: ["WhatsApp Phone Numbers"]
---

# Move a number to another profile

`PATCH /v1/whatsapp/phone-numbers/{id}/profile`

Move a provisioned number to a different profile.

A number is not a single record. Alongside the number itself there are
hidden telephony owner accounts (platform `phone`, plus `sms` when SMS is
enabled) and, once WhatsApp is connected, the `whatsapp` account. They all
carry a profileId and this endpoint moves them together.

Use this instead of `PATCH /v1/accounts/{accountId}`: that one moves the
social account only and leaves the number itself pinned to its original
profile, which splits the number across two profiles. Connecting a
Zernio-provisioned number from any profile but its own is rejected with a
`409` (`WHATSAPP_NUMBER_PINNED_TO_PROFILE`). This endpoint is how you
re-home the number first, so it can then be connected from the new profile.

`id` is the number record id from `GET /v1/phone-numbers`, not an account id.

A profile holds at most one account per platform, so the destination must be
free of every platform this number occupies.

## Path parameters

- `id` string, required

## Request body

- object
  - `profileId` string, required — Destination profile id. Must belong to the same team.

## Response `200`

Number moved, or already on that profile.

- object
  - `message` string
  - `profileId` string — The profile the number is now on.
  - `movedPlatforms` string[] — Platforms whose accounts travelled with the number (phone, sms, whatsapp). Absent when the number was already on the destination profile.

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `403` — No access to the source or destination profile, or the Inbox add-on is not active.
- `404` — Number not found, or the destination profile does not exist.
- `409` — The destination profile already holds an account on one of the platforms this number occupies.

---

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