beel_activate_company
Activates an existing company in an explicit TEST or PROD mode, handling Live checkout and billing while cancelling pending switch-offs without duplicate charges.
Instructions
Switches an existing company on in the mode carried in the body. The mode is always explicit and never taken from the credential's environment, so a Test key can switch a NIF on in Live.
Modes and billing
TEST: immediate and free.PROD: immediate when the account already has a card on file or an enterprise contract, and the NIF is added to the existing subscription. With no card on file it answers402 CHECKOUT_REQUIRED, returning acheckout_urlwhensuccess_urlandcancel_urlare supplied. It also requires being the billing subject of the account (403 NOT_BILLING_OWNERotherwise).billing_period: picks the plan the checkout sells —MONTHLY(default) orANNUAL. It only matters when a checkout is opened. Accounts with a negotiated rate or an enterprise contract cannot buy the annual plan (422 ANNUAL_PLAN_NOT_AVAILABLE).
Idempotency and pending switch-offs
Repeating the call: opens no second checkout and adds no second subscription item; it returns the existing activation with
already_active: true. The sameIdempotency-Keysent to this route and to the nested one it replaces is the same operation, so it is replayed and never charged twice.A pending switch-off is cancelled: while it is pending the NIF is still on — it just carries an effective date — so switching it on again only removes that date, answers
scheduled_deactivation_cancelled: true, and charges or credits nothing. It does commit the NIF to the next billing cycle, though, so under an agreement capped at a number of Live NIFs it asks for a seat like a new NIF would, and is rejected with409 NIF_LIMIT_REACHEDwhen the cap is already full.
BeeL API endpoint: POST /v1/companies/{company_id}/activations (reference: https://docs.beel.es)
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"company_id": "<company_id>",
"body": "<body>"
},
"name": "beel_activate_company"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | Yes | ||
| company_id | Yes | Unique identifier (UUID) of the company being switched on — its identifier, not its NIF. It is the only source of context: the account that owns it is derived from it, and the `BeeL-Active-Company` header plays no part. A company you do not reach answers `403`, and so does a company that does not exist, so the existence of a company in another account is never disclosed. | |
| idempotency_key | No | Optional idempotency key for this operation. Omit it and one is derived from the request itself, which makes a blind retry safe but also collapses a SECOND, deliberately identical operation into the first for 24 hours. Set it — to an order id, or anything unique per intended operation — whenever you mean to create something that may look identical to what you just created. |