GEgetsales
subscription_allocations

Create subscription allocation

Hand a workspace a share of a subscription's pool: the workspace turns active with these quantities as its limits, the credits due so far this period are issued, and a lapsed trial share is superseded. The caller must be the buyer (403 not_subscription_owner) and a partner account (403 partner_only; a standard account's one share follows its plan on its own); the workspace must be the buyer's own or a client workspace of a brand the buyer's team owns (403 team_not_reachable). For every key the shares may not exceed the pool (409 pool_exceeded with key, pool, allocated_elsewhere, requested); a workspace already on a live share is 409 team_already_allocated; a canceled subscription takes no share. Quantities omitted are 0.

Contract:

  • MCP tool create_subscription_allocation, registry package mcp.id/subscription_allocations, mount id.partner.
  • Operation create, response envelope create.
  • Flags: none.
post/api/subscription-allocations

Request

  • Base URL
    https://beta.getsales.io/id/v1
  • Auth
    HTTP bearer and API key in header Team-SID

Request body

subscription_sidstring required

The subscription whose pool is shared (bl_sb_...); the caller must be its buyer.

team_sidstring required

The workspace that gets the share (ts_tm_...): the buyer's own, or a client workspace of a brand the buyer's team owns.

linkedin_sender_profilesinteger

LinkedIn sender profiles (accounts) for the workspace; default 0.

email_inboxesinteger

Inboxes for the workspace; default 0.

credits_per_monthinteger

Platform credits granted every month; default 0.

whitelabelinteger

1 to let the workspace register brands; default 0.

Response

create success envelope.

successtrue required
operation'create' required
already_existsboolean required

Changes

No recorded changes to this operation across all 1 revision of this API.