Integrations | PortSIP Knowledge Base

Retrieve global Microsoft 365 provisioning details

get

Retrieve details of global Microsoft 365 settings.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

OK

application/json

4XX

Error

get

/admin/ms365

GET /api/admin/ms365 HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "national_cloud": null,
  "directory_id": null,
  "application_id": null,
  "redirect_uri": null,
  "sbc_redirect_uri": null
}

Reprovision global Microsoft 365 integration.

post

Update global Microsoft 365 settings.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

national_cloudstring · enumOptional

The Microsoft cloud services are available in several separate national clouds.
These national cloud versions are physical and logical network-isolated instances of Microsoft enterprise cloud services
that are confined within the geographic borders of specific countries and operated by local personnel. Can be either:

GLOBAL: Azure global service.
CHINA: Azure China service.

Default: GLOBALPossible values:

directory_idstringOptional

The Directory ID (Tenant ID) of Microsoft identity platform.

application_idstringOptional

The Application (client) ID of Azure AD.

Responses

200

OK

4XX

Error

post

/admin/ms365

POST /api/admin/ms365 HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 65

{
  "national_cloud": null,
  "directory_id": null,
  "application_id": null
}

No content

Download global Microsoft 365 certificate

get

Download global Microsoft 365 certificate.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

OK

application/octet-stream

4XX

Error

get

/admin/ms365/certificate

GET /api/admin/ms365/certificate HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

binary

Generate new global Microsoft 365 certificate

post

Generate new global Microsoft 365 certificate.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

OK

application/octet-stream

4XX

Error

post

/admin/ms365/certificate

POST /api/admin/ms365/certificate HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

binary

Retrieve global Google integrations

get

Retrieve details of global Google integrations settings.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

OK

application/json

4XX

Error

get

/admin/google

GET /api/admin/google HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "client_id": null,
  "client_secret": null,
  "redirect_uri": null,
  "sbc_redirect_uri": null,
  "auth_consent_uri": null
}

Update global Google integration.

post

Update global Google integration settings.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

client_idstringOptional

The client ID of Google Cloud project.

client_secretstringOptional

The client secret of Google Cloud project.

Responses

200

OK

4XX

Error

post

/admin/google

POST /api/admin/google HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 39

{
  "client_id": null,
  "client_secret": null
}

No content

Retrieve tenant Microsoft 365 provisioning details

get

Retrieve details of tenant Microsoft 365 settings.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

OK

application/json

4XX

Error

get

/ms365

GET /api/ms365 HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "national_cloud": null,
  "directory_id": null,
  "application_id": null,
  "redirect_uri": null,
  "sbc_redirect_uri": null,
  "sync_time": null,
  "users": null,
  "sign_in_as_administrator": null,
  "sign_in_as_standard_user": null,
  "personal_contacts": null,
  "shared_mailbox": null,
  "events": null
}

Reprovision tenant Microsoft 365 integration.

post

Update tenant Microsoft 365 settings.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

national_cloudstring · enumOptional

The Microsoft cloud services are available in several separate national clouds.
These national cloud versions are physical and logical network-isolated instances of Microsoft enterprise cloud services
that are confined within the geographic borders of specific countries and operated by local personnel. Can be either:

GLOBAL: Azure global service.
CHINA: Azure China service.

Default: GLOBALPossible values:

directory_idstringOptional

The Directory ID (Tenant ID) of Microsoft identity platform.

application_idstringOptional

The Application (client) ID of Azure AD.

sync_timestringOptional

The crontab expression https://en.wikipedia.org/wiki/Cron

groupsstring[]Optional

A collection of Microsoft 365 groups to sync.

Responses

200

OK

4XX

Error

post

/ms365

POST /api/ms365 HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 220

{
  "national_cloud": null,
  "directory_id": null,
  "application_id": null,
  "sync_time": null,
  "users": null,
  "sign_in_as_administrator": null,
  "sign_in_as_standard_user": null,
  "personal_contacts": null,
  "shared_mailbox": null,
  "events": null
}

No content

Download Microsoft 365 certificate

get

Download Microsoft 365 certificate.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

