> For the complete documentation index, see [llms.txt](https://scorpioplay.gitbook.io/scorpio-play-casino-api-doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://scorpioplay.gitbook.io/scorpio-play-casino-api-doc/api-reference/openapi/v1-player-create.md).

# /v1/player/create

## Create a player to out API system

<mark style="color:$success;">`POST`</mark>`/v1/player/create`

Links an external player (identified by a unique ID such as `id` or `playername` on operator side) to our API system. If the player does not exist in our system, a new profile will be created. This is required before the player launches games. `playerCode` which is a unique number issued in our API system will be assigned to the player and returned in the response.

**Headers**

| Name          | Value                |
| ------------- | -------------------- |
| Authorization | `Bearer <API_TOKEN>` |
| Content-Type  | `application/json`   |
| Accept        | `application/json`   |

**Body**

```json
{
  "playerExternalId": "playerId_onOperatorSide"
}
```

<table><thead><tr><th>Key</th><th>Data Type</th><th width="366">Description</th><th>Mandatory</th></tr></thead><tbody><tr><td>playerExternalId</td><td>string</td><td>Unique player identifier from the operator’s system, used to link and identify the player in our platform</td><td>Required</td></tr></tbody></table>

**Response**

```json
{
  "success": true,
  "message": "OK",
  "data": {
    "playerCode": 100000121
  }
}
```

<table><thead><tr><th width="164">Key</th><th width="118">Data Type</th><th>Description</th></tr></thead><tbody><tr><td>success</td><td>boolean</td><td>Indicates whether the request was successfully processed</td></tr><tr><td>message</td><td>string</td><td>Response message describing the result</td></tr><tr><td>data.playerCode</td><td>number</td><td>Unique integer identifier assigned to the player within our system</td></tr></tbody></table>