Skip to main content
POST
/
set-event-details
Set Event Details
curl --request POST \
  --url https://tokens.shakesco.com/set-event-details \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "event_name": "<string>",
  "allocation": 123,
  "should_not_claim_twice": true
}
'
{ "tx_hash": "0xabc123..." }

Documentation Index

Fetch the complete documentation index at: https://docs.shakesco.com/llms.txt

Use this file to discover all available pages before exploring further.

For the complete documentation index, see llms.txt. Defines (or updates) an event that customers can claim tokens for. Events are the unit your backend hooks into: when something happens in your app (signup, birthday, purchase), you call /claim-tokens referencing the event’s name. You can also manage events from the Customer Rewards dashboard.

Request Body

event_name
string
required
Lowercase event identifier (e.g. "signup", "birthday", "buy-ticket")
allocation
number
required
Tokens awarded per claim. Decimals allowed.
should_not_claim_twice
boolean
required
true for one-time events (signup, birthday). false for repeatable events (purchase, daily check-in).

Response

tx_hash
string
Reference identifier for the configuration
await fetch("https://tokens.shakesco.com/set-event-details", {
  method: "POST",
  headers: { Authorization: `Bearer ${API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    event_name: "signup",
    allocation: 5,
    should_not_claim_twice: true,
  }),
});
{ "tx_hash": "0xabc123..." }