🔒 Create contact person V3

post

https://{xentralId}.xentral.biz/api/v3/suppliers/{supplierId}/contactPersons

This endpoint is currently in Beta and available for testing. It may contain bugs, and breaking changes can occur at any time without prior notice. We do not recommend using Beta endpoints in production environments. Should you choose to use it in production, you assume full responsibility for any resulting issues.

This endpoint requires the following scopes: supplier:create.

Create a new contact person for a supplier.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

supplierId

string

required

Body Params

type

string

enum

Type of contact person

Allowed:

name

string

required

length ≤ 255

Name of contact person

title

string

length ≤ 255

Title of contact person

salutation

string

length ≤ 500

Salutation of contact person

department

string

length ≤ 255

Department of contact person

subDepartment

string

length ≤ 255

Sub-Department of contact person

street

string

length ≤ 255

Street of contact person address

addressSupplement

string

length ≤ 255

Address supplement of contact person address

zipCode

string

length ≤ 20

Zip code of contact person address

city

string

length ≤ 255

City of contact person address

state

string

length ≤ 100

State of contact person address

country

string

length between 2 and 2

Country of contact person address (ISO-3166-1 alpha-2)

phone

string

length ≤ 50

Phone number of contact person

mobile

string

length ≤ 50

Mobile number of contact person

fax

string

length ≤ 50

Fax number of contact person

string

length ≤ 255

Email address of contact person

contactPersonDetails

object

Contact person details

groups

array of objects

Groups to assign contact person to

groups

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

401

Unauthorized

403

Forbidden

404

Not Found

Language

Credentials

Bearer

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

application/problem+json

201Create a new contact person for a supplier.

400Failed validation

429Too Many Requests