CRM Items on ~.UcClient.~ Unified Communications

Get CRM Item

Mon, 01 Jan 0001 00:00:00 +0000

Get CRM Item #

Gets any directory items matching the supplied filter.

GET /v1.0/contactdirectories/{DIRECTORY_ID}/crmitems/{CRM_ID}

Example #

This request will get specific items from the directory using the crmId.

Request #

GET <https://api.na.myreports.cloud/api/v1.0/contactdirectories/00000000-0000-0000-0000-000000000000/crmitems/00000000-0000-0000-0000-000000000001> HTTP/1.1
Authorisation: Bearer {TOKEN}

Response #

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Content-Length: xx
{
    "page_size": 1,
	"data":  [{
            "id": "00000000-0000-0000-0000-000000000123",
            "fields": {
                "title": "Mr",
                "fullName": "CRM2",
                "companyName": "Company",
                "jobTitle": "Job Title",
                "phone1": "+44XXXXXXXXXX",
                "email": "Email Address",
                "field1": "field1",
                "field2": "field2",
                "crmId": "00000000-0000-0000-0000-000000000001"
            }
        }
    ][{
            "id": "00000000-0000-0000-0000-000000000123",
            "fields": {
                "title": "Mr",
                "fullName": "CRM2",
                "companyName": "Company",
                "jobTitle": "Job Title",
                "phone1": "+44XXXXXXXXXX",
                "email": "Email Address",
                "field1": "field1",
                "field2": "field2",
                "crmId": "00000000-0000-0000-0000-000000000001"
            }
        }
    ],
	"status": "success",
	"timestamp": "2019-01-01T10:00:00.2890319Z"
}

Errors #

Unauthorised #

When the token is not provided, invalid or expired

HTTP/1.1 401 Unauthorised

Create CRM Item

Mon, 01 Jan 0001 00:00:00 +0000

Create CRM Item #

Creates a new directory item in the supplied directory.

POST /v1.0/contactdirectories/{DIRECTORY_ID}/crmitems

Example #

This request will create a new directory item.

Request #

POST <https://api.na.myreports.cloud/api/v1.0/contactdirectories/00000000-0000-0000-0000-000000000000/crmitems> HTTP/1.1
Content-Type: application/json
accept-charges: true
Authorisation: Bearer {TOKEN}
Connection: keep-alive
{
    "fields": {
        "title": "Mr",
        "fullName": "CRM3a",
        "companyName": "Company",
        "jobTitle": "Job Title",
        "phone1": "+44XXXXXXXXXX",
        "email": "Email Address",
        "field1": "field1",
        "field2": "field2",
        "crmId": "00000000-0000-0000-0000-000000000001"
    }
}

Response #

HTTP/1.1 201 Created
Content-Type: application/json; charset=utf-8
Content-Length: xx
Location: <https://api.na.myreports.cloud/api/v1.0/contactdirectories/00000000-0000-0000-0000-000000000000/crmitems>
{
	 "data": {
        "id": "00000000-0000-0000-0000-000000000123",
        "fields": {
            "title": "Mr",
            "fullName": "CRM3a",
            "companyName": "Company",
            "jobTitle": "Job Title",
            "phone1": "+44XXXXXXXXXX",
            "email": "Email Address",
            "field1": "field1",
            "field2": "field2",
            "crmId": "00000000-0000-0000-0000-000000000001"
        }
    },
	"status": "success",
	"timestamp": "2019-11-29T16:03:23.9251680Z"
}

Errors #

Unauthorised #

When the token is not provided, invalid or expired

HTTP/1.1 401 Unauthorised

Delete CRM Item

Mon, 01 Jan 0001 00:00:00 +0000

Delete CRM Item #

Deletes an existing item from a directory.

Request #

DELETE /v1.0/contactdirectories/{DIRECTORY_ID}/crmitems/{CRM_ID}

Example #

This request will delete the specific item within the directory.

Request #

DELETE <https://api.na.myreports.cloud/api/v1.0/contactdirectories/00000000-0000-0000-0000-000000000000/crmitems/00000000-0000-0000-0000-000000000001> HTTP/1.1
Authorisation: Bearer {TOKEN}

Response #

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Content-Length: xx
{ 
	"data": {
        "id": "00000000-0000-0000-0000-000000000123",
        "fields": {
            "title": "Mr",
            "fullName": "CRM3a",
            "companyName": "Company",
            "jobTitle": "Job Title",
            "phone1": "+44XXXXXXXXXX",
            "email": "Email Address",
            "field1": "field1",
            "field2": "field2",
            "crmId": "00000000-0000-0000-0000-000000000001"
        }
    },
	"status": "success",
	"timestamp": "2019-01-01T10:00:00.2890319Z"
}

Errors #

Unauthorised #

When the token is not provided, invalid or expired

HTTP/1.1 401 Unauthorised