Skip to main content

Platform Lifecycle

Super administrators can create and manage DialStack platforms. Each platform is an independent tenant with its own accounts, users, branding, and API keys.

Creating a Platform​

  1. Navigate to Platforms from the sidebar.
  2. Click New Platform.
  3. Fill in:
    • Name — Display name for the platform (e.g., "Acme Telecom")
    • Handle — Unique lowercase identifier (e.g., "acme-telecom"). Must be alphanumeric with hyphens only.
    • Webhook URL (optional) — HTTPS endpoint for event notifications.
  4. Click Create Platform.

After creation, you'll see a dialog with the platform's API keys:

  • Publishable Key — Public key for client-side SDK use
  • Secret Key — Private key for server-to-server API calls (shown only once)
  • Sandbox Publishable Key — Public key for sandbox mode
  • Sandbox Secret Key — Private key for sandbox API calls (shown only once)
  • Webhook Secret — Used to verify webhook signatures

New platforms are created with live mode enabled by default. A super administrator can disable live mode to restrict the platform to sandbox-only operation.

warning

Copy the Secret Key and Sandbox Secret Key immediately. They are only shown once and cannot be retrieved later.

Platform Status​

Platforms can be in one of three states:

StatusDescription
ActivePlatform is fully operational
SuspendedPlatform is temporarily disabled
CancelledPlatform is permanently deactivated

Live Mode​

Each platform has a Live Mode Enabled toggle on the platform detail page, visible only to super administrators. This controls whether live API keys are accessible:

Live ModeSandbox KeysLive Keys
OffVisible and usableHidden from platform admins
On (default)Visible and usableVisible and usable

When live mode is disabled:

  • The live publishable key is greyed out on the platform detail page
  • Key rotation only rotates the sandbox secret key (the live key is unchanged)
  • Platform admins cannot see or copy live keys

To enable live mode, toggle the switch next to the platform status badge.

Messaging Partners​

The Messaging Partners card on the platform detail page controls automatic approval of messaging transfer requests. When a third-party messaging provider requests messaging rights on a number owned by this platform, these settings determine whether the request is automatically approved.

Auto-Approve Transfers​

When enabled, incoming messaging transfer requests from approved partners are automatically confirmed. When disabled, all requests are denied.

Approved Network Identifiers​

A list of provider identifiers that this platform trusts for messaging transfers. Only requests from identifiers in this list are auto-approved; all others are denied.

To manage the list:

  1. Type the identifier in the input field and click Add (or press Enter).
  2. Remove an entry by clicking the X button next to it.
  3. Click Save to persist changes.

Editing a Platform​

  1. Click on a platform in the platforms list.
  2. Modify any editable fields.
  3. Click Save Changes.

Deleting a Platform​

Deleting a platform permanently removes all associated accounts, users, devices, and data. To prevent accidental deletion, the process includes a typed confirmation and, for platforms with active accounts, a two-person approval flow.

Platforms with No Accounts​

If the platform has zero active accounts, a single super administrator can delete it:

  1. In the platforms list, click the trash icon on the platform row.
  2. Type the exact platform name to confirm.
  3. Click Request Deletion. The platform is deleted immediately.

Platforms with Active Accounts​

If the platform has one or more active accounts, two super administrators must be involved:

  1. Request: A super administrator opens the delete dialog, types the platform name, and submits the request.
  2. Approve: A different super administrator visits the platform detail page, sees the pending deletion banner, and clicks Approve Deletion. The requester cannot approve their own request.

Pending deletion requests expire after 24 hours. If the request is not approved in time, it must be re-submitted. Either administrator can cancel a pending request from the platform detail page.

warning

Deleting a platform permanently removes all associated accounts, users, devices, and data. This action cannot be undone.