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:
| Role | Permissions |
|---|
| Admin | Manage API keys and webhook endpoints |
| Member | View-only access |
API key management
Viewing keys
Navigate to API Keys to see your keys:
| Column | Description |
|---|
| Name | Optional label for the key |
| Key | Masked key (sk_live_****7f3a) |
| Created | When the key was generated |
| Last Used | Most recent API request (updated approximately every hour) |
Creating keys
Click Create API Key
Opens the key creation dialog.
Add a name (optional)
Labels like “Production Server” help identify keys.
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:
- Click the … menu on the key row
- Select Revoke
- 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
Navigate to Webhooks
Open the Webhooks page for the current environment.
Add your endpoint URL
The URL must be HTTPS and publicly reachable.
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.
| Column | Description |
|---|
| Status | Pending, Processing, Delivered, or Failed |
| Event | Score Completed, Score Failed, or Batch Completed |
| Endpoint | The target webhook URL |
| Tenant | The tenant ID from the original request |
| Attempts | Number of delivery attempts |
| Error | Last error message (if failed) |
| Created | When 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:
- Click the failed delivery row to open details
- Click Retry Delivery
- 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.