Organizations
Update your organization
This endpoint is used to update your own organization's settings.
PUT
/api/v1/organizations
Bearer*
{
"organization": {
"address_line1": "100 Brex Street",
"address_line2": "null",
"billing_configuration": {
"document_locale": "en",
"invoice_footer": "This is my customer footer",
"invoice_grace_period": "3"
},
"city": "New York",
"country": "US",
"created_at": "2022-05-02T13:04:09Z",
"email": "brex@brex.com",
"lago_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
"legal_name": "null",
"legal_number": "null",
"name": "Name1",
"net_payment_term": "30",
"state": "NYC",
"tax_identification_number": "US123456789",
"taxes": [
{
"add_ons_count": "integer",
"applied_to_organization": true,
"charges_count": "integer",
"code": "french_standard_vat",
"created_at": "2023-07-06T14:35:58Z",
"customers_count": "integer",
"description": "French standard VAT",
"lago_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
"name": "TVA",
"plans_count": "integer",
"rate": "20"
}
],
"timezone": "America/New_York",
"webhook_url": "https://webhook.brex.com",
"webhook_urls": [
"https://webhook.brex.com",
"https://webhook2.brex.com"
],
"zipcode": "10000"
}
}
LAGO_URL="https://api.getlago.com"
API_KEY="__YOUR_API_KEY__"
curl --location --request PUT "$LAGO_URL/api/v1/organizations" \
--header "Authorization: Bearer $API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"organization": {
"webhook_url": "https://webhook.brex.com",
"country": "US",
"address_line1": "100 Brex Street",
"address_line2": null,
"state": "NYC",
"zipcode": "10000",
"email": "brex@brex.com",
"city": "New York",
"legal_name": null,
"legal_number": null,
"net_payment_term": 30,
"tax_identification_number": "US123456789",
"timezone": "America/New_York",
"email_settings": [
"invoice.finalized",
"credit_note.created"
],
"billing_configuration": {
"invoice_footer": "This is my customer footer",
"invoice_grace_period": 3,
"document_locale": "en",
"vat_rate": 12.5
}
}
}'
Authorizations
Authorizationheaderrequired
string
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Body
application/json
organizationrequired
object
Response
200 - application/json
organizationrequired
object
LAGO_URL="https://api.getlago.com"
API_KEY="__YOUR_API_KEY__"
curl --location --request PUT "$LAGO_URL/api/v1/organizations" \
--header "Authorization: Bearer $API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"organization": {
"webhook_url": "https://webhook.brex.com",
"country": "US",
"address_line1": "100 Brex Street",
"address_line2": null,
"state": "NYC",
"zipcode": "10000",
"email": "brex@brex.com",
"city": "New York",
"legal_name": null,
"legal_number": null,
"net_payment_term": 30,
"tax_identification_number": "US123456789",
"timezone": "America/New_York",
"email_settings": [
"invoice.finalized",
"credit_note.created"
],
"billing_configuration": {
"invoice_footer": "This is my customer footer",
"invoice_grace_period": 3,
"document_locale": "en",
"vat_rate": 12.5
}
}
}'
{
"organization": {
"address_line1": "100 Brex Street",
"address_line2": "null",
"billing_configuration": {
"document_locale": "en",
"invoice_footer": "This is my customer footer",
"invoice_grace_period": "3"
},
"city": "New York",
"country": "US",
"created_at": "2022-05-02T13:04:09Z",
"email": "brex@brex.com",
"lago_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
"legal_name": "null",
"legal_number": "null",
"name": "Name1",
"net_payment_term": "30",
"state": "NYC",
"tax_identification_number": "US123456789",
"taxes": [
{
"add_ons_count": "integer",
"applied_to_organization": true,
"charges_count": "integer",
"code": "french_standard_vat",
"created_at": "2023-07-06T14:35:58Z",
"customers_count": "integer",
"description": "French standard VAT",
"lago_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
"name": "TVA",
"plans_count": "integer",
"rate": "20"
}
],
"timezone": "America/New_York",
"webhook_url": "https://webhook.brex.com",
"webhook_urls": [
"https://webhook.brex.com",
"https://webhook2.brex.com"
],
"zipcode": "10000"
}
}