Update Account Profile
Sets whether your active account is a personal or a company account, and the company details. This is the Company profile card in Account Settings. It replaces the whole profile: send every company field you want to keep.
Requires the settings:update permission. Invoices don't use this profile: the name, address and tax IDs on invoices are the account's billing details (see Company profile).
Request body
entity_type string Req
individual or company. individual clears every company field, whatever company holds.company.legal_name string
Required for
company. Up to 255 characters, using letters, numbers, spaces and . ' - _ ( ) ! ? : , + &.company.website string
Optional. An
https:// or http:// address of up to 255 characters.company.size string
Optional. One of
1, 2-10, 11-50, 51-200, 201-1000, 1000+.company.industry string
Optional. One of
software, saas, ecommerce, media, finance, healthcare, education, government, agency, gaming, telecom, manufacturing, nonprofit, other.company.country string
Optional. The country of registration as a two-letter ISO 3166-1 code; lowercase is accepted and stored uppercase.
Response (200 OK)
The updated profile, the same object as GET /account/profile.
Errors
400 Bad Request
The body couldn't be parsed or had unknown fields (
{"error": "Invalid request body"}), or a field failed validation: {"error", "field"}, where field names it, for example entity_type, company.legal_name or company.website.401 Unauthorized
Missing or invalid auth.
403 Forbidden
No active account selected, you lack the
settings:update permission, or the account is suspended (code account_suspended).Request
curl -X PUT "https://api.ngris.com/v1/account/profile" \
-H "X-API-KEY: <your_api_key>" \
-H "Content-Type: application/json" \
-d '{
"entity_type": "company",
"company": {
"legal_name": "Acme Ltd",
"website": "https://acme.example",
"size": "11-50",
"industry": "saas",
"country": "FI"
}
}'
Python
from ngris import Ngris
client = Ngris(api_key="<your_api_key>")
profile = client._put_raw("/account/profile", {
"entity_type": "company",
"company": {"legal_name": "Acme Ltd", "country": "FI"},
})
Response — 400 Bad Request
{
"error": "Website must be an http(s):// address of 255 characters or fewer",
"field": "company.website"
}