OK

application/octet-stream

4XX

Error

get

/ms365/certificate

GET /api/ms365/certificate HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

binary

Generate new Microsoft 365 certificate

post

Generate new Microsoft 365 certificate.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

OK

application/octet-stream

4XX

Error

post

/ms365/certificate

POST /api/ms365/certificate HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

binary

Retrieve a collection of Microsoft 365 users

get

Retrieve a collection of Microsoft 365 users.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

OK

application/json

4XX

Error

get

/ms365/users

GET /api/ms365/users HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "count": 1,
  "items": [
    {
      "id": null,
      "name": null,
      "email": null
    }
  ]
}

List Microsoft 365 users by type

get

List users from Microsoft 365 by user type.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

typestring · enumRequiredPossible values:

Query parameters

topinteger · min: 1 · max: 100Optional

The maximum number of items to return

searchstringOptional

Search for users by name, email, or other fields

skiptokenstringOptional

Token for pagination

groupstringOptional

Group ID to filter users by group membership

Responses

200

OK

application/json

4XX

Error

get

/ms365/users/{type}

GET /api/ms365/users/{type} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "count": 1,
  "items": [
    {
      "id": null,
      "name": null,
      "email": null
    }
  ]
}

List MS365 groups

get

List all MS365 groups

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

$topinteger · min: 1 · max: 100Optional

Number of items to return per page

Default: 100

skiptokenstringOptional

Skip token for pagination

searchstringOptional

Search for groups by displayName or mail

Responses

200

OK

application/json

401

Unauthorized

403

Forbidden

500

Internal server error

get

/ms365/groups

GET /api/ms365/groups HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "count": 1,
  "items": [
    {
      "id": "text",
      "displayName": "text",
      "mail": "text"
    }
  ]
}

Bulk get MS365 groups

post

Bulk get MS365 groups by IDs

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

idsstring[]Optional

Responses

200

OK

application/json

400

Bad request

401

Unauthorized

403

Forbidden

500

Internal server error

post

/ms365/groups/get_many

POST /api/ms365/groups/get_many HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 16

{
  "ids": [
    "text"
  ]
}

{
  "count": 1,
  "items": [
    {
      "id": "text",
      "displayName": "text",
      "mail": "text"
    }
  ]
}

List Microsoft 365 group members

get

List members of a Microsoft 365 group.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

Query parameters

topinteger · min: 1 · max: 100Optional

The maximum number of items to return

searchstringOptional

Search for users by name, email, or other fields

skiptokenstringOptional

Token for pagination

Responses

200

OK

application/json

4XX

Error

get

/ms365/groups/{id}/members

GET /api/ms365/groups/{id}/members HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "count": 1,
  "items": [
    {
      "id": null,
      "name": null,
      "email": null
    }
  ]
}

Retrieve tenant Google integrations

get

Retrieve details of tenant Google integrations settings.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

OK

application/json

4XX

Error

get

/google

GET /api/google HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "client_id": null,
  "client_secret": null,
  "redirect_uri": null,
  "sbc_redirect_uri": null,
  "auth_consent_uri": null,
  "sync_time": "0 0 * * *",
  "users": {
    "enabled": false,
    "sync_photo": true,
    "starting_extension_number": "2000",
    "sync_type": "all",
    "selected_users": []
  },
  "sign_in_as_standard_user": {
    "enabled": false,
    "sync_type": "all",
    "selected_users": []
  },
  "directory_contacts": {
    "enabled": false,
    "sync_type": "all",
    "selected_users": []
  }
}

Update tenant Google integration.

post

Update tenant Google integration settings.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

client_idstringOptional

The client ID of Google Cloud project.

client_secretstringOptional

The client secret of Google Cloud project.

sync_timestringOptional

The time at which the synchronization should be performed, using cron syntax. Defaults to '0 0 * * *' (midnight every day).

Responses

200

OK

4XX

Error

post

/google

POST /api/google HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 391

