App Creation
How to create an app, choose scopes, and prepare for authentication.
Create New App
- If you already have a Digits account: open Developer (left sidebar), click Create App
Start building with Digits Connect
For a free developer account, sign up at my.digits.com/join/developer.
We'd love to learn more about what you're building! Reach out to [email protected] and let us know how we can help meet your needs.
Setting Identity
Use the Identity tab to enter these fields when creating an app and to update them later.
Identity
| Field | Description |
|---|---|
| App Name | The name of your app, shown in the Digits Dashboard and (eventually) to users |
| Tagline | A one-line summary of your app’s purpose |
| App Icon | Upload a logo for your app |
Your icon is the first thing users see. It appears on the Developer Dashboard, the install/auth screen, and (when available) your app listing. A clear, recognizable icon builds trust.
Summary
| Field | Description |
|---|---|
| Description | Clear overview of what your app does and who it’s for |
| Homepage | Your app’s public website or landing page. Must start with https:// |
| Support Email | The email address that end users should contact for app support |
| Developer Email | Where Digits can reach you for app-related updates or questions |
| Privacy Policy | Optional public URL to your app's privacy policy |
| Terms of Service | Optional public URL to your app's terms of service |
Choose App Permissions (Scopes)
| Scope | Description |
|---|---|
source:sync | Write source data into the Ledger |
ledger:read | Read data from the Ledger |
documents:write | Upload files to Documents |
Use least privilege—request only the scopes your app actually needs. You can adjust later, but changes may require re-authorization and/or regenerating credentials.
Click Save.
Configuration
App Install URL
Enter an optional, valid https:// URL for your app's install flow, which usually begins OAuth. Digits deep links users to this URL when they select Connect from within Digits. For example: https://example-app.example.com/install/digits.
Digits uses this field on published app listings.
Redirect URLs
Define your app's OAuth redirect URLs.
Required for the authorization code flow (for example,
https://yourapp.com/oauth/callback). Not required for client credentials. For full auth details, see Authentication.
Requirements
- Full URL (scheme + host + path), e.g.
https://app.example.com/oauth/callback - HTTPS required in production (HTTP allowed for
localhost) - No wildcards (for example,
*example.comis not allowed) - No fragments (for example,
#sectionis not allowed) - Query strings are allowed, but must match exactly
- Trailing slashes must match (
/callback≠/callback/) - IPs not allowed;
localhostis allowed for local development
Use Add Redirect URI to include as many as you need.
Keys
The Keys tab is where you manage your app's development and production credentials.
Environments
Digits automatically issues Development and Production client_ids to Apps. Use the toggle at the top of the page to select which credentials you're viewing.
Development — build and test only; installable in your developer sandbox; no approval needed. See Developer Sandbox for install instructions.
Production — live use. Internal apps can be installed without approval when the installer has access to the app and target entity. Approval is required to install in other customers' ledgers; publishing is required to list the app in the Digits Connect integrations list. See Publishing Apps for the full mode breakdown.
Updated 14 days ago
What’s Next
Continue to Publishing Apps to understand app modes, approval, and publishing.