---
title: "Removes a user's third-party identifier from an identity server."
method: POST
path: "/_matrix/client/v3/account/3pid/unbind"
tags: ["Account management"]
---

# Removes a user's third-party identifier from an identity server.

`POST /_matrix/client/v3/account/3pid/unbind`

## Request

- Base URL: `https://matrix.org`
- URL: `https://matrix.org/_matrix/client/v3/account/3pid/unbind`
- Auth: one of:
  - API key in query parameter `access_token`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/matrix/apis/matrix-client-server-api/docs/_matrix/client/v3/account/3pid/unbind/post.ts> (a function with typed inputs; its response is checked against the schema)

Removes a user's third-party identifier from the provided identity server
without removing it from the homeserver.

Unlike other endpoints, this endpoint does not take an `id_access_token`
parameter because the homeserver is expected to sign the request to the
identity server instead.

## Request body

- object
  - `address` string, required: The third-party address being removed.
  - `id_server` string: The identity server to unbind from. If not provided, the homeserver MUST use the `id_server` the identifier was added through. If the homeserver does not know the original `id_server`, it MUST return a `id_server_unbind_result` of `no-support`.
  - `medium` 'email' | 'msisdn', required: The medium of the third-party identifier being removed.

## Response `200`

The identity server has disassociated the third-party identifier from the
user.

- object
  - `id_server_unbind_result` 'no-support' | 'success', required: An indicator as to whether or not the identity server was able to unbind the 3PID. `success` indicates that the identity server has unbound the identifier whereas `no-support` indicates that the identity server refuses to support the request or the homeserver was not able to determine an identity server to unbind from.

---

[API](https://skmtc.dev/matrix/apis/matrix-client-server-api.md) - [All operations](https://skmtc.dev/matrix/apis/matrix-client-server-api/llms.txt) - [OpenAPI document](https://skmtc.dev/matrix/apis/matrix-client-server-api/revisions/c7fe4072c681?raw)