{
  "client_id": null,
  "client_secret": null,
  "sync_time": "0 0 * * *",
  "users": {
    "enabled": true,
    "sync_photo": true,
    "starting_extension_number": "2000",
    "sync_type": "include",
    "selected_users": [
      "123456",
      "123456"
    ]
  },
  "sign_in_as_standard_user": {
    "enabled": true,
    "sync_type": "include",
    "selected_users": [
      "123456",
      "123456"
    ]
  },
  "directory_contacts": {
    "enabled": true,
    "sync_type": "include",
    "selected_users": [
      "123456"
    ]
  }
}

No content

List Google users

get

List users from Google Workspace.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

typestring · enumRequiredPossible values:

Query parameters

topinteger · min: 1 · max: 100Optional

The maximum number of items to return

searchstringOptional

Search for users by name, email, or other fields

skiptokenstringOptional

Token for pagination

Responses

200

OK

application/json

4XX

Error

get

/google/users/{type}

GET /api/google/users/{type} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Get Google user details

get

Get detailed information about a specific Google Workspace user.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

The user ID of the Google account.

Responses

200

OK

application/json

4XX

Error

get

/google/users/details/{id}

GET /api/google/users/details/{id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "123456789",
  "name": "John Doe",
  "email": "[email protected]",
  "principal_name": "[email protected]"
}

List Google directory contacts

get

List all Google directory contacts.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

OK

application/json

4XX

Error

get

/google/directory

GET /api/google/directory HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "id": "text",
    "name": "text",
    "email": "text",
    "principal_name": "text"
  }
]

Get Google directory contact details

get

Get details of a Google directory contact by ID.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

Contact ID

Responses

200

OK

application/json

4XX

Error

get

/google/directory/{id}

GET /api/google/directory/{id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "text",
  "name": "text",
  "email": "text",
  "principal_name": "text"
}

Bulk get Google directory contacts

post

Bulk get details of Google directory contacts by IDs.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

idsstring[] · min: 1 · max: 100Required

List of contact IDs

Responses

200

OK

application/json

4XX

Error

post

/google/directory/get_many

POST /api/google/directory/get_many HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 16

{
  "ids": [
    "text"
  ]
}

{
  "items": [
    {
      "id": "text",
      "name": "text",
      "email": "text",
      "principal_name": "text"
    }
  ]
}

Generate Google authorization URL

post

Generate Google authorization URL for tenant

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

client_idstringRequired

Google client ID

client_secretstringRequired

Google client secret

callback_urlstringOptional

Callback URL after authorization

Responses

200

OK

application/json

400

Bad request

401

Unauthorized

403

Forbidden

409

Client ID already exists

500

Internal server error

post

/google/authorization

POST /api/google/authorization HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 65

{
  "client_id": "text",
  "client_secret": "text",
  "callback_url": "text"
}

{
  "auth_consent_uri": "text"
}

Get CRM integration

get

Retrieve details of tenant CRM integration configurations.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

OK

application/json

4XX

Error

get

/crm

GET /api/crm HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "provider": "zoho",
  "opts": {
    "client_id": "xxxxxxxxxxxxxxxxxxxxxxxxxx",
    "client_secret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "region": "United States",
    "enable_create_contact": true,
    "contact_created_as": "Contact",
    "contact_lookup_order": [
      "Contacts",
      "Leads",
      "Accounts"
    ],
    "contact_lookup_condition": "Always",
    "enable_call_logging": true,
    "enable_call_recording_logging": true,
    "secure_call_recording_logging": true,
    "redirect_url": "https://example.com/callback/zoho",
    "sbc_redirect_url": "https://example.com/callback/zoho",
    "refresh_token": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
  }
}

Update CRM integration

post

Update tenant CRM integration configurations.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

providerstringRequired

The CRM provider.
Such as zoho, hubspot.

optsone ofRequired

or

Responses

200

OK

4XX

Error

post

/crm

POST /api/crm HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 399

{
  "provider": "zoho",
  "opts": {
    "client_id": "xxxxxxxxxxxxxxxxxxxxxxxxxx",
    "client_secret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "region": "United States",
    "enable_create_contact": true,
    "contact_created_as": "Contact",
    "contact_lookup_order": [
      "Contacts",
      "Leads",
      "Accounts"
    ],
    "contact_lookup_condition": "Always",
    "enable_call_logging": true,
    "enable_call_recording_logging": true,
    "secure_call_recording_logging": true
  }
}

