---
title: "Binds a 3PID to the user's account through an Identity Service."
method: POST
path: "/_matrix/client/v3/account/3pid/bind"
tags: ["Account management"]
---

# Binds a 3PID to the user's account through an Identity Service.

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

## Request

- Base URL: `https://matrix.org`
- URL: `https://matrix.org/_matrix/client/v3/account/3pid/bind`
- 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/bind/post.ts> (a function with typed inputs; its response is checked against the schema)

Binds a 3PID to the user's account through the specified identity server.

Homeservers should not prevent this request from succeeding if another user
has bound the 3PID. Homeservers should simply proxy any errors received by
the identity server to the caller.

Homeservers should track successful binds so they can be unbound later.

## Request body

- object
  - `client_secret` string, required: The client secret used in the session with the identity server.
  - `id_access_token` string, required: An access token previously registered with the identity server.
  - `id_server` string, required: The identity server to use.
  - `sid` string, required: The session identifier given by the identity server.

## Response `200`

The addition was successful.

- object

## Other responses

- `429`: This request was rate-limited.

---

[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)