What is an Application?

An Application is a container within your organization that groups related resources together. It provides isolation and organization for your Unipile integration.

Each application contains:

• Provider Accounts linked to that application
• API Keys used to authenticate requests
• Webhook Endpoints for receiving real-time events
• Configuration settings specific to the application

---

Why Create Multiple Applications?

You can create multiple applications within your organization to:

• Separate environments: Create different applications for development, staging, and production
• Isolate products: Keep different products or client projects separate
• Manage access: Control which team members can access which resources
• Organize resources: Group related accounts, keys, and webhooks logically

---

Environments

Applications can operate in two environments:

Development

Development applications are ideal for testing and development. All members of your organization can interact with development applications (link accounts, create webhooks, generate API keys).

Production

Production applications are for live, customer-facing integrations. Access to production applications is more restricted:

• Members can link accounts, add webhook endpoints, and create API keys
• Admins can delete and update accounts, webhooks, API keys, and configuration
• Owners have full control over all resources

---

Application Scoping

API Keys & Accounts

API Keys are scoped to a specific application. When making API calls, you must use an API Key that belongs to the same application as the Account you're targeting.

Webhooks

Webhook endpoints are configured at the application level. Events from accounts within an application will be sent to the webhook endpoints configured for that application.

---

Creating an Application

To create a new application:

1. Go to your organization in the Dashboard
2. Navigate to the Applications section
3. Click Create Application
4. Provide a name and description for your application
5. Select the environment (Development or Production)
6. Click Create

💡

Note: Only Admins and Owners can create, modify, and delete applications.

---

Managing Applications

Once created, you can:

• View application details: See all accounts, API keys, and webhooks associated with the application
• Update settings: Modify application name, description, and configuration
• Delete application: Remove the application and all its resources (requires Admin or Owner role)

⚠️

Warning: Deleting an application will remove all associated accounts, API keys, and webhooks. This action cannot be undone.