Skip to main content

Set mail notifications

POST /user/setMailNotification
Permission: Connected + API Configures which email notifications the user wants to receive.

Body Parameters

notifications
object
required
Object containing notification preferences

Request Example

{
  "notifications": {
    "tradeCom pleted": true,
    "offerReceived": true,
    "buyOrderFilled": true,
    "itemSold": true,
    "depositCompleted": false,
    "marketing": false
  }
}

Response

Success
{
  "status": "success",
  "data": {
    "message": "Notification preferences updated",
    "notifications": {
      "tradeCompleted": true,
      "offerReceived": true,
      "buyOrderFilled": true,
      "itemSold": true,
      "depositCompleted": false,
      "marketing": false
    }
  }
}

Set mail notification status

POST /user/setMailNotificationStatus
Permission: Connected + API Enables or disables all email notifications at once.

Body Parameters

enabled
boolean
required
Enable or disable all email notifications

Request Example

{
  "enabled": false
}

Response

Success
{
  "status": "success",
  "data": {
    "emailNotifications": false,
    "message": "Email notifications disabled"
  }
}

Set privacy setting

POST /user/setPrivacySetting
Permission: Connected + API Updates user privacy settings such as profile visibility, trade history visibility, and inventory privacy.

Body Parameters

settings
object
required
Object containing privacy settings

Request Example

{
  "settings": {
    "profilePublic": true,
    "inventoryPublic": false,
    "tradeHistoryPublic": false,
    "showOnLeaderboard": true
  }
}

Response

Success
{
  "status": "success",
  "data": {
    "message": "Privacy settings updated",
    "settings": {
      "profilePublic": true,
      "inventoryPublic": false,
      "tradeHistoryPublic": false,
      "showOnLeaderboard": true
    }
  }
}

Set trade URL

POST /user/setTradeUrl
Permission: Connected + API Sets or updates the user’s Steam trade offer URL. Required for withdrawals and trades.

Body Parameters

tradeUrl
string
required
Steam trade offer URL (must start with https://steamcommunity.com/tradeoffer/new/?partner=)

Request Example

{
  "tradeUrl": "https://steamcommunity.com/tradeoffer/new/?partner=123456789&token=AbCdEfGh"
}

Response

Success
{
  "status": "success",
  "data": {
    "tradeUrl": "https://steamcommunity.com/tradeoffer/new/?partner=123456789&token=AbCdEfGh",
    "validated": true,
    "message": "Trade URL updated successfully"
  }
}

Error Responses

StatusMessageDescription
errorInvalid trade URL formatThe provided URL is not a valid Steam trade offer URL
errorTrade URL validation failedUnable to validate the trade URL with Steam
errorTrade URL belongs to different accountThe trade URL doesn’t match your Steam ID
Make sure your trade URL is valid and matches your Steam account. Invalid URLs will prevent you from withdrawing items.

Update short URL

POST /user/updateShortUrl
Permission: Connected + API Creates or updates a custom short URL for the user’s profile (e.g., mannco.store/u/customname).

Body Parameters

shortUrl
string
required
Desired short URL slug (3-20 characters, alphanumeric and hyphens only)

Request Example

{
  "shortUrl": "my-custom-name"
}

Response

Success
{
  "status": "success",
  "data": {
    "shortUrl": "my-custom-name",
    "fullUrl": "https://mannco.store/u/my-custom-name",
    "message": "Short URL updated successfully"
  }
}

Error Responses

StatusMessageDescription
errorShort URL already takenAnother user is already using this short URL
errorInvalid charactersShort URL contains invalid characters
errorShort URL too short/longMust be between 3-20 characters
errorShort URL is reservedThis short URL is reserved for system use
Short URLs are unique across all users. Choose wisely as you can only change it once per month.