POST
/
api
/
loyalty
/
rules
/
{id}
JavaScript
import SnagSolutions from '@snagsolutions/sdk';

const client = new SnagSolutions({
  apiKey: 'My API Key',
});

const rule = await client.loyalty.rules.update('182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e', {
  amount: '10.5',
  endTime: '2024-12-31T23:59:00Z',
  name: 'Daily Rewards Program',
});

console.log(rule.id);
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "Daily Rewards Program",
  "description": "This rule rewards users daily for specific actions.",
  "startTime": "2024-01-01T00:00:00Z",
  "endTime": "2024-12-31T23:59:00Z",
  "effectiveStartTime": "2024-01-01T00:00:00Z",
  "effectiveEndTime": "2024-12-31T23:59:00Z",
  "amount": "<any>",
  "customRewardsCsvUrl": "https://example.com/rewards.csv",
  "customRewardsApiUrl": "https://api.example.com/rewards",
  "subscriptionId": "sub12345",
  "metadata": {
    "isCheckInOnEveryTxn": true,
    "onlyNonListed": true,
    "hasPaidFullRoyalty": false,
    "royaltyAddress": "0x1234567890abcdef1234567890abcdef12345678",
    "royaltyPercentage": 5,
    "hasVerifiedTwitter": true,
    "onlyRewardExistingUser": true,
    "hasNeverSold": false,
    "onlyNative": true,
    "hasFillSource": true,
    "fillSource": "opensea.io",
    "liquidity": {
      "network": "mainnet",
      "protocol": "Uniswap V2",
      "onlyRewardInRangeLiquidity": true,
      "liquidityPerDay": 1000,
      "customFunction": "x = y * 1000",
      "calculationType": "fixed",
      "pools": [
        {
          "id": "0xabcdefabcdefabcdefabcdefabcdefabcdef"
        }
      ]
    },
    "twitterUsername": "@example_user",
    "twitterUserId": "1234567890",
    "twitterHashtag": "#loyalty",
    "enableVerifiedMultiplier": true,
    "verifiedMultiplier": 1.5,
    "isMultiplierApplied": true,
    "onlyKnownUsers": false,
    "firstReferralReward": 10,
    "referrerReward": 50,
    "referrerRewardLoyaltyCurrencyId": "1234567890",
    "secondReferralReward": 5,
    "enableStreaks": true,
    "promoCode": "PROMO123",
    "promoCodeType": "code",
    "promoCodeLength": 10,
    "promoCodeCsvUrl": "https://example.com/promo_codes.csv",
    "enableJoinDiscordServers": true,
    "discordServersToJoin": [
      {
        "id": "123456789012345678",
        "channels": [
          {
            "id": "987654321098765432",
            "text": "Hello",
            "emojis": [
              {
                "id": "1f600"
              }
            ]
          }
        ],
        "roles": [
          {
            "id": "role123"
          }
        ]
      }
    ],
    "streakArray": [
      {
        "streakMilestone": 5,
        "streakAmount": 10
      }
    ],
    "dripQuestsToComplete": [
      {
        "id": "drip123"
      }
    ],
    "collection": [
      {
        "address": "0xabcdefabcdefabcdefabcdefabcdefabcdef",
        "network": "mainnet",
        "multiplier": 2
      }
    ],
    "range": [
      {
        "startRange": 1,
        "endRange": 10,
        "amount": 5,
        "loyaltyBadgeId": "badge123",
        "loyaltyMultiplierAmount": 1.5
      }
    ],
    "customRewardsApiKey": "api-key-1234",
    "link": "https://example.com",
    "socialPlatform": "X(Twitter)",
    "socialPlatformName": "Twitter",
    "socialPlatformLogo": "https://example.com/logo.png",
    "rewardPerImpression": true,
    "minQty": 1,
    "maxQty": 10,
    "snapshotProposals": [
      {
        "id": "proposal123",
        "space": "space123"
      }
    ],
    "cta": {
      "label": "Click Here",
      "href": "https://example.com"
    },
    "hasSaleCurrency": false,
    "isTokenHoldMultiplier": true,
    "saleCurrency": "USD",
    "isRetroactive": true,
    "timeDelayToVerifySeconds": 300,
    "referralRequirements": {
      "points": {
        "amount": 50,
        "loyaltyCurrecyId": "currency123"
      },
      "achievePoints": true,
      "completeProfile": false,
      "connectTwitter": true,
      "connectDiscord": true,
      "connectEmail": true
    },
    "multiplierLoyaltyCurrencyIds": [
      "currency123",
      "currency456"
    ],
    "verifyPlaceHolderText": "Enter your verification code here.",
    "verificationTextMinimumLength": 10,
    "buttonText": "Verify Now",
    "telegramChannelId": "telegram-channel-123",
    "twitterAccountUrl": "https://twitter.com/example_user",
    "twitterPostUrl": "https://twitter.com/example/status/1234567890",
    "checkLike": true,
    "checkRepost": true,
    "checkComment": true,
    "checkText": "loyalty",
    "requirePostLink": true,
    "smartContract": {
      "contractId": "123e4567-e89b-12d3-a456-426614174000",
      "event": "Transfer",
      "type": "event",
      "criteria": "everyEvent",
      "params": [
        {
          "name": "value",
          "condition": ">=",
          "value": "100"
        }
      ],
      "addressMapping": "0x123...789",
      "amountMultiplier": {
        "valueMapping": "amount"
      }
    },
    "walletType": "evm",
    "imageUrl": "https://example.com/image.png",
    "trackAllContracts": true,
    "onlyRewardSingleTokenOwnership": true,
    "skipMultiplier": true,
    "completeProfileConditions": {
      "twitter": true,
      "discord": false
    },
    "steamAppId": "1234567890",
    "trackProgress": true,
    "rewardPerAction": true,
    "rewardByBatch": true,
    "batchSize": 100,
    "youtubeVideoId": "1234567890",
    "youtubeChannelId": "1234567890",
    "isRestrictedToNewUsers": false,
    "rewardBadgePerRange": false,
    "swap": {
      "provider": "any",
      "relayReferrerId": "<string>",
      "tokenMode": "any",
      "swappedToChain": 123,
      "requireCrossChainSwap": true,
      "swappedToTokens": [
        {
          "address": "<string>",
          "chainId": "<string>"
        }
      ],
      "trackTokenAmount": true
    },
    "rewardPerValue": false,
    "conditionDescription": "Complete the specific task on external platform",
    "directRpc": false
  },
  "network": "mainnet",
  "collectionAddress": "0x1234567890abcdef1234567890abcdef12345678",
  "collections": [
    {
      "address": "0xabcdefabcdefabcdefabcdefabcdefabcdef",
      "network": "mainnet",
      "symbol": "COLL"
    }
  ],
  "hideInUi": false,
  "showBeforeStart": false,
  "isRequired": true,
  "oauthCredentialsId": "123e4567-e89b-12d3-a456-426614174000",
  "rewardType": "points",
  "frequency": "daily",
  "interval": "weekly",
  "loyaltyRuleGroupId": "123e4567-e89b-12d3-a456-426614174005",
  "mediaUrl": "https://example.com/media.png",
  "maxAmountPerInterval": 100,
  "maxAmountInterval": "daily",
  "externalIntegrationId": "123e4567-e89b-12d3-a456-426614174005",
  "shopifyStoreUrl": "https://example.com"
}

