logo
DocsDashboardSettings

Account & Settings

Manage your account, API tokens, and webhook integrations

The Settings section contains account-level configuration for your Simplifyd Box workspace, including API access and event integrations.


Account

Navigate to Settings → Account to update your personal profile, change your password, or manage your account credentials.


API Tokens

API tokens allow external tools and scripts to interact with the Simplifyd Box API programmatically — for example, to automate provisioning, pull network telemetry, or integrate with your own infrastructure.

Navigate to Settings → Tokens to manage your tokens.

Creating a Token

  1. Navigate to Settings → Tokens
  2. Click New Token
  3. Give the token a descriptive name (e.g., monitoring-script or terraform-automation)
  4. Copy the token value immediately after creation — it will not be shown again

Treat API tokens like passwords. Store them securely in a secrets manager and never commit them to version control.

Revoking a Token

To revoke a token, find it in the tokens list and select Delete. The token is invalidated immediately and any integrations using it will lose access.


Webhooks

Webhooks let Simplifyd Box push event notifications to your own systems in real time — for example, to trigger alerts when a site goes offline or a policy is changed.

Navigate to Settings → Webhooks to manage your webhook endpoints.

Adding a Webhook

  1. Navigate to Settings → Webhooks
  2. Click New Webhook
  3. Enter the destination URL — this is the HTTPS endpoint on your system that will receive the event payloads
  4. Save the webhook

Simplifyd Box will send HTTP POST requests with a JSON payload to your endpoint when matching events occur.

Your endpoint must respond with a 2xx status code to acknowledge receipt. Failed deliveries may be retried.


Danger Zone

Navigate to Settings → Danger for destructive, irreversible actions such as deleting the workspace.

Actions in the Danger Zone are permanent. Deleting a workspace removes all associated sites, policies, members, and configuration with no possibility of recovery.