Associate company ID to tenant

POST

/v2/tenant/{tenantKey}/company_id

const url = 'https://sender.api.kivra.com/v2/tenant/example/company_id';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"company_id":{"name":"Kivra AB","orgnr":"SE556840226601"}}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://sender.api.kivra.com/v2/tenant/example/company_id \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "company_id": { "name": "Kivra AB", "orgnr": "SE556840226601" } }'

Add a new company ID for a tenant. A tenant can be associated with one or more company ids (Vat number and company name)

Authorizations

oAuth2Client
post:kivra.v2.tenant.{tenantKey}.company_id

Parameters

Path Parameters

tenantKey

required

string format: hexadecimal

The unique Key for a Tenant

Request Body

application/json

object

company_id

CompanyId

object

name

required

Legal name of Company

string

Example

Kivra AB

orgnr

required

Vat number of Company

string

Example

SE556840226601

Responses

204

Empty response confirming that the post operation was successful

409

Another tenant with the same orgnr already exists.

application/json

Error40915

object

code

The 5-digits error code

string

short_message

A short message explaining the conflict

string

long_message

A text message explaining the conflict

string

Example

{
  "code": 40915,
  "short_message": "Orgnumber already exist",
  "long_message": "One or more of the organisation numbers within the company_id's you provided, already exist in existing tenants. Tenants outside your scope: {Name: TestBolag, Tenant key: 1424780396902ee9278b16417f8e3252c3ced28c38, Organisation number: SE556840226601}"
}