Authorizations

​
X-API-KEY
string
header
required

Path Parameters

​
id
string<uuid>
required

Body

application/json

Body

​
name
string
required

Name of the loyalty rule

Minimum length: 1
Example:

"Daily Rewards Program"

​
endTime
string<date-time> | null
required

End time for the loyalty rule

Example:

"2024-12-31T23:59:00Z"

​
amount
any
required

Reward amount for the loyalty rule

​
description
string

Optional description of the loyalty rule

Example:

"This rule rewards users daily for specific actions."

​
startTime
string<date-time> | null

Start time for the loyalty rule

Example:

"2024-01-01T00:00:00Z"

​
effectiveStartTime

Effective start time of the rule

Example:

"2024-01-01T00:00:00Z"

​
effectiveEndTime

Effective end time of the rule

Example:

"2024-12-31T23:59:00Z"

​
customRewardsCsvUrl
string<uri> | null

URL for uploading custom rewards via CSV

Example:

"https://example.com/rewards.csv"

​
customRewardsApiUrl
string<uri> | null

API URL for custom rewards integration

Example:

"https://api.example.com/rewards"

​
subscriptionId
string | null

Optional subscription id for the rule

Example:

"sub12345"

​
metadata
object

Additional metadata for the loyalty rule

​
network
enum<string>
default:mainnet

