Skip to main content
The Embed Portal is where you manage API keys, webhook endpoints, view analytics, and debug webhook deliveries for your Nova integration. URL: https://embed.nova.dweet.com

Environments

Sandbox and production are completely separate. Each environment has its own API keys, webhook endpoints, and data.
Use the environment switcher in the portal to toggle between Sandbox and Production. The URL also reflects the environment:
  • https://embed.nova.dweet.com/sandbox
  • https://embed.nova.dweet.com/production

Roles

The portal supports two partner roles:
RolePermissions
AdminManage API keys and webhook endpoints
MemberView-only access

API key management

Viewing keys

Navigate to API Keys to see your keys:
ColumnDescription
NameOptional label for the key
KeyMasked key (sk_live_****7f3a)
CreatedWhen the key was generated
Last UsedMost recent API request (updated approximately every hour)

Creating keys

1

Click Create API Key

Opens the key creation dialog.
2

Add a name (optional)

Labels like “Production Server” help identify keys.
3

Copy the key immediately

The full key is shown once. Store it securely.
Never commit API keys to source control. Use environment variables or a secrets manager.

Revoking and restoring keys

To revoke a key:
  1. Click the menu on the key row
  2. Select Revoke
  3. Confirm the action
Revoked keys immediately return 401 Unauthorized on new requests. You can restore a revoked key from the Revoked Keys section.

Webhook endpoints

You can configure up to 5 webhook endpoints per environment. Each endpoint has its own signing secret and can be enabled or disabled.

Add an endpoint

1

Navigate to Webhooks

Open the Webhooks page for the current environment.
2

Add your endpoint URL

The URL must be HTTPS and publicly reachable.
3

Copy the signing secret

Use the whsec_* secret to verify signatures.

Test delivery

Use Send Test Webhook on an endpoint to verify connectivity and signature verification. Test webhooks use:
  • X-Webhook-Event: test
  • A small JSON payload with event, message, and timestamp

Update or delete

Admins can edit the endpoint URL, enable or disable delivery, regenerate the signing secret, or delete an endpoint.

Delivery history

View webhook delivery attempts and debug integration issues from the Delivery History page.

Viewing deliveries

Navigate to Webhooks and click Delivery History to see recent webhook deliveries.
ColumnDescription
StatusPending, Processing, Delivered, or Failed
EventScore Completed, Score Failed, or Batch Completed
EndpointThe target webhook URL
TenantThe tenant ID from the original request
AttemptsNumber of delivery attempts
ErrorLast error message (if failed)
CreatedWhen the webhook was queued

Filters

Use the filters to narrow down results:
  • Status: All, Pending, Processing, Delivered, Failed
  • Event Type: Filter by webhook event type
  • Endpoint: Filter by a specific endpoint
  • Time Range: Last 24 hours (default), 7 days, or 30 days

Delivery details

Click any row to open the detail modal:
  • Metadata: Event type, tenant, endpoint URL, attempt count, timestamps
  • Request Payload tab: Full JSON payload with copy button
  • Attempt History tab: Per-attempt details including HTTP status, duration, and expandable response body

Retrying failed deliveries

Only admins can retry failed deliveries.
When a webhook permanently fails (all retry attempts exhausted), admins can manually retry:
  1. Click the failed delivery row to open details
  2. Click Retry Delivery
  3. A new delivery is queued with fresh retry attempts
The retry creates a new webhook outbox entry. The original failure record is marked with the retry timestamp to prevent duplicate retries.
Retry is only available if the webhook endpoint still exists and is enabled. Deleted or disabled endpoints cannot receive retries.

Analytics dashboard

View API usage metrics and performance data from the Analytics page. The dashboard shows:
  • Total Requests: API calls in the selected period
  • Success Rate: Percentage of successful requests
  • Average Latency: Mean response time
  • Scores Generated: Completed scoring jobs
Use the time range selector to view data for the last 24 hours, 7 days, 30 days, or 90 days.

Support

If you need help, email nova@dweet.com.