---
title: "Create an e-invoicing connection"
method: POST
path: "/einvoicing_connections"
tags: ["E-invoicing connections"]
---

# Create an e-invoicing connection

`POST /einvoicing_connections`

## Request

- Base URL: `https://api.sandbox.monite.com/v1`
- URL: `https://api.sandbox.monite.com/v1/einvoicing_connections`
- Auth: HTTP bearer

## Headers

- `x-monite-version` string, required
- `x-monite-entity-id` string, required

## Request body

- object
  - `address` EinvoicingAddress, required
    - `address_line1` string, required: Street address line 1
    - `address_line2` string: Street address line 2
    - `city` string, required: City name
    - `country` 'DE' | 'NL' | 'BE', required
    - `postal_code` string, required: Postal/ZIP code
    - `state` string: State/Province/County
  - `entity_vat_id_id` string, uuid: Entity VAT ID identifier for the integration
  - `is_receiver` boolean: Set to `true` if the entity needs to receive e-invoices.
  - `is_sender` boolean: Set to `true` if the entity needs to send e-invoices. Either `is_sender` or `is_receiver` or both must be `true`.

## Response `201`

Successful Response

- EinvoicingConnectionResponse
  - `id` string, uuid, required
  - `created_at` string, date-time, required: Date of Integration
  - `updated_at` string, date-time, required: Last update of Integration
  - `address` EinvoicingAddress, required
    - `address_line1` string, required: Street address line 1
    - `address_line2` string: Street address line 2
    - `city` string, required: City name
    - `country` 'DE' | 'NL' | 'BE', required
    - `postal_code` string, required: Postal/ZIP code
    - `state` string: State/Province/County
  - `credentials` EinvoicingNetworkCredentialsResponse[], required: List of credentials
    - `id` string, uuid, required: ID of the credentials
    - `created_at` string, date-time, required: Date of credential
    - `updated_at` string, date-time, required: Last update of credential
    - `einvoicing_connection_id` string, uuid, required: ID of the Einvoicing connection
    - `network_credentials_identifier` string, required: Network participant identifier
    - `network_credentials_schema` 'DE:VAT' | 'NL:KVK' | 'NL:VAT' | 'BE:VAT' | 'BE:EN', required
  - `entity_id` string, uuid, required: ID of the entity
  - `is_receiver` boolean: Set to `true` if the entity needs to receive e-invoices.
  - `is_sender` boolean: Set to `true` if the entity needs to send e-invoices. Either `is_sender` or `is_receiver` or both must be `true`.
  - `legal_name` string, required: Legal name of the Entity
  - `provider_id` string: ID assigned by integration partner
  - `status` string, required: Current status of the integration

## Other responses

- `400`: Bad Request
- `401`: The `Authorization` header is missing or contains an invalid or expired access token. See [Authentication](https://docs.monite.com/api/concepts/authentication) to learn how to authenticate API calls.
- `403`: The specified access token does not have permissions to perform this operation.
- `409`: Business logic error
- `422`: Validation Error
- `429`: API rate limit has been exceeded. Check the response headers for the rate limit information.

---

[API](https://skmtc.dev/monite/apis/monite-2.md) - [All operations](https://skmtc.dev/monite/apis/monite-2/llms.txt) - [OpenAPI document](https://skmtc.dev/monite/apis/monite-2/revisions/4299ccf95edb?raw)