Skip to main content

Getting SBT Identifier

What is event_uuid?​

event_uuid is a unique identifier of your event in ONTON system:

  • Unique identifier - each event has its own UUID
  • Format - string of 36 characters with dashes (e.g.: 303f3438-ee1e-4b69-95d5-e27f07dd83fe)
  • Purpose - used in API requests to specify which SBT to distribute

Get SBT Identifier​

After your event is approved by moderators, you need to get its identifier to work with the API.

Step-by-step instructions:​

  1. Open ONTON application via link: https://t.me/theontonbot
  2. At the bottom right click My ONTON button
  3. Click Hosted item - this shows your created events
  4. Click on the line with Event - select the needed event from the list
  5. To the right of the Title click Share button
  6. Minimize ONTON application
  7. Open chat with @theontonbot
  8. In the received message copy the part of the link after startapp=

Example of getting UUID:​

The received link will look like this:

https://t.me/theontonbot/start?startapp=303f3438-ee1e-4b69-95d5-e27f07dd83fe

From this link you need the part after startapp=:

303f3438-ee1e-4b69-95d5-e27f07dd83fe

This is your event identifier - event_uuid.

Saving UUID:​

Important: Save the obtained event_uuid in a safe place. You will need it for:

  • Setting up API in your application
  • Debugging and testing
  • Creating SBT distribution requests

Possible issues:​

  • Event not displayed in Hosted - it may still be under moderation
  • Link not coming - check that you clicked the Share button
  • Wrong UUID format - make sure you copied only the part after startapp=

Ready for integration:​

After getting event_uuid you have everything needed for API integration:

  • ✅ Organizer access
  • ✅ API key
  • ✅ Approved event
  • ✅ event_uuid

Now you can proceed to technical API setup in your mini-application.