Contacts

List personal contact

get

Retrieve a collection of personal contacts.

Authorizations

Query parameters

skipinteger · int32 · default: 0optional

Use the skip query parameter to set the number of items to skip at the start of a collection.

topinteger · int32 · min: 1 · max: 100 · default: 100optional

Use the top query parameter to specify the page size of the result set.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://HOSTNAME:8887/api/user/contacts' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

200

4XX

200

{
  "count": 100,
  "items": [
    {
      "id": "NzAwNTUxOTA5NzczMTQ4MTYw",
      "name": "text",
      "email": "text",
      "company": "text",
      "title": "text",
      "business": "text",
      "business2": "text",
      "mobile_phone": "text",
      "mobile_phone2": "text",
      "home_phone": "text",
      "home_phone2": "text",
      "other": "text",
      "business_fax": "text",
      "home_fax": "text",
      "address": "text",
      "notes": "text",
      "sync_type": "Microsoft 365",
      "favorite": true
    }
  ]
}

OK

Add a new personal contact

post

Authorizations

Body

namestring · min: 1 · max: 64optional

The name of contact.

emailstring · max: 128optional

The email of contact.

companystring · max: 128optional

The company name of contact.

titlestring · max: 128optional

The title of contact.

businessstring · max: 128optional

The business phone number of contact.

business2string · max: 128optional

The secondary business phone number of contact.

mobile_phonestring · max: 128optional

The mobile phone number of contact.

mobile_phone2string · max: 128optional

The secondary mobile phone number of contact.

home_phonestring · max: 128optional

The home phone number of contact.

home_phone2string · max: 128optional

The secondary home phone number of contact.

otherstring · max: 128optional

The other phone number of contact.

business_faxstring · max: 128optional

The business fax of contact.

home_faxstring · max: 128optional

The home fax of contact.

addressstring · max: 128optional

The address.

notesstring · max: 1024optional

The notes of contact.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://HOSTNAME:8887/api/user/contacts' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "text",
    "email": "text",
    "company": "text",
    "title": "text",
    "business": "text",
    "business2": "text",
    "mobile_phone": "text",
    "mobile_phone2": "text",
    "home_phone": "text",
    "home_phone2": "text",
    "other": "text",
    "business_fax": "text",
    "home_fax": "text",
    "address": "text",
    "notes": "text"
  }'

201

4XX

201

{
  "id": "NzAwNTUxOTA5NzczMTQ4MTYw"
}

Created contact

Retrieve personal contact details

get

Retrieves details of a personal contact.

Authorizations

Path parameters

idall ofrequired

The unique ID of contact.

The unique ID of the resource.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://HOSTNAME:8887/api/user/contacts/{id}' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

200

4XX

200

{
  "id": "NzAwNTUxOTA5NzczMTQ4MTYw",
  "name": "text",
  "email": "text",
  "company": "text",
  "title": "text",
  "business": "text",
  "business2": "text",
  "mobile_phone": "text",
  "mobile_phone2": "text",
  "home_phone": "text",
  "home_phone2": "text",
  "other": "text",
  "business_fax": "text",
  "home_fax": "text",
  "address": "text",
  "notes": "text",
  "sync_type": "Microsoft 365",
  "favorite": true
}

OK

Update a personal contact

post

Update a personal contact.

Authorizations

Path parameters

idall ofrequired

The unique ID of contact.

The unique ID of the resource.

Body

namestring · min: 1 · max: 64optional

The name of contact.

emailstring · max: 128optional

The email of contact.

companystring · max: 128optional

The company name of contact.

titlestring · max: 128optional

The title of contact.

businessstring · max: 128optional

The business phone number of contact.

business2string · max: 128optional

The secondary business phone number of contact.

mobile_phonestring · max: 128optional

The mobile phone number of contact.

mobile_phone2string · max: 128optional

The secondary mobile phone number of contact.

home_phonestring · max: 128optional

The home phone number of contact.

home_phone2string · max: 128optional

The secondary home phone number of contact.

otherstring · max: 128optional

The other phone number of contact.

business_faxstring · max: 128optional

The business fax of contact.

home_faxstring · max: 128optional

The home fax of contact.

addressstring · max: 128optional

The address.

notesstring · max: 1024optional

The notes of contact.

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://HOSTNAME:8887/api/user/contacts/{id}' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "text",
    "email": "text",
    "company": "text",
    "title": "text",
    "business": "text",
    "business2": "text",
    "mobile_phone": "text",
    "mobile_phone2": "text",
    "home_phone": "text",
    "home_phone2": "text",
    "other": "text",
    "business_fax": "text",
    "home_fax": "text",
    "address": "text",
    "notes": "text"
  }'

200

4XX

200

No body

OK