---
title: "User copy"
url: "https://help.internetx.com/en/api/core-user-copy/"
lang: "en"
section: "API reference — API reference (XML/JSON)"
breadcrumb: "API documentation (JSON/XML) > Tasks > User tasks"
updated: "2023-09-19"
---

# User copy

## Function

The _UserCopy_ task creates a new user by copying an existing user.

## Description

Route: POST ​/user​/{name}​/{context}​/copy  

```
{
  "user": "newuser",
  "password": "newpassword",
  "defaultEmail": "new@email.com"
 }
```

```
{
    "stid": "20210303-STID",
    "status": {
        "code": "S1301016",
        "text": "The user was copied successfully.",
        "type": "SUCCESS"
    },
    "object": {
        "type": "User",
        "value": "newuser, 4",
        "data": {
            "context": 4,
            "user": "newuser"
        }
    }
}
```

Task code: 1301016  
Uses [User](/en/api/core-user-object/) object

```
<request>
	<auth>
		<user>customer</user>
		<password>password</password>
		<context>4</context>
	</auth>
	<task>
		<code>1301016</code>
		<user_clone>
			<source>
				<user>customer</user>
				<context>4</context>
			</source>
			<target>
				<user>targetuser1</user>
				<default_mail>customer@example.com</default_mail>
			</target>
		</user_clone>
	</task>
</request>
```

```
<response>
	<result>
		<data/>
		<msg>
			<text>The password was automatically generated by the system.</text>
			<code>MSG13004</code>
			<type>notice</type>
			<object>
				<type>password</type>
				<value>}U6>ZSR*|e5mnf!</value>
			</object>
		</msg>
	</data>
	<status>
		<code>S1301016</code>
		<text>The user was copied successfully.</text>
		<type>success</type>
		<object>
			<type>user</type>
			<value>targetuser1</value>
		</object>
	</status>
</result>
<stid>20150723-app1-qm-487</stid>
</response>
```