Skip to main content
PATCH
/
counterparts
/
{counterpart_id}
/
contacts
/
{contact_id}
Update a counterpart's contact
curl --request PATCH \
  --url https://api.sandbox.monite.com/v1/counterparts/{counterpart_id}/contacts/{contact_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-monite-entity-id: <x-monite-entity-id>' \
  --header 'x-monite-version: <x-monite-version>' \
  --data @- <<EOF
{
  "address": {
    "city": "Berlin",
    "country": "DE",
    "line1": "Flughafenstrasse 52",
    "postal_code": "10115",
    "line2": "<string>",
    "state": "<string>"
  },
  "email": "contact@example.org",
  "first_name": "Mary",
  "last_name": "O'Brien",
  "phone": "5551235476",
  "title": "Ms."
}
EOF
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "address": {
    "city": "Berlin",
    "country": "DE",
    "line1": "Flughafenstrasse 52",
    "postal_code": "10115",
    "line2": "<string>",
    "state": "<string>"
  },
  "counterpart_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "first_name": "Mary",
  "is_default": true,
  "last_name": "O'Brien",
  "email": "contact@example.org",
  "phone": "5551235476",
  "title": "Ms."
}

Authorizations

​
Authorization
string
header
required

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

Headers

​
x-monite-version
string<date>
required
​
x-monite-entity-id
string<uuid>
required

The ID of the entity that owns the requested resource.

Example:

"9d2b4c8f-2087-4738-ba91-7359683c49a4"

Path Parameters

​
contact_id
string<uuid>
required

ID of the contact you want to update.

​
counterpart_id
string<uuid>
required

ID of a counterpart whose contact you want to update. Only organization-type counterparts can have contacts.

Body

application/json

The contact person for an organization.

​
address
object

The address of a contact person.

​
email
string<email>

The email address of a contact person.

Example:

"contact@example.org"

​
first_name
string

The first name of a contact person.

Example:

"Mary"

​
last_name
string

The last name of a contact person.

Example:

"O'Brien"

​
phone
string

The phone number of a contact person

Example:

"5551235476"

​
title
string

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

Example:

"Ms."

Response

Successful Response

The contact person for an organization.

​
id
string<uuid>
required

A unique ID assigned to this counterpart contact.

​
address
object
required

The address of a contact person.

​
counterpart_id
string<uuid>
required

ID of the counterpart to which this contact belongs.

​
first_name
string
required

The first name of a contact person.

Example:

"Mary"

​
is_default
boolean
required

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_name
string
required

The last name of a contact person.

Example:

"O'Brien"

​
email
string<email>

The email address of a contact person.

Example:

"contact@example.org"

​
phone
string

The phone number of a contact person

Example:

"5551235476"

​
title
string

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

Example:

"Ms."