No content

List available providers

get

Retrieve all of available providers.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

OK

application/json

4XX

Error

get

/crm/providers

GET /api/crm/providers HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "items": [
    {
      "provider": "zoho",
      "redirect_url": "https://example.com/callback/zoho",
      "sbc_redirect_url": "https://example.com/callback/zoho"
    },
    {
      "provider": "hubspot",
      "redirect_url": "https://example.com/callback/hubspot",
      "sbc_redirect_url": "https://example.com/callback/hubspot"
    },
    {
      "provider": "odoo"
    }
  ]
}

Test integration

post

Try to search contacts in CRM integration.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

numberstring · max: 128Required

The business phone number of contact.

Responses

200

OK

application/json

4XX

Error

post

/crm/test

POST /api/crm/test HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 25

{
  "number": "666-666-6666"
}

{
  "items": [
    {
      "id": null,
      "first_name": null,
      "last_name": null,
      "email": null,
      "company": null,
      "title": null,
      "did_number": null,
      "business": null,
      "business2": null,
      "mobile_phone": null,
      "mobile_phone2": null,
      "home_phone": null,
      "home_phone2": null,
      "other": null,
      "business_fax": null,
      "home_fax": null,
      "address": null,
      "notes": null,
      "type": null,
      "url": null
    }
  ]
}

List contacts

get

Retrieve a collection of CRM contacts.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

filterstringOptional

Use the filter query parameter to retrieve just a subset of a collection.

searchstringOptional

Use the search query parameter to restrict the results of a request to match a search criterion.

orderbystringOptional

Use the orderby query parameter to specify the sort order of the items returned from server.
The default order is ascending order.

skipinteger · int32Optional

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

Default: 0

topinteger · int32 · min: 1 · max: 100Optional

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

Default: 100

Responses

200

OK

application/json

4XX

Error

get

/crm/contacts

GET /api/crm/contacts HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "count": 1,
  "items": [
    {
      "id": null,
      "first_name": null,
      "last_name": null,
      "email": null,
      "company": null,
      "title": null,
      "did_number": null,
      "business": null,
      "business2": null,
      "mobile_phone": null,
      "mobile_phone2": null,
      "home_phone": null,
      "home_phone2": null,
      "other": null,
      "business_fax": null,
      "home_fax": null,
      "address": null,
      "notes": null,
      "type": null,
      "url": null
    }
  ]
}

Create a contact

post

Create a contact into specified CRM integration.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

first_namestring · min: 1 · max: 64Optional

The first name of contact.

last_namestring · min: 1 · max: 64Required

The last 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.

did_numberstringRequired

The DID/DDI number.

Responses

201

Created

application/json

idstringOptional

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

4XX

Error

post

/crm/contacts

POST /api/crm/contacts HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 286

{
  "first_name": null,
  "last_name": null,
  "email": null,
  "company": null,
  "title": null,
  "business": null,
  "business2": null,
  "mobile_phone": null,
  "mobile_phone2": null,
  "home_phone": null,
  "home_phone2": null,
  "other": null,
  "business_fax": null,
  "home_fax": null,
  "address": null,
  "notes": null,
  "did": "111-222-3333"
}

{
  "id": "xxxxxxxx"
}

Search contacts

post

Search CRM contacts with specified conditions in CRM integration.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

numberstring · max: 128Required

The business phone number of contact.

Responses

200

OK

application/json

4XX

Error

post

/crm/contacts/search

POST /api/crm/contacts/search HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 25

{
  "number": "666-666-6666"
}

{
  "items": [
    {
      "id": null,
      "first_name": null,
      "last_name": null,
      "email": null,
      "company": null,
      "title": null,
      "did_number": null,
      "business": null,
      "business2": null,
      "mobile_phone": null,
      "mobile_phone2": null,
      "home_phone": null,
      "home_phone2": null,
      "other": null,
      "business_fax": null,
      "home_fax": null,
      "address": null,
      "notes": null,
      "type": null,
      "url": null
    }
  ]
}

