# User Activation

<figure><img src="https://627965603-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FImVr2HJay0snj5ukhBJK%2Fuploads%2Fj1FJ5KGGv7z3hirczWKy%2Funknown.png?alt=media&#x26;token=7e9afea2-0807-48b6-b1c5-b847298636ae" alt=""><figcaption></figcaption></figure>

#### Create User Activation Link

`POST` \[BASE\_URL]/open-api/v1/whitelabel/user/activation

Purpose: Create and bind account.<br>

Authorization:

* B2B Token&#x20;

**Request**

Request Body

```json
{
 "phoneNumber": "6281234567890",
 "referenceId": "CUSTOMER_REF_001",
 "redirectUrl": "https://merchant.com/success",
 "name": "John Doe"
}
```

Request Parameter Detail&#x20;

| Parameter   | Data Type    | Character Limit | Requirement | Description                                                 |
| ----------- | ------------ | --------------- | ----------- | ----------------------------------------------------------- |
| phoneNumber | String       | 15              | Mandatory   | User’s phone number in MSISDN format (e.g., 6281234567890). |
| referenceId | String       | 64              | Mandatory   | Merchant’s unique user ID or reference number.              |
| name        | String       | 50              | Optional    | User name                                                   |
| redirectUrl | String (URL) | 255             | Optional    | URL to redirect the user after activation is completed.     |

\ <br>

**Response**<br>

Response Body

```json
{
    "code": "00",
    "data": {
        "activationLink": "https://webview.harsya.com/whitelabel/user/activation?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJ3YWxsZXQtYmFja2VuZCIsInN1YiI6IjA4OTYzMTIzODkyMCIsImV4cCI6MTczNzM5Mjk5MSwiaWRlbmZpZXJWYWx1ZSI6IjA4OTYzMTIzODkyMCIsIm1lcmNoYW50SWQiOiI5MjJlMzlhYi03NTY1LTQ5ZjYtYjg0Zi1mYjU2MTIyODIxYWUifQ.LrDTuU40-G7z2VK8SdehI--iSLn7IMo5OSzBSzTTOGY",
        "expiredAt": "2025-01-21T00:09:51+07:00"
    },
    "message": "OK"
}
```

Response Parameter Detail

| Parameter           | Data Type         | Character Limit | Requirement | Description                                                                         |
| ------------------- | ----------------- | --------------- | ----------- | ----------------------------------------------------------------------------------- |
| code                | String            | 5               | Mandatory   | Response status code. "00" indicates success, other codes indicate errors.          |
| data                | Object            | -               | Mandatory   | Contains the activation link and expiration details.                                |
| data.activationLink | String (URL)      | 255             | Mandatory   | Activation URL that redirects the user to complete their onboarding or KYC process. |
| data.expiredAt      | String (ISO 8601) | 25              | Mandatory   | Expiration date and time of the activation link.                                    |
| message             | String            | 100             | Mandatory   | Description of the API result (e.g., "OK" or error message).                        |

\ <br>
