# Map Players to CAD Users

Your integration must be able to tell Sonoran CAD which account an in-game player belongs to. There are three main ways to do that.

## Option 1: `communityUserId`

Use `communityUserId` when your game server controls its own player identifier, such as FiveM.

This is the default approach used by our [FiveM integration resource](/cad/integration-plugins/in-game-integration/fivem-installation.md). Players link their CAD account in-game with [`/link`](/cad/integration-plugins/in-game-integration/link-user-in-game.md), and Sonoran CAD stores the player's game identifier in the account's `communityUserId` field.

If you need to go from a CAD push event or API response back to an in-game FiveM player, use that same `communityUserId` as your join key. Our FiveM resource documents this flow in [LINKING\_V2.md](https://github.com/Sonoran-Software/SonoranCADFiveM/blob/master/sonorancad/LINKING_V2.md) and exposes `exports.sonorancad:getPlayerCommunityUserId(source)` for third-party resources.

For example, a push event may include `communityUserId = "license:abc123"`. Your server can compare that to the value returned by `getPlayerCommunityUserId(source)` for connected players, or use it alongside the cached unit payload described in [GetUnitCache](/cad/integration-plugins/in-game-integration/framework-development-documentation/server-functions.md#getunitcache).

By default, the FiveM resource uses the `primaryIdentifier` config value, which is set to `license` unless you change it.

#### Create Community Link

Use the following endpoint to create a 4-digit link code and associate it with your game's unique player identifier

* [Create Community Link](/cad/api-integration/api-endpoints-v2/general/accounts/create-community-link.md)

#### Complete User Link

Users can complete the link verification by logging in and visiting `sonorancad.com/id?code=1234`. This completes the link and automatically joins the user to the community (if not already).

#### Check User Link

Use the following API endpoint and push event to programmatically confirm that a user has completed the link.

* [Check Community Link](/cad/api-integration/api-endpoints-v2/general/accounts/check-community-link.md)
* [Community Link Verified](/cad/api-integration/push-events/community-link-verified.md)

Once linked, pass `communityUserId` to supported v2 endpoints to target that player's Sonoran CAD account.

## Option 2: Roblox account linking

Use Roblox account linking when the player's Roblox identity is already the source of truth for your integration.

Players can link their Roblox account directly to their Sonoran account. Our [ER:LC getting started guide](/cad/integration-plugins/erlc/getting-started.md#linking-your-roblox-account) walks through that flow.

After the account is linked, use the `roblox` parameter on supported v2 endpoints instead of `communityUserId`.

This is the preferred approach for Roblox-based integrations because it targets the linked Roblox account directly.

## Option 3: account secret key to `accountUuid`

Use an account secret key when you already have a trusted Sonoran account secret and need to resolve it to the user's Sonoran account UUID.

#### User Secret ID

User's can copy their account's secret ID from the settings panel.

<figure><img src="/files/WaZ7aHwjRWaK3lns8lSQ" alt=""><figcaption></figcaption></figure>

#### Verify the Secret

Use the following endpoint to verify the secret ID and get the user's Sonoran account UUID

* [Verify Secret](/cad/api-integration/api-endpoints-v2/general/accounts/verify-secret.md)

You can then use `accountUuid` on supported v2 endpoints.

Support for `accountUuid` is more limited than `communityUserId` or `roblox`, so this should usually be treated as a fallback rather than your primary mapping strategy. Reach out to our development team if more expansion is required for your application.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sonoransoftware.com/cad/api-integration/getting-started/setting-your-api-id.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.