User Event Webhooks
Terminal 3 supports user event webhooks that notify your application whenever certain user actions occur such as connecting social accounts, updating a user profile, or linking wallets.
These events are delivered as HTTP POST
requests to your specified webhook URL.
Note: Please contact the Terminal 3 team to enable webhook access and provide us your webhook URL.
Webhook Security
To protect your webhook endpoint:
- Ensure your URL is publicly accessible over HTTPS.
- Secure your endpoint with an auth token provided to Terminal 3.
- Example Authorization header:
Webhook Payload Structure
Each event sent to your webhook will follow this format:
Webhook Events
Below is the list of supported event types and their detailed payload structures.
Connect Social Account
Sent when a user connects one of their social media accounts.
Event Types:
CONNECT_TWITTER
CONNECT_STEAM
CONNECT_TWITCH
CONNECT_TELEGRAM
CONNECT_DISCORD
CONNECT_GITHUB
CONNECT_GOOGLE
CONNECT_FACEBOOK
CONNECT_LINKEDIN
Payload:
Disconnect Social Account
Sent when a user disconnects a previously linked social account.
Event Types:
DISCONNECT_TWITTER
DISCONNECT_STEAM
DISCONNECT_TWITCH
DISCONNECT_TELEGRAM
DISCONNECT_DISCORD
DISCONNECT_GITHUB
DISCONNECT_GOOGLE
DISCONNECT_FACEBOOK
DISCONNECT_LINKEDIN
Payload:
No payload. The disconnect event contains only id
, type
, timestamp
, and metadata
.
Create User Account
Sent when a new user account is created on Terminal 3.
Event Type: CREATE_USER_ACCOUNT
Payload:
Update User Profile
Sent when a user updates their profile during onboarding or within the profile edit page.
Event Type: UPDATE_USER_PROFILE
Payload:
Note: The payload includes client-specific username which is depending on the application.
Connect Wallet
Sent when a user connects an Ethereum wallet.
Event Type: CONNECT_ETH_WALLET
Payload:
Disconnect Wallet
Sent when a user disconnects an Ethereum wallet.
Event Type: DISCONNECT_ETH_WALLET
Payload:
Need Help?
For setup assistance, webhook secrets, or to register your endpoint, please contact the Terminal 3 support team.