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

curl --location --request POST "$LAGO_URL/api/v1/customers" \
  --header "Authorization: Bearer $API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "customer": {
      "external_id": "5eb02857-a71e-4ea2-bcf9-57d3a41bc6ba",
      "address_line1": "5230 Penfield Ave",
      "address_line2": "",
      "city": "Woodland Hills",
      "country": "US",
      "currency": "USD",
      "email": "dinesh@piedpiper.test",
      "legal_name": "Coleman-Blair",
      "legal_number": "49-008-2965",
      "tax_identification_number": "EU123456789",
      "logo_url": "http://hooli.com/logo.png",
      "name": "Gavin Belson",
      "phone": "1-171-883-3711 x245",
      "state": "CA",
      "timezone": "Europe/Paris",
      "url": "http://hooli.com",
      "zipcode": "91364",
      "billing_configuration": {
        "invoice_grace_period": 3,
        "payment_provider": "stripe",
        "provider_customer_id": "cus_12345",
        "sync": true,
        "sync_with_provider": true,
        "document_locale": "fr",
        "provider_payment_methods": ["card", "sepa_debit", "us_bank_account", "bacs_debit"]
      },
      "metadata": [
        {
          "key": "Purchase Order",
          "value": "123456789",
          "display_in_invoice": true
        }
      ],
      "tax_codes": ["french_standard_vat"]
    }
  }'

from lago_python_client.client import Client
from lago_python_client.exceptions import LagoApiError
from lago_python_client.models import Customer, CustomerBillingConfiguration

client = Client(api_key='__YOUR_API_KEY__')

metadata_object = Metadata(
  display_in_invoice=True,
  key='Purchase Order',
  value='123456789'
)

customer = Customer(
  external_id="5eb02857-a71e-4ea2-bcf9-57d8885990ba",
  address_line1="5230 Penfield Ave",
  address_line2=None,
  city="Woodland Hills",
  currency="USD",
  country="US",
  email="test@example.com",
  legal_name="Coleman-Blair",
  legal_number="49-008-2965",
  tax_identification_number="EU123456789",
  logo_url="http://hooli.com/logo.png",
  name="Test Name",
  phone="1-171-883-3711 x245",
  state="CA",
  timezone="Europe/Paris",
  url="http://hooli.com",
  zipcode="91364",
  billing_configuration=CustomerBillingConfiguration(
    invoice_grace_period=3,
    payment_provider="stripe",
    provider_customer_id="cus_12345",
    sync=true,
    sync_with_provider=true,
    document_locale="fr"
  ),
  metadata=MetadataList(__root__=[metadata_object])
)

try:
    client.customers.create(customer)
except LagoApiError as e:
    repair_broken_state(e)  # do something on error or raise your own exception

require 'lago-ruby-client'

client = Lago::Api::Client.new({api_key: '__YOUR_API_KEY__'})

client.customers.create(
  external_id: "5eb02857-a71e-4ea2-bcf9-57d3a41bc6ba",
  address_line1: "5230 Penfield Ave",
  address_line2: nil,
  city: "Woodland Hills",
  country: "US",
  currency: "USD",
  email: "dinesh@piedpiper.test",
  legal_name: "Coleman-Blair",
  legal_number: "49-008-2965",
  tax_identification_number: "EU123456789",
  logo_url: "http://hooli.com/logo.png",
  name: "Gavin Belson",
  phone: "1-171-883-3711 x245",
  state: "CA",
  timezone: "Europe/Paris",
  url: "http://hooli.com",
  zipcode: "91364",
  billing_configuration: {
    invoice_grace_period: 3,
    payment_provider: "stripe",
    provider_customer_id: "cus_12345",
    sync: true,
    sync_with_provider: true,
    document_locale: "fr",
    provider_payment_methods: ["card", "sepa_debit", "us_bank_account", "bacs_debit"]
  },
  metadata: [
    {
      key: 'Purchase Order',
      value: '123456789',
      display_in_invoice: true
    }
  ],
  tax_codes: ["french_standard_vat"]
)

import { BillingConfigurationCustomer } from "lago-javascript-client";

