Workspace

Usage: see what each workspace consumes on WhatsApp

Read how many WhatsApp conversations and how much AI each workspace of your organization used in a month, to bill each of your clients for it.

Studio Nord, an agency, builds WhatsApp automations for its clients, with one workspace for each in its organization: the repair shop where Camille takes her bike, a bakery, a florist. In December, it bills each client for what their workspace used in November. Usage counts two things for each workspace: its billed conversations and what its AI cost.

What is a billed conversation?

One starts when WhatsApp reports the first message delivered to a contact, and covers the messages delivered to that contact on that number for 24 hours, up to 50. When the shop tells Camille at 10 a.m. that her bike is ready, then answers her questions until noon, that is one billed conversation. A message delivered the next day at 11 a.m., or the 51st of the day, starts another.

Only messages that reach the contact count. A message that ends failed is never billed, and neither are the contact's own messages nor a test, which messages only a member's own phone.

What does AI cost?

Every request a workspace's AI makes, in its automations and in its tests, in US dollars, at the AI provider's listed prices. The workspace log shows each request with its cost.

How does an agent read usage?

Only an administrator of the organization reads it. getOrganizationUsage gives its totals for a period, such as November, from 2026-11-01T00:00:00Z to 2026-12-01T00:00:00Z, and listOrganizationWorkspaceUsage gives each workspace's share, which Studio Nord bills to that client. WhatsApp can report a delivery up to 7 days late, so Studio Nord reads November once December 7 has passed. A deleted workspace keeps its usage, without its name. Heythere keeps usage 13 months.

In the API

Every operation is a REST endpoint and, unless marked REST only, an MCP tool of the same name. The OpenAPI document describes their parameters, payloads, and errors.

  • GET

    getOrganizationUsage

    Get an organization's usage

    /api/organizations/{organizationId}/usage
  • GET

    listOrganizationWorkspaceUsage

    List each workspace's usage

    /api/organizations/{organizationId}/usage/workspaces