Create WPPR Profile
A short guide on what to expect when using the POST /api/v1/players/profile endpoint.
Ratings and scaling
If you've shared your rating scale with us during onboarding, the endpoint automatically converts your ratings to the WPPR scale. Just pass your rating as-is — no math on your side.
If we don't have your scale on file, the endpoint expects a rating already in WPPR format. See WPPR Rating Levels for more details on the scale and categories.
Example: how different scales map to WPPR
Each integrator's scale is configured during onboarding.
Phone number matching
When you submit a profile, we check whether the phone number already exists in our database:
201 Created— a new profile was created.200 OK— the phone number was already on file; the response contains the existing player's ID.
That said, don't use this endpoint as a phone-number lookup. If you need to check whether a number is already registered, use GET /api/v1/players/search/by-phone/{phonenumber} instead.
Phone number verification
WPPR validates that the phone number format is valid, but ownership verification is your responsibility. We trust that you only submit numbers the player has confirmed they own. There is no server-side ownership check on our end — make sure your app verifies the number before calling this endpoint.
We take phone verification responsibility very seriously in order to keep providing everyone with reliable API integration.