Getting Started

This guide walks you through creating a stemp application and making your first API call.

Prerequisites

• A stemp account with developer access
• Basic knowledge of OAuth2 and REST APIs

Step 1: Create an Application

1. Log in to the Developer Portal.
2. Click Create Application.
3. Fill in the application details:
   • Name — A human-readable name for your app.
   • Slug — A unique URL-friendly identifier.
   • Redirect URIs — The URIs where users will be redirected after authorization.
   • Scopes — The permissions your app needs (e.g., pass:read, pass:create).
4. Save your application. You'll receive a Client ID.

Your Client Secret can be revealed once from the OAuth settings page. Store it securely.

Step 2: Configure OAuth2

stemp uses OAuth2 with PKCE for authentication. See the OAuth2 Flow guide for the full implementation details.

Quick summary: Your app redirects users to the stemp authorization endpoint → users grant consent → stemp redirects back with a code → you exchange it for tokens.

Step 3: Make Your First API Call

Once you have an access token, you can make API calls. For example, to list users in the organization:

curl -X GET https://api.stemp.app/api/v1/users \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Or if you're using an API token for server-to-server access:

curl -X GET https://api.stemp.app/api/v1/users \
  -H "Authorization: Bearer sk_live_YOUR_API_TOKEN"

Step 4: Set Up Webhooks (Optional)

To receive real-time notifications when events occur (e.g., a stamp is added, a pass is installed), configure Webhooks in your application settings.

Next Steps

• Read the App Lifecycle guide for the full app creation and publishing workflow
• Explore Users & Wallet Passes to manage your core resources
• Set up Loyalty (Stamps) for your stamp card program
• Review available Scopes to request the right permissions
• Check out the SDKs & Examples for code samples in multiple languages
• Explore all endpoints interactively in the API Reference