Skip to main content
POST
/
counterparts
/
{counterpart_id}
/
contacts
Create a counterpart contact
curl --request POST \
  --url https://api.sandbox.monite.com/v1/counterparts/{counterpart_id}/contacts \
  --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>"
  },
  "first_name": "Mary",
  "last_name": "O'Brien",
  "email": "contact@example.org",
  "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

​
counterpart_id
string<uuid>
required

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

Body

application/json

The contact person for an organization.

​
address
object
required

The address of a contact person.

​
first_name
string
required

The first name of a contact person.

Example:

"Mary"

​
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."

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."