Get a CRM contact

get

Retrieve CRM contact details by it's ID.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

application/json

4XX

Error

get

/crm/contacts/{id}

GET /api/crm/contacts/{id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": null,
  "first_name": null,
  "last_name": null,
  "email": null,
  "company": null,
  "title": null,
  "did_number": null,
  "business": null,
  "business2": null,
  "mobile_phone": null,
  "mobile_phone2": null,
  "home_phone": null,
  "home_phone2": null,
  "other": null,
  "business_fax": null,
  "home_fax": null,
  "address": null,
  "notes": null,
  "type": null,
  "url": null
}

Update a CRM contact

post

Update a CRM contact.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Body

first_namestring · min: 1 · max: 64Optional

The first name of contact.

last_namestring · min: 1 · max: 64Optional

The last 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.

did_numberstringOptional

The DID/DDI number.

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

200

OK

4XX

Error

post

/crm/contacts/{id}

POST /api/crm/contacts/{id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 283

{
  "first_name": null,
  "last_name": null,
  "email": null,
  "company": null,
  "title": null,
  "did_number": null,
  "business": null,
  "business2": null,
  "mobile_phone": null,
  "mobile_phone2": null,
  "home_phone": null,
  "home_phone2": null,
  "other": null,
  "business_fax": null,
  "home_fax": null,
  "address": null,
  "notes": null
}

No content

Delete a CRM contact

post

Remove CRM contact by it's ID.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

202

No Content

4XX

Error

post

/crm/contacts/{id}/destroy

POST /api/crm/contacts/{id}/destroy HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

List contact notes

get

List a collection of CRM contact notes.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

application/json

4XX

Error

get

/crm/contacts/{id}/notes

GET /api/crm/contacts/{id}/notes HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "items": [
    {
      "id": "",
      "title": "",
      "content": "",
      "created_at": "",
      "updated_at": ""
    },
    {
      "id": "",
      "title": "",
      "content": "",
      "created_at": "",
      "updated_at": ""
    }
  ]
}

Create CRM contact note

post

Create CRM contact note.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Body

titlestringOptional

The title of CRM record note.

contentstringOptional

The content of CRM record note.

Responses

200

OK

application/json

4XX

Error

post

/crm/contacts/{id}/notes

POST /api/crm/contacts/{id}/notes HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 25

{
  "title": "",
  "content": ""
}

{
  "id": "xxxxxxxx"
}

Get contact note

get

Get CRM contact note.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

note_idstringRequired

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

application/json

4XX

Error

get

/crm/contacts/{id}/notes/{note_id}

GET /api/crm/contacts/{id}/notes/{note_id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "",
  "title": "",
  "content": "",
  "created_at": "",
  "updated_at": ""
}

Update CRM contact note

post

Update CRM contact note.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

note_idstringRequired

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Body

titlestringOptional

The title of CRM record note.

contentstringOptional

The content of CRM record note.

Responses

200

OK

4XX

Error

post

/crm/contacts/{id}/notes/{note_id}

POST /api/crm/contacts/{id}/notes/{note_id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 25

{
  "title": "",
  "content": ""
}

No content

Delete CRM contact note

post

Delete CRM contact note.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

note_idstringRequired

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

204

OK

4XX

Error

post

/crm/contacts/{id}/notes/{note_id}/destroy

POST /api/crm/contacts/{id}/notes/{note_id}/destroy HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

List calls

get

List calls from CRM integration.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Query parameters

filterstringOptional

Use the filter query parameter to retrieve just a subset of a collection.

searchstringOptional

Use the search query parameter to restrict the results of a request to match a search criterion.

orderbystringOptional

Use the orderby query parameter to specify the sort order of the items returned from server.
The default order is ascending order.

skipinteger · int32Optional

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

Default: 0

topinteger · int32 · min: 1 · max: 100Optional

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

Default: 100

countbooleanOptional

Use the $count=true query option to include a count of entities that match the filter criteria.

Default: false

Responses

200

OK

application/json

4XX

Error

get

/crm/contacts/{id}/calls

GET /api/crm/contacts/{id}/calls HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "count": 1,
  "items": [
    {
      "id": null,
      "caller": null,
      "caller_display_name": null,
      "callee": null,
      "callee_display_name": null,
      "started_at": null,
      "rang_at": null,
      "answered_at": null,
      "ended_at": null,
      "direction": null,
      "duration": null,
      "summary": null,
      "transcription": null,
      "recording": null
    }
  ]
}