const customerObject = {
  external_id: "5eb02857-a71e-4ea2-bcf9-57d3a41bc6ba",
  address_line1: "5230 Penfield Ave",
  city: "Woodland Hills",
  currency: "EUR",
  country: "US",
  email: "dinesh@piedpiper.test",
  legal_name: "Coleman-Blair",
  legal_number: "49-008-2965",
  tax_identification_number: "EU123456789",
  logo_url: "http://hooli.com/logo.png",
  name: "Gavin Belson",
  phone: "1-171-883-3711 x245",
  state: "CA",
  timezone: "Europe/Paris",
  url: "http://hooli.com",
  zipcode: "91364",
  billing_configuration: {
    invoice_grace_period: 3,
    paymentProvider:
      "stripe" as BillingConfigurationCustomer["paymentProvider"],
    provider_customer_id: "cus_12345",
    sync: true,
    sync_with_provider: true,
    document_locale: "fr"
  },
  metadata: [
    {
      key: "Purchase Order",
      value: "123456789",
      display_in_invoice: true,
    },
  ],
};

await client.customers.createCustomer({ customer: customerObject });

import "fmt"
import "github.com/getlago/lago-go-client"

func main() {
lagoClient := lago.New().
    SetApiKey("__YOUR_API_KEY__")

customerInput := &lago.CustomerInput{
    ExternalID:              "5eb02857-a71e-4ea2-bcf9-57d3a41bc6ba",
    Name:                    "Gavin Belson",
    Email:                   "dinesh@piedpiper.test",
    AddressLine1:            "5230 Penfield Ave",
    AddressLine2:            "",
    City:                    "Woodland Hills",
    Country:                 "US",
    Currency:                "USD",
    State:                   "CA",
    Zipcode:                 "75001",
    LegalName:               "Coleman-Blair",
    LegalNumber:             "49-008-2965",
    TaxIdentificationNumber: "EU123456789",
    Phone:                   "+330100000000",
    Timezone:                "Europe/Paris",
    URL:                     "http://hooli.com",
    BillingConfiguration: &CustomerBillingConfigurationInput{
    InvoiceGracePeriod: 3,
    PaymentProvider: lago.PaymentProviderStripe,
    ProviderCustomerID: "cus_123456789",
    SyncWithProvider: true,
    DocumentLocale: "fr"
    },
    Metadata: [
    &CustomerMetadataInput{
        Key: "Purchase Order",
        Value: "123456789",
        DisplayInInvoice: true
    }
    ]
}

customer, err := lagoClient.Customer().Create(customerInput)
if err != nil {
    // Error is *lago.Error
    panic(err)
}

// You can use the same input to update the customer
customer, err := lagoClient.Customer().Update(customerInput)
if err != nil {
    // Error is *lago.Error
    panic(err)
}

// customer is *lago.Customer
fmt.Println(customer)
}

using System.Collections.Generic;
using System.Diagnostics;
using Org.OpenAPITools.Api;
using Org.OpenAPITools.Client;
using Org.OpenAPITools.Model;

namespace Example
{
  public class CreateCustomerExample
  {
      public static void Main()
      {
          Configuration.Default.BasePath = "https://api.getlago.com/api/v1";
          // Configure HTTP bearer authorization: bearerAuth
          Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

          var apiInstance = new CustomersApi(Configuration.Default);
          var customerInput = new CustomerInput(); // CustomerInput | Customer payload

          try
          {
              // Create a customer
              Customer result = apiInstance.CreateCustomer(customerInput);
              Debug.WriteLine(result);
          }
          catch (ApiException e)
          {
              Debug.Print("Exception when calling CustomersApi.CreateCustomer: " + e.Message );
              Debug.Print("Status Code: "+ e.ErrorCode);
              Debug.Print(e.StackTrace);
          }
      }
  }
}

<?php
require_once(__DIR__ . '/vendor/autoload.php');


// Configure Bearer authorization: bearerAuth
$config = OpenAPI\Client\Configuration::getDefaultConfiguration()->setAccessToken('YOUR_ACCESS_TOKEN');


$apiInstance = new OpenAPI\Client\Api\CustomersApi(
  // If you want use custom http client, pass your client which implements `GuzzleHttp\ClientInterface`.
  // This is optional, `GuzzleHttp\Client` will be used as default.
  new GuzzleHttp\Client(),
  $config
);
$customer_input = new \OpenAPI\Client\Model\CustomerInput(); // \OpenAPI\Client\Model\CustomerInput | Customer payload

try {
  $result = $apiInstance->createCustomer($customer_input);
  print_r($result);
} catch (Exception $e) {
  echo 'Exception when calling CustomersApi->createCustomer: ', $e->getMessage(), PHP_EOL;
}