Create add-ons

Add-ons represent non-recurring fixed charges. Once created, they can be:

Added to a plan as a fixed charge, or
Applied directly to a customer through a one-off invoice

Dashboard
API

To create an add-on from the dashboard:

Open the Add-ons section from the side menu
Click Add an add-on
Enter a name, code, and optional description
Define the default amount and currency (these values can be overridden when issuing an invoice)
Click Add add-on to confirm

Create a Setup Fee add-on

LAGO_URL="https://api.getlago.com"
API_KEY="__YOUR_API_KEY__"

curl --location --request POST "$LAGO_URL/api/v1/add_ons" \
  --header "Authorization: Bearer $API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "add_on": {
      "name": "Setup Fee",
      "code": "setup",
      "amount_cents": 50000,
      "amount_currency": "USD",
      "description": "Charge a setup fee for new customers."
    }
  }'

Use an add-on

Once created, an add-on can be:

Added to a plan as a fixed charge, or
Applied to a specific customer through a one-off invoice

Manage add-ons

From the Add-ons section, you can edit or delete existing add-ons using the ellipsis menu.

Editing lets you update the name, code, description, and default values
Deleting permanently removes the add-on from all plans and subscriptions where it is used (this action cannot be undone)

Introduction

Get started

Events & Usage Components

Pricing & Subscriptions

Invoicing

Payments & Cash Collection

Data & Analytics

Resources

Create add-ons

Use an add-on

Manage add-ons

Introduction

Get started

Events & Usage Components

Pricing & Subscriptions

Invoicing

Payments & Cash Collection

Data & Analytics

Resources

​Use an add-on

​Manage add-ons

Use an add-on

Manage add-ons