Blockchain network where the rule will apply

Available options:
abstract,
abstractTestnet,
apechain,
arbitrum,
avalanche,
avalancheFuji,
base,
baseSepolia,
berachain,
berachainArtio,
berachainBepolia,
binance,
bscTestnet,
campTestnet,
fantom,
fantomTestnet,
flowMainnet,
mainnet,
nexusTestnet,
optimism,
polygon,
polygon_mumbai,
skaleNebula,
solana,
sophon,
sophonTestnet,
sui,
superseed,
superseedSepolia,
vanar,
xai,
zksync,
coti,
cotiTestnet,
morph,
morphTestnet,
morphHolesky,
ultra,
ultraTestnet,
nitrograph,
sepolia,
optimism_sepolia,
arbitrumSepolia,
goerli,
optimism_goerli,
arbitrumGoerli,
basecamp
Example:

"mainnet"

​
collectionAddress
string

Blockchain address of the associated collection

Example:

"0x1234567890abcdef1234567890abcdef12345678"

​
collections
Collections · object[] | null

List of associated collections

​
hideInUi
boolean
default:false

Whether to hide this rule in the user interface

Example:

false

​
showBeforeStart
boolean
default:false

Whether to show this rule before the start time

Example:

false

​
isRequired
boolean
default:false

Whether this rule is required for participation

Example:

true

​
oauthCredentialsId
string<uuid> | null

ID for associated OAuth credentials

Example:

"123e4567-e89b-12d3-a456-426614174000"

​
rewardType
enum<string>
default:points

Type of reward issued by this rule

Available options:
points,
multiplier,
badge
Example:

"points"

​
frequency
enum<string>

Frequency of the rule execution

Available options:
none,
once,
daily,
weekly,
monthly,
immediately
Example:

"daily"

​
interval
enum<string> | null

Time interval for recurring rule execution

Available options:
daily,
weekly,
monthly,
once,
custom,
every_message
Example:

"weekly"

​
loyaltyRuleGroupId

ID of the rule group section to associate with the rule

Example:

"123e4567-e89b-12d3-a456-426614174005"

​
mediaUrl
string | null

URL of the media to be displayed

Example:

"https://example.com/media.png"

​
maxAmountPerInterval
number | null

The maximum amount of points a user can earn per interval. Available for the smart contract and external rules.

Example:

100

​
maxAmountInterval
enum<string> | null

The interval for the max amount. Available for the smart contract and external rules.

Available options:
daily,
weekly,
monthly,
lifetime
Example:

"daily"

​
externalIntegrationId
string<uuid> | null

ID of the external integration

Example:

"123e4567-e89b-12d3-a456-426614174005"

​
shopifyStoreUrl
string | null

URL of the Shopify store

Example:

"https://example.com"

Response

200

​
id
string<uuid>
required
​
name
string
required

Name of the loyalty rule

