CommonCounterpart contacts

Create a counterpart contact

[Counterparts](https://docs.monite.com/common/counterparts/index) of the `organization` type can have additional contacts defined. Contacts are useful if you need to use different contact information for the same counterpart in different [invoices](https://docs.monite.com/accounts-receivable/invoices/index). The first contact you add to a counterpart becomes its default contact. The default contact, if it exists, is automatically selected when you create invoices and quotes for this counterpart, but the contact information can also be changed later on the document level. To select a different contact as the default one, use `POST /counterparts/{counterpart_id}/contacts/{contact_id}/make_default`.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

counterpart_idstringRequired
ID of a counterpart to add a contact for. This counterpart must be an organization, not an individual.

Headers

x-monite-versionstringRequired
x-monite-entity-idstringRequired
The ID of the entity that owns the requested resource.

Request

This endpoint expects an object.
addressobjectRequired
The address of a contact person.
first_namestringRequired<=100 characters
The first name of a contact person.
last_namestringRequired<=100 characters
The last name of a contact person.
emailstringOptionalformat: "email"
The email address of a contact person.
phonestringOptional<=100 characters
The phone number of a contact person
titlestringOptional<=100 characters

The title or honorific of a contact person. Examples: Mr., Ms., Dr., Prof.

Response

Successful Response
idstringformat: "uuid"
A unique ID assigned to this counterpart contact.
addressobject
The address of a contact person.
counterpart_idstringformat: "uuid"
ID of the counterpart to which this contact belongs.
first_namestring<=100 characters
The first name of a contact person.
is_defaultboolean

Indicates whether this contact is the default one. The default contact is used to fill in the counterpart’s contact details when you create invoices and quotes for this counterpart.

To select another contact as the default one, use POST /counterparts/{counterpart_id}/contacts/{contact_id}/make_default.

last_namestring<=100 characters
The last name of a contact person.
emailstringformat: "email"
The email address of a contact person.
phonestring<=100 characters
The phone number of a contact person
titlestring<=100 characters

The title or honorific of a contact person. Examples: Mr., Ms., Dr., Prof.

Errors

401
Post Counterparts ID Contacts Request Unauthorized Error
403
Post Counterparts ID Contacts Request Forbidden Error
404
Post Counterparts ID Contacts Request Not Found Error
409
Post Counterparts ID Contacts Request Conflict Error
422
Post Counterparts ID Contacts Request Unprocessable Entity Error
429
Post Counterparts ID Contacts Request Too Many Requests Error