Add a client company
Creates a client company under the key's account with its company data. The key's member becomes its owner, so the same key can act on it at once with the Getbeel-Company header. A client company cannot have client companies (409 company_nesting_not_allowed). Each company has its own plan: live SDI sends from a client company need its own SDI add-on. Live keys only (403 livemode_required with a test key): companies are real accounts, there is no sandbox for them.
Creates a client company under the key's account with its company data. The key's member becomes its owner, so the same key can act on it at once with the Getbeel-Company header. A client company cannot have client companies (409 company_nesting_not_allowed). Each company has its own plan: live SDI sends from a client company need its own SDI add-on. Live keys only (403 livemode_required with a test key): companies are real accounts, there is no sandbox for them.
apiKeyAuthorizationBearer <token>API key: gb_test_… or gb_live_…
Idempotency-Key?stringRecommended. Retrying with the same key and body within 24 hours replays the first response (header Idempotent-Replayed: true) instead of acting twice. The same key with a different body returns 422 idempotency_key_reused.
length <= 255application/json- body
name*stringCompany name (ragione sociale)
1 <= length <= 255country?stringISO 3166-1 alpha-2 country. Default IT
^[A-Z]{2}$vat_number?|Partita IVA (Italy: 11 digits, without the IT prefix)
codice_fiscale?|Codice fiscale (Italy: 16 characters for a person, or the 11 digits of the P.IVA for most companies)
regime_fiscale?|Regime fiscale of the CedentePrestatore (FatturaPA 1.2.1.8): RF01 ordinario, RF19 forfettario…
address?|Street (via, piazza…)
street_number?|Numero civico
postal_code?|CAP
city?|Comune
province?|Provincia (sigla)
OK
application/json- response
object*stringid*stringSend it as the Getbeel-Company header (or the MCP company_id argument) to act on this company
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$uuidname*stringslug*string|nullparent_id*|The parent (platform) account, null for the parent itself and for standalone accounts
company*|nullsdi_readiness*curl -X POST 'https://www.getbeel.com/api/v1/companies' \ -H 'Content-Type: application/json' \ -d '{ "name": "Rossi Srl"}'{ "object": "company", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string", "slug": "string", "parent_id": "1c6ca187-e61f-4301-8dcb-0e9749e89eef", "company": { "name": "string", "vat_number": "string", "codice_fiscale": "string", "regime_fiscale": "RF01", "country": "string", "address": "string", "street_number": "string", "postal_code": "string", "city": "string", "province": "string", "preferred_currency": "string", "sdi_configured": true }, "sdi_readiness": { "ready": true, "missing": [ "name" ] }}