Skip to main content
POST
/
v1
/
companies
/
{company_id}
/
plans
Create Company Plan
curl --request POST \
  --url https://api.gofermata.com/v1/companies/{company_id}/plans \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "string",
  "charge_amount": 0,
  "charge_denomination": "string",
  "billing_period": "string",
  "rollover": true,
  "balances": [
    {
      "amount": "string",
      "denomination": "string",
      "overage_charge_amount": 0,
      "overage_charge_denomination": "string",
      "auto_refill_amount": 0,
      "auto_refill_threshold": 0
    }
  ]
}
'

Documentation Index

Fetch the complete documentation index at: https://fermata-preview.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Path Parameters

​
company_id
string
required

Body

application/json
​
charge_amount
integer
required
​
charge_denomination
string
required
​
billing_period
string
required
​
name
string
​
rollover
boolean

Should all existing balances be cleared when a new billing period starts?

​
threshold_alert_percentage
integer

Causes a webhook to be sent when any of the balances drops below the given percentage

​
balances
object[]
Minimum array length: 1

Response

200

OK