X User External Integration

🧾 User Mission Claim

This API is used to allocate points to a user upon successful completion of a social mission (e.g., Twitter Like, Retweet, Follow, etc.). https://loyaltydocs.getmojito.com/reference/social-profile-claim#/ for reference

API Endpoint

POST https://loyalty-api-sandbox.mojito.xyz/{tenant}/user/mission-claim

Path Params:

tenant (string, required): Tenant slug fetched from the dashboard (e.g., sample-loyalty)

Request Body

{
  "mission_id": "<MISSION_ID>",
  "user_reference": "user_<user-reference>"
}

Field	Type	Required	Description
mission_id	uuid	yes	Unique ID of the mission to be claimed
user_reference	string	no	Unique user reference (e.g., user_<user-reference> or wallet address)

Headers

Header Name	Type	Description
x-twitter-auth	string	Base64-encoded JSON containing Twitter credentials for off-platform authorisation

Base64-encoded payload

{
  "access_token": "xxxxtwitteraccesstokenxxxx",
  "external_id": "1889988141244698624",
  "user_name": "mohan990te9759"
}

⚠️Note:

x-twitter-auth can be used when the user is authenticated with Twitter outside of Mojito’s standard Twitter connection flow. This is useful for platforms with their own OAuth flow or Twitter app environment. You can pass the access token directly without requiring the user to connect their account via Mojito’s /social/twitter/auth and /user/connect APIs.