Get call

get

Get call from CRM integration.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

call_idstringRequired

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

application/json

4XX

Error

get

/crm/contacts/{id}/calls/{call_id}

GET /api/crm/contacts/{id}/calls/{call_id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": null,
  "session_id": null,
  "caller": null,
  "caller_display_name": null,
  "callee": null,
  "callee_display_name": null,
  "started_at": null,
  "rang_at": null,
  "answered_at": null,
  "ended_at": null,
  "direction": null,
  "duration": null,
  "summary": null,
  "transcription": null,
  "recording": null
}

Update call

post

Update CRM call summary.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

call_idstringRequired

The unique ID of the resource.

Example: NzAwNTUxOTA5NzczMTQ4MTYw

Body

summarystringRequired

The summary of CRM call.

Responses

200

OK

4XX

Error

post

/crm/contacts/{id}/calls/{call_id}

POST /api/crm/contacts/{id}/calls/{call_id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 16

{
  "summary": null
}

No content

hashtagRetrieve global Microsoft 365 provisioning details

hashtagReprovision global Microsoft 365 integration.

hashtagDownload global Microsoft 365 certificate

hashtagGenerate new global Microsoft 365 certificate

hashtagRetrieve global Google integrations

hashtagUpdate global Google integration.

hashtagRetrieve tenant Microsoft 365 provisioning details

hashtagReprovision tenant Microsoft 365 integration.

hashtagDownload Microsoft 365 certificate

hashtagGenerate new Microsoft 365 certificate

hashtagRetrieve a collection of Microsoft 365 users

hashtagList Microsoft 365 users by type

hashtagList MS365 groups

hashtagBulk get MS365 groups

hashtagList Microsoft 365 group members

hashtagRetrieve tenant Google integrations

hashtagUpdate tenant Google integration.

hashtagList Google users

hashtagGet Google user details

hashtagList Google directory contacts

hashtagGet Google directory contact details

hashtagBulk get Google directory contacts

hashtagGenerate Google authorization URL

hashtagGet CRM integration

hashtagUpdate CRM integration

hashtagList available providers

hashtagTest integration

hashtagList contacts

hashtagCreate a contact

hashtagSearch contacts

hashtagGet a CRM contact

hashtagUpdate a CRM contact

hashtagDelete a CRM contact

hashtagList contact notes

hashtagCreate CRM contact note

hashtagGet contact note

hashtagUpdate CRM contact note

hashtagDelete CRM contact note

hashtagList calls

hashtagGet call

hashtagUpdate call

Retrieve global Microsoft 365 provisioning details

Reprovision global Microsoft 365 integration.

Download global Microsoft 365 certificate

Generate new global Microsoft 365 certificate

Retrieve global Google integrations

Update global Google integration.

Retrieve tenant Microsoft 365 provisioning details

Reprovision tenant Microsoft 365 integration.

Download Microsoft 365 certificate

Generate new Microsoft 365 certificate

Retrieve a collection of Microsoft 365 users

List Microsoft 365 users by type

List MS365 groups

Bulk get MS365 groups

List Microsoft 365 group members

Retrieve tenant Google integrations

Update tenant Google integration.

List Google users

Get Google user details

List Google directory contacts

Get Google directory contact details

Bulk get Google directory contacts

Generate Google authorization URL

Get CRM integration

Update CRM integration

List available providers

Test integration

List contacts

Create a contact

Search contacts

Get a CRM contact

Update a CRM contact

Delete a CRM contact

List contact notes

Create CRM contact note

Get contact note

Update CRM contact note

Delete CRM contact note

List calls

Get call

Update call