Skip to content
Invoro Docs

Create Contact

POST
/contacts

Create a new buyer contact. Requires the contact:create scope.

Authorizations

Section titled “Authorizations ”

Request Body required

Section titled “Request Body required ”
StoreBuyerContactRequest
object
name
required
string
<= 255 characters
legal_name
string | null
<= 255 characters
trading_name
string | null
<= 255 characters
vat_number
string | null
<= 50 characters
endpoint_id
object
scheme
string | null
<= 10 characters
value
string | null
<= 255 characters
company_id
object
scheme
string | null
<= 10 characters
value
string | null
<= 255 characters
tax_registration_id
object
scheme
string | null
<= 10 characters
value
string | null
<= 255 characters
address
object
street
string | null
<= 255 characters
street2
string | null
<= 255 characters
additional_line
string | null
<= 255 characters
city
string | null
<= 255 characters
subdivision
string | null
<= 255 characters
postal_code
string | null
<= 20 characters
country
string | null
>= 2 characters <= 2 characters
contact
object
name
string | null
<= 255 characters
phone
string | null
<= 50 characters
email
string | null format: email
<= 255 characters
identifiers
array | null
object
scheme
string | null
<= 10 characters
value
string | null
<= 255 characters

Responses

Section titled “ Responses ”

201

Section titled “201 ”

Contact created successfully.

object
data
required
BuyerContactResource
object
id
required

Unique contact identifier (UUID).

string
name
required

Display name of the buyer.

string
electronic_address
required

Buyer’s electronic address (e.g. Peppol ID like 0208:LU12345678).

string | null
electronic_address_scheme
required

Scheme identifier for the electronic address (e.g. 0208, 0088).

string | null
vat_number
required

Buyer’s VAT registration number.

string | null
buyer_data
required

Structured buyer data matching the UBL buyer schema.

object
name
required
legal_name
required
trading_name
required
endpoint_id
required

Buyer’s electronic address for Peppol delivery.

object
scheme
required

Scheme identifier (e.g. 0208, 0088, 9925).

string | null
value
required

Electronic address value (e.g. LU12345678).

string | null
identifiers
required
company_id
required

Company registration identifier.

object
scheme
required

Registration scheme (e.g. 0002 for SIREN).

string | null
value
required

Registration number.

string | null
vat_number
required
tax_registration_id
required

Tax registration identifier (for non-VAT tax schemes).

object
scheme
required

Tax scheme identifier.

string | null
value
required

Tax registration number.

string | null
address
required

Buyer’s postal address.

object
street
required

Street name and number.

string | null
street2
required

Additional street line.

string | null
additional_line
required

Third address line.

string | null
city
required

City or town name.

string | null
subdivision
required

State, province, or region.

string | null
postal_code
required

Postal or ZIP code.

string | null
country
required

ISO 3166-1 alpha-2 country code (e.g. LU, DE, FR).

string | null
contact
required

Buyer’s contact person details.

object
name
required

Contact person name.

string | null
phone
required

Contact phone number.

string | null
email
required

Contact email address.

string | null
created_at
required

ISO 8601 timestamp when the contact was created.

string
updated_at
required

ISO 8601 timestamp when the contact was last updated.

string

422

Section titled “422 ”

Validation error.

object
message
required

Errors overview.

string
errors
required

A detailed description of each field that failed validation.

object
key
additional properties
Array<string>