---
title: "POST /v2/identities/remotes"
method: POST
path: "/v2/identities/remotes"
tags: ["identities"]
---

# POST /v2/identities/remotes

`POST /v2/identities/remotes`

create a new remote identity for user

## Request body

- object
  - `credentials` object
  - `display_name` string
  - `identifier` string, required
  - `infos` object
  - `protocol` 'email' | 'twitter', required
  - `status` 'active' | 'inactive' | 'deleted'
  - `type` 'local' | 'remote'
  - `user_id` string

## Response `200`

Remote identity created

- object
  - `location` string — url to retrieve new remote identity's at identities/remotes/{identifier}
  - `identifier` string

---

[API](https://skmtc.dev/caliopen/apis/caliopen-http-rest-api.md) · [All operations](https://skmtc.dev/caliopen/apis/caliopen-http-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/caliopen/apis/caliopen-http-rest-api/revisions/db8743fd356d?raw)