POST
/
billing_entities
curl --request POST \
  --url https://api.getlago.com/api/v1/billing_entities \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "billing_entity": {
    "code": "acme_corp",
    "name": "Acme Corp",
    "default_currency": "USD",
    "document_numbering": "per_customer",
    "document_number_prefix": "ABC-123",
    "finalize_zero_amount_invoice": true,
    "billing_configuration": {
      "invoice_footer": "Thank you for your business",
      "document_locale": "en",
      "invoice_grace_period": 0
    },
    "net_payment_term": 0,
    "address_line1": "5230 Penfield Ave",
    "address_line2": "Suite 100",
    "city": "Woodland Hills",
    "state": "CA",
    "country": "US",
    "zipcode": "91364",
    "email": "billing@acme.com",
    "legal_name": "Acme Corporation",
    "legal_number": "US123456789",
    "tax_identification_number": "EU123456789",
    "timezone": "UTC",
    "email_settings": [
      "invoice.finalized"
    ],
    "eu_tax_management": false,
    "logo": "data:image/png;base64,..."
  }
}'
{
  "lago_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
  "code": "acme_corp",
  "name": "Acme Corp",
  "default_currency": "USD",
  "document_locale": "en",
  "document_numbering": "per_customer",
  "document_number_prefix": "ABC-123",
  "finalize_zero_amount_invoice": true,
  "invoice_footer": "Thank you for your business",
  "invoice_grace_period": 0,
  "is_default": false,
  "net_payment_term": 0,
  "address_line1": "5230 Penfield Ave",
  "address_line2": "Suite 100",
  "city": "Woodland Hills",
  "state": "CA",
  "country": "US",
  "zipcode": "91364",
  "email": "billing@acme.com",
  "legal_name": "Acme Corporation",
  "legal_number": "US123456789",
  "tax_identification_number": "EU123456789",
  "timezone": "UTC",
  "email_settings": [
    "invoice.finalized"
  ],
  "eu_tax_management": false,
  "logo_url": "https://getlago.com/logo.png",
  "created_at": "2022-04-29T08:59:51Z",
  "updated_at": "2022-04-29T08:59:51Z"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

The billing entity payload

Billing entity create input

Response

200
application/json

Billing entity created

Billing entity object