> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rc.cleverhub.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Activate User's Cashback Account

> Activates a user to be eligible for receiving and withdrawing cashback through cashback campaigns. This endpoint validates the existence of the user and registers them for cashback activities. Required fields include `user_id`, `first_name`, and `last_name`. Optional fields like `email` and `phone` help in user identification and communication.




## OpenAPI

````yaml /api/openapi/cashback-reference.yaml post /v2/cashbacks/activate
openapi: 3.0.3
info:
  title: Cashback APIs
  description: >-
    ## Introduction

    The Cashback API Solution offers a streamlined way for developers to manage
    cashback campaigns, account activations, and withdrawals, providing a
    seamless user experience.

    ### Key Features

    - **Campaign Management**:
      - **Get Cashback Campaign List**: Retrieve a list of all available cashback campaigns.
      - **Get Campaign Configurations**: Retrieve detailed configurations for specific cashback campaigns.

    - **User Cashback Management**:
      - **Activate User's Cashback Account**: Activate a cashback account for a user.
      - **Initiate Cashback Delivery**: Initiate the delivery of cashback to a user.
      - **Initiate Cashback Withdrawal**: Begin the process of withdrawing cashback to a user's account.

    - **User Information**:
      - **Get User List**: Retrieve a list of users with cashback accounts.

    This documentation provides detailed guidance for integrating these
    capabilities into your application.
  version: 2.0.0
  termsOfService: https://helloclever.co/terms
  contact:
    email: support@helloclever.co
servers:
  - url: https://api.cleverhub.co/api
    description: Sandbox Environment
  - url: https://api-merchant.helloclever.co/api
    description: Production Environment
security: []
paths:
  /v2/cashbacks/activate:
    post:
      tags:
        - Cashback
      summary: Activate User's Cashback Account
      description: >
        Activates a user to be eligible for receiving and withdrawing cashback
        through cashback campaigns. This endpoint validates the existence of the
        user and registers them for cashback activities. Required fields include
        `user_id`, `first_name`, and `last_name`. Optional fields like `email`
        and `phone` help in user identification and communication.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - user_id
                - first_name
                - last_name
              properties:
                user_id:
                  type: string
                  description: >-
                    The unique user ID provided by the merchant. This ID is used
                    to identify the user in all cashback transactions.
                  example: user_123
                phone:
                  type: string
                  description: >-
                    The user's phone number in international format (e.g.,
                    "+61412345678").
                  example: '+61412345678'
                email:
                  type: string
                  description: >-
                    The user's email address, used for notifications and
                    identification.
                  example: user@example.com
                first_name:
                  type: string
                  description: The user's first name.
                  example: John
                last_name:
                  type: string
                  description: The user's last name.
                  example: Doe
      responses:
        '200':
          description: User activated successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  user_id:
                    type: string
                    description: The unique user ID assigned by the merchant.
                    example: 8GAVZZKTI3
                  site_id:
                    type: string
                    description: >-
                      The unique identifier of the site associated with the
                      user.
                    example: 3BAVFJ6H
                  first_name:
                    type: string
                    description: The user's first name.
                    example: John
                  last_name:
                    type: string
                    description: The user's last name.
                    example: Doe
                  email:
                    type: string
                    nullable: true
                    description: The user's email address.
                    example: example@gmail.com
                  phone:
                    type: string
                    nullable: true
                    description: The user's phone number.
                    example: '+61412345678'
                  created_at:
                    type: string
                    format: date-time
                    description: >-
                      The timestamp when the user was created in the cashback
                      system.
                    example: '2024-11-06T16:39:48.264Z'
                  updated_at:
                    type: string
                    format: date-time
                    description: >-
                      The timestamp when the user's information was last
                      updated.
                    example: '2024-11-06T16:39:48.264Z'
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
      security:
        - app-id: []
          secret-key: []
components:
  securitySchemes:
    app-id:
      type: apiKey
      in: header
      name: app-id
      description: |
        A unique identifier assigned to each application.
    secret-key:
      type: apiKey
      in: header
      name: secret-key
      description: |
        A secure token associated with the `app-id`.

````

## Related topics

- [Drive Loyalty with Cashback Campaigns](/developer-reference/api-use-cases/drive-loyalty-with-cashback-campaigns.md)
- [Payment APIs for AUD (v1)](/api/v1/introduction.md)
- [Cashback API Overview](/api/cashback/overview.md)