Partner Dashboard

What you can see and do for your partner account on widgetic.com, and the API calls behind each screen

Once Widgetic has approved your partner account, the person who administers it gets a dashboard on widgetic.com that is made for a partner: your credits and invoices, your managed users, the presets you offer (widgets and workflows), and how your customers’ widgets are used. Everything on it is also available through the API, so you can build the same views into your own tools.

Sign in with the account that administers the partner, open the settings menu of your personal workspace and choose Partner dashboard. An account that administers no partner does not have that entry.

​

What the Dashboard Shows for Each Status

A banner at the top says where your account stands (see Account Status).

Status	What the dashboard offers
inactive	Overview, Billing and credits, Notifications and Settings: what you need to get going, and nothing that needs customers. You can pay, set up your notifications and make your keys
suspended	The banner shows the reason Widgetic gave. Everything stays readable, but nothing can be changed. Billing, notifications and your API keys stay open, so you can pay and get going again
payment_arrears	The banner says that a payment on your partner account is overdue, and the status reads “Payment overdue”. Everything stays readable, but nothing can be changed. Billing, your invoices, adding credits, notifications and your API keys stay open: pay the overdue invoice and the account is back as soon as the payment goes through
active	Everything

​

The Tabs

Tab	What it is for	The API behind it
Overview	Where your partner account stands, and where to go next	GET /partners/mine
Billing and credits	Your credits and a button to add extra credits, what your customers used, your invoices with their tax, and your contract	GET /partners/{partnerId}/credits/balance, POST /partners/{partnerId}/credits/extra-invoice, GET /partners/{partnerId}/billing-overview, GET /partners/{partnerId}/contract and the invoice routes (see Credits & Billing)
Managed users	Your customers: switch them on or off, and see what each one used and keeps in storage	GET /users/{managerId}/managed-users, GET /managed-users/{id}/usage, GET /partners/{partnerId}/storage/usage (see Managed Users)
Presets	The widgets and the workflows you offer your customers as starting points	GET, PUT and DELETE on /partners/{partnerId}/presets for widgets, and on /partners/{partnerId}/workflow-presets for workflows (see Starting points)
Widgets	The widgets you and your customers made	GET /widgets, with managedUserId to narrow it to one customer
Analytics	How your customers’ published compositions are viewed and used	The four routes under /partners/{partnerId}/analytics (below)
Notifications	What Widgetic told you, and where it is sent	See Notifications
Settings	Your API keys, the domains your widgets can be embedded on, and your contact details	The API keys and domains of your account (see Authentication and Security)

Your own storage destination is not set up in the dashboard. You do that with the API (see Storage), or Widgetic’s team enters it for you.

​

Analytics

The analytics count what the visitors of your customers’ compositions did, from the events the embedded widgets send while they are shown (the Widgetic embed SDK sends them by itself). Only two things are counted: how many times a composition was viewed, and how many times a visitor interacted with one, plus how many different visitors there were. A visitor is a browsing session.

Route	What it answers
GET /partners/{partnerId}/analytics/summary	Views, interactions and visitors in a period, with how many different compositions and managed users were viewed
GET /partners/{partnerId}/analytics/managed-users	Every one of your managed users with what their widgets did: views, interactions and visitors, and how many widgets and compositions they have made. A customer nobody viewed is listed too, with zeros. The most viewed come first
GET /partners/{partnerId}/analytics/top-widgets	The widgets whose compositions were viewed the most, with views, interactions, visitors and how many of their compositions were viewed
GET /partners/{partnerId}/analytics/timeline	Views, interactions and visitors for each day of the period (UTC days), oldest first, for a chart. A day with nothing is all zeros

The period runs from startDate (included) to endDate (not included): the 30 days before now when you give neither, and at most 366 days. A date without a time is midnight UTC at the start of that day, so for all of October give startDate=2026-10-01 and endDate=2026-11-01. summary, top-widgets and timeline can be narrowed to one customer with managedUserId or managedUserExternalId (not both).

curl -sS -H "Authorization: Bearer $WIDGETIC_PARTNER_KEY" \
  "https://api.widgetic.com/v1/partners/$WIDGETIC_PARTNER_ID/analytics/summary?startDate=2026-10-01&endDate=2026-11-01&managedUserExternalId=your-platform-user-123"

{
  "success": true,
  "data": {
    "partnerId": "7d5f3c1a-2b64-4c0e-9a51-6f1e2d3c4b5a",
    "period": { "from": "2026-10-01T00:00:00.000Z", "to": "2026-11-01T00:00:00.000Z" },
    "managedUserId": "b9a0f1d2-3c4e-4f50-8a61-7b2c3d4e5f60",
    "views": 1840,
    "interactions": 312,
    "visitors": 904,
    "compositionsViewed": 7,
    "managedUsersViewed": 1
  }
}

A composition counts for a customer only when it is filed under them: send managedUserId or managedUserExternalId when you create it, or let the customer’s editor session do it, which files everything under them. What visitors did with a composition that is not filed under anyone is in the summary of the whole account and in no customer’s row.

Analytics need the partner:read scope when your key is limited to some scopes. The numbers are counted when you ask, so they are always current.

Credits & Billing

Invoices, tax, payments and credits

Managed Users

Your customers, their presets and what they use