### Public Beta Feature

This documentation covers a feature currently in Public Beta. Access is available to anyone interested in building personalized experiences for their end-users.

This feature is subject to the [Personalization API (Self-Service) Public Beta End user License Agreement](https://location.foursquare.com/legal/terms/personalization-apis-self-service-eula/).

### Foursquare Service Account Required

These endpoints require the use of a [Foursquare Service Account](https://location.foursquare.com/developer/docs/manage-your-service-account) that acts on behalf of your application. Please make sure you've created a Service Account and use the associated API Key when making calls to the following endpoints.

For more information, please read [Service Account Authentication](https://location.foursquare.com/developer/v0.3/reference/user-management-api).

### IMPORTANT

Please make sure to store the resulting `oauth_token/user_id` pairings for each user in your own internal database.

There is no method to fetch this pairing once returned during user creation. If you need to generate a new oauth_token for your user, you can do so via the [refresh user token](https://location.foursquare.com/developer/v0.3/reference/refresh-managed-user-token) endpoint.

### API Version

string

required

The API version date as documented [here](https://docs.foursquare.com/developer/reference/versioning); e.g. 20231010

### Success Response

```json
{
  "meta": {
    "code": 200,
    "requestId": "1234567890"
  },
  "notifications": [
    {
      "type": "notificationTray",
      "item": {
        "unreadCount": 0
      }
    }
  ],
  "response": {
    "userId": "123456",
    "access_token": "987654"
  }
}
```

### Error Response

```
  400
```

### Example cURL Command

```bash
curl --request POST \
     --url https://api.foursquare.com/v2/usermanagement/createuser \
     --header 'accept: application/json'
```