Create Managed User

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.

Foursquare Service Account Required

These endpoints require the use of a Foursquare 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.

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 endpoint.

API Version

string

required

The API version date as documented here; e.g. 20231010

Success Response

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

Error Response

  400

Example cURL Command

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