POST
/
users
Create or Update User
curl --request POST \
  --url https://api.winwinkit.com/users \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '{
  "app_user_id": "821fae4b5-1a2d-4c1e-9152-5297086a161c",
  "is_premium": false,
  "first_seen_at": "2024-11-10T10:28:18.104Z",
  "last_seen_at": null,
  "metadata": {}
}'
{
  "data": {
    "user": {
      "app_user_id": "821fae4b5-1a2d-4c1e-9152-5297086a161c",
      "referral_code": "XYZ123",
      "referral_code_link": "https://appname.wwk.link/XYZ123",
      "is_premium": false,
      "first_seen_at": "2024-11-10T10:28:18.104Z",
      "last_seen_at": null,
      "metadata": {},
      "claim_code_eligibility": {
        "eligible": true,
        "eligible_until": "2024-11-10T10:28:18.104Z"
      },
      "stats": {
        "claims": 0,
        "conversions": 0,
        "churns": 0
      },
      "rewards": {
        "active": {
          "basic": [
            {
              "reward": {},
              "expires_at": "2021-01-01T00:00:00.000Z",
              "created_at": "2021-01-01T00:00:00.000Z",
              "updated_at": "2021-01-01T00:00:00.000Z"
            }
          ],
          "credit": [
            {
              "reward": {},
              "credits": 100,
              "expires_at": "2021-01-01T00:00:00.000Z",
              "created_at": "2021-01-01T00:00:00.000Z",
              "updated_at": "2021-01-01T00:00:00.000Z"
            }
          ],
          "offer_code": [
            {
              "reward": {},
              "value": {},
              "expires_at": "2021-01-01T00:00:00.000Z",
              "created_at": "2021-01-01T00:00:00.000Z",
              "updated_at": "2021-01-01T00:00:00.000Z"
            }
          ],
          "revenuecat_entitlement": [
            {
              "reward": {},
              "expires_at": "2021-01-01T00:00:00.000Z",
              "created_at": "2021-01-01T00:00:00.000Z",
              "updated_at": "2021-01-01T00:00:00.000Z"
            }
          ],
          "revenuecat_offering": [
            {
              "reward": {},
              "expires_at": "2021-01-01T00:00:00.000Z",
              "created_at": "2021-01-01T00:00:00.000Z",
              "updated_at": "2021-01-01T00:00:00.000Z"
            }
          ]
        },
        "expired": {
          "basic": [
            {
              "reward": {},
              "expired_at": "2021-01-01T00:00:00.000Z",
              "created_at": "2021-01-01T00:00:00.000Z",
              "updated_at": "2021-01-01T00:00:00.000Z"
            }
          ],
          "credit": [
            {
              "reward": {},
              "expired_at": "2021-01-01T00:00:00.000Z",
              "created_at": "2021-01-01T00:00:00.000Z",
              "updated_at": "2021-01-01T00:00:00.000Z"
            }
          ],
          "offer_code": [
            {
              "reward": {},
              "expired_at": "2021-01-01T00:00:00.000Z",
              "created_at": "2021-01-01T00:00:00.000Z",
              "updated_at": "2021-01-01T00:00:00.000Z"
            }
          ],
          "revenuecat_entitlement": [
            {
              "reward": {},
              "expired_at": "2021-01-01T00:00:00.000Z",
              "created_at": "2021-01-01T00:00:00.000Z",
              "updated_at": "2021-01-01T00:00:00.000Z"
            }
          ],
          "revenuecat_offering": [
            {
              "reward": {},
              "expired_at": "2021-01-01T00:00:00.000Z",
              "created_at": "2021-01-01T00:00:00.000Z",
              "updated_at": "2021-01-01T00:00:00.000Z"
            }
          ]
        }
      },
      "referral_program": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "Referral Program #1",
        "description": "This is a referral program",
        "metadata": {},
        "distribution_percentage": 100,
        "limit": 0,
        "rewards": {
          "sender": {
            "basic": [
              {}
            ],
            "credit": [
              {}
            ],
            "offer_code": [
              {}
            ],
            "revenuecat_entitlement": [
              {}
            ],
            "revenuecat_offering": [
              {}
            ]
          },
          "receiver": {
            "basic": [
              {}
            ],
            "credit": [
              {}
            ],
            "offer_code": [
              {}
            ],
            "revenuecat_entitlement": [
              {}
            ],
            "revenuecat_offering": [
              {}
            ]
          }
        },
        "created_at": "2021-01-01T00:00:00.000Z",
        "updated_at": "2021-01-01T00:00:00.000Z"
      }
    }
  }
}

Headers

​
x-api-key
string
required

The API key to authenticate with.

Body

application/json
​
app_user_id
string
required

The unique identifier of the referral user in your app.

Example:

"821fae4b5-1a2d-4c1e-9152-5297086a161c"

​
is_premium
boolean | null

Whether the user is a premium user.

Example:

false

​
first_seen_at
string<date-time> | null

The date when the user was first seen at.

Example:

"2024-11-10T10:28:18.104Z"

​
last_seen_at
string<date-time> | null
deprecated

The date when the user was last seen at. Deprecated and will be removed in the future.

Example:

null

​
metadata
object | null

The metadata of the user.

Example:
{}

Response

The user has been successfully updated.

​
data
object
required