L Linet Developers
Home / Journeys / New company & initial config
Journey 03 · Setup

Provision a company, then get its login-company

One call creates a new tenant under your subscription. The id it hands back is the login-company header every other journey on this site quietly assumes you already have.

You need existing credentials to create a company. POST /create/company is authenticated like every other endpoint here — login-id, login-hash, and a login-company you already have access to. Linet provisions your first company when your subscription starts; from there, this call is how you add more (an accountant onboarding a new client, for example). If you're integrating against a company that already exists, skip to getting credentials.

Create the company

POST /create/company Full reference →

name is the only required field, but set the tax profile up front — vatnum, type, and country drive how the company calculates and reports VAT from its very first document. Every field here is also written straight through to the new company's Settings (namecompany.name, vatnumcompany.vat.id, …), so there's nothing extra to configure after this call.

name: "Acme Ltd",
type: 3,
vatnum: "123456789",
country: "IL",
double: 1,
stock: 1

double and stock turn on double-entry bookkeeping and the inventory module. Leave both off for a simple exempt dealer with nothing to hold in stock:

name: "Jane Doe Consulting",
type: 2,
vatnum: "987654321",
country: "IL",
double: 0,
stock: 0

Read the new company's id off the response

The response echoes back the full company record, including the id Linet just assigned it. That id is your login-company from here on — a header value, not something you'll fetch from a body field anywhere else.

code: 200,
text: "OK",
body: {
  id: 42,
  name: "Acme Ltd",
  type: 3,
  // … every field you sent, plus id
}
There's no lookup endpoint for this. The API has no /newsearch/company or /update/company/{id} — the create response is the one place you'll see a company's id from the API itself. Store it when you get it.

The full tax & contact profile

FieldNotes
nameLegal/trading name (required)
countryISO country code, defaults to IL
vatnumVAT/business registration number — required and format‑validated when country is IL
typeTax classification — see below
taxvatVAT reporting frequency: 1 monthly, 2 bi‑monthly — drives the reporting period for /pcn874
taxirsIncome tax (מס הכנסה) reporting identifier
taxrateDefault VAT rate for the company
double1 double-entry bookkeeping, 0 single-entry
stock1 enables the inventory module, 0 disables it
address, city, zip, phone, faxContact details
logoURL or Base64 data URI

type is the company's legal/accounting entity type, which drives the default account and document behaviour set up for the new company:

1 · Self-employed (עוסק פטור/מורשה) 2 · Exempt dealer (עוסק פטור) 3 · LTD (חברה בע"מ) 4 · NPO (עמותה)

Deleting a company

POST /delete/company/{id} Full reference →

Hard delete, no undo. Unlike docs, items, and accounts, deleting a company doesn't just flip it to an "inactive" flag — the tenant and everything in it is permanently removed.

Getting API credentials

login-id and login-hash are issued by Linet once your integration is ready to connect — they aren't self‑service from the API itself. See linet.org.il/linet-api-authentication for how to request credentials scoped to the company (login-company) you need to integrate with.

From here, every other journey on this site sends the same three headers on every request:

// headers
login-id: X
login-hash: Y
login-company: 1