# Player

Operations related to the Players in your community (or Club)

**Security:**
You only have access to players that are in your community(s).

**Player Updates:**
Once a player completes their profile on UnknownGolf.com, there are personal attributes that you cannot update, only the player themselves can make the updates on UnknownGolf.com

**Duplicate Profiles & Merging Accounts:**
A unique profile is determined by a Unique Email Address or Unique World Handicap Id, if you receive an error message when adding (or updating) a player you will need to reach out to Support@UnknownGolf.com to have the profiles merged.


## Add player to community

 - [POST /v1/players/{playerId}/communities/{communityId}](https://api-docs.unknowngolf.com/ug-api/player/addtocommunity.md): Add the player to the community with the membership status

## Remove player from community

 - [DELETE /v1/players/{playerId}/communities/{communityId}](https://api-docs.unknowngolf.com/ug-api/player/deletefromcommunity.md): Remove the player from the community, if the player has participated in an event or registered for an upcoming event they cannot be removed from the community

## Search players

 - [GET /v1/players](https://api-docs.unknowngolf.com/ug-api/player/search_7.md): Search the players in a community

## Create player

 - [POST /v1/players](https://api-docs.unknowngolf.com/ug-api/player/create_1.md): 			Create a player and add them to a community, if the player already exists in Unknown Golf then they will just be added to the community

			
			Players must be added to a community, you cannot create a player without adding them to at least one of your communities.

			After the player is created, if you need to add them to additional communities you can via the "Player add to community" operation.


## list player communities

 - [GET /v1/players/{playerId}/communities](https://api-docs.unknowngolf.com/ug-api/player/listcommunities.md): Get the list of communities for a player. The player can be a member or non-member in that community

## Update email

 - [PATCH /v1/players/{playerId}/email](https://api-docs.unknowngolf.com/ug-api/player/udpateemail.md): Update the Player's email address, if the player has already completed their profile on Unknown Golf update the player's email can only be performed by the player on Unknown Golf.

## Update member status

 - [PATCH /v1/players/{playerId}/communities/{communityId}/member](https://api-docs.unknowngolf.com/ug-api/player/udpatememberstatus.md): Update the Player's member status for the community

## Update date of birth

 - [PATCH /v1/players/{playerId}/dob](https://api-docs.unknowngolf.com/ug-api/player/updatedateofbirth.md): Update the Player's date of birth in the format YYYY-MM-dd, if the player has already completed their profile on Unknown Golf update the player's Date of Birth can only be performed by the player on Unknown Golf.

## Update handicap id

 - [PATCH /v1/players/{playerId}/handicap](https://api-docs.unknowngolf.com/ug-api/player/updatehandicapid.md): Update the Player's world handicap, if the player has already completed their profile on Unknown Golf update the player's world handicap can only be performed by the player on Unknown Golf.

## Update handle

 - [PATCH /v1/players/{playerId}/communities/{communityId}/handle](https://api-docs.unknowngolf.com/ug-api/player/updatehandle.md): Update the Player's handle (nickname) for a community

## Update name

 - [PATCH /v1/players/{playerId}/name](https://api-docs.unknowngolf.com/ug-api/player/updatename_1.md): Update the Player's name, if the player has already completed their profile on Unknown Golf update the player's name can only be performed by the player on Unknown Golf.

## Update phone number

 - [PATCH /v1/players/{playerId}/phone](https://api-docs.unknowngolf.com/ug-api/player/updatephonenumber.md): Update the Player's mobile phone, if the player has already completed their profile on Unknown Golf update the player's phone can only be performed by the player on Unknown Golf.