Minimum length: 1
Example:

"Daily Rewards Program"

​
endTime
string<date-time> | null
required

End time for the loyalty rule

Example:

"2024-12-31T23:59:00Z"

​
amount
any
required

Reward amount for the loyalty rule

​
description
string

Optional description of the loyalty rule

Example:

"This rule rewards users daily for specific actions."

​
startTime
string<date-time> | null

Start time for the loyalty rule

Example:

"2024-01-01T00:00:00Z"

​
effectiveStartTime

Effective start time of the rule

Example:

"2024-01-01T00:00:00Z"

​
effectiveEndTime

Effective end time of the rule

Example:

"2024-12-31T23:59:00Z"

​
customRewardsCsvUrl
string<uri> | null

URL for uploading custom rewards via CSV

Example:

"https://example.com/rewards.csv"

​
customRewardsApiUrl
string<uri> | null

API URL for custom rewards integration

Example:

"https://api.example.com/rewards"

​
subscriptionId
string | null

Optional subscription id for the rule

Example:

"sub12345"

​
metadata
object

Additional metadata for the loyalty rule

​
network
enum<string>
default:mainnet

Blockchain network where the rule will apply

Available options:
abstract,
abstractTestnet,
apechain,
arbitrum,
avalanche,
avalancheFuji,
base,
baseSepolia,
berachain,
berachainArtio,
berachainBepolia,
binance,
bscTestnet,
campTestnet,
fantom,
fantomTestnet,
flowMainnet,
mainnet,
nexusTestnet,
optimism,
polygon,
polygon_mumbai,
skaleNebula,
solana,
sophon,
sophonTestnet,
sui,
superseed,
superseedSepolia,
vanar,
xai,
zksync,
coti,
cotiTestnet,
morph,
morphTestnet,
morphHolesky,
ultra,
ultraTestnet,
nitrograph,
sepolia,
optimism_sepolia,
arbitrumSepolia,
goerli,
optimism_goerli,
arbitrumGoerli,
basecamp
Example:

"mainnet"

​
collectionAddress
string

Blockchain address of the associated collection

Example:

"0x1234567890abcdef1234567890abcdef12345678"

​
collections
Collections · object[] | null

List of associated collections

​
hideInUi
boolean
default:false

Whether to hide this rule in the user interface

Example:

false

​
showBeforeStart
boolean
default:false

Whether to show this rule before the start time

Example:

false

​
isRequired
boolean
default:false

Whether this rule is required for participation

Example:

true

​
oauthCredentialsId
string<uuid> | null

ID for associated OAuth credentials

Example:

"123e4567-e89b-12d3-a456-426614174000"

​
rewardType
enum<string>
default:points

Type of reward issued by this rule

Available options:
points,
multiplier,
badge
Example:

"points"

​
frequency
enum<string>

Frequency of the rule execution

Available options:
none,
once,
daily,
weekly,
monthly,
immediately
Example:

"daily"

​
interval
enum<string> | null

Time interval for recurring rule execution

Available options:
daily,
weekly,
monthly,
once,
custom,
every_message
Example:

"weekly"

​
loyaltyRuleGroupId

ID of the rule group section to associate with the rule

Example:

"123e4567-e89b-12d3-a456-426614174005"

​
mediaUrl
string | null

URL of the media to be displayed

Example:

"https://example.com/media.png"

​
maxAmountPerInterval
number | null

The maximum amount of points a user can earn per interval. Available for the smart contract and external rules.

Example:

100

​
maxAmountInterval
enum<string> | null

The interval for the max amount. Available for the smart contract and external rules.

Available options:
daily,
weekly,
monthly,
lifetime
Example:

"daily"

​
externalIntegrationId
string<uuid> | null

ID of the external integration

Example:

"123e4567-e89b-12d3-a456-426614174005"

​
shopifyStoreUrl
string | null

URL of the Shopify store

Example:

"https://example.com"