login-companyOne 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.
POST /create/company is authenticated like every other
endpoint here — an Authorization: Bearer token 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.
POST https://app.linet.org.il/api/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
(name → company.name,
vatnum → company.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
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 }
/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.
| Field | Notes |
|---|---|
| name | Legal/trading name (required) |
| country | ISO country code, defaults to IL |
| vatnum | VAT/business registration number — required and format‑validated when country is IL |
| type | Tax classification — see below |
| taxvat | VAT reporting frequency: 1 monthly, 2 bi‑monthly — drives the reporting period for /pcn874 |
| taxirs | Income tax (מס הכנסה) reporting identifier |
| taxrate | Default VAT rate for the company |
| double | 1 double-entry bookkeeping, 0 single-entry |
| stock | 1 enables the inventory module, 0 disables it |
| address, city, zip, phone, fax | Contact details |
| logo | URL 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:
POST https://app.linet.org.il/api/delete/company/{id} Full reference →
The API key — its bearer token — is 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 two headers on every request:
// headers Authorization: Bearer <token> login-company: 1
Copy the token when it is shown: Linet stores only a one‑way hash of it and cannot show it again. If it is lost, revoke the key and create a new one.
Older integrations send the token's two halves (split at the
dot) as login-id and login-hash headers;
that still works.