{ "info": { "_postman_id": "85611f30-cebd-4a2a-ad7e-1724236b2982", "name": "RingCentral Adaptive Cards External Contacts API", "description": "RingCentral API specification\n\nContact Support:\n Name: RingCentral Developers Support", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "createdAt": "2026-07-28T02:49:24.000Z", "updatedAt": "2026-07-28T02:49:24.000Z", "lastUpdatedBy": "35240", "uid": "35240-85611f30-cebd-4a2a-ad7e-1724236b2982" }, "item": [ { "name": "restapi", "item": [ { "name": "v1.0", "item": [ { "name": "account", "item": [ { "name": "{accountId}", "item": [ { "name": "address-book-bulk-upload", "item": [ { "name": "tasks", "item": [ { "name": "{taskId}", "item": [ { "name": "Get Contacts Upload Task", "id": "9b047e44-ff45-4b60-8518-160ea8aa6a74", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/restapi/v1.0/account/:accountId/address-book-bulk-upload/tasks/:taskId", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v1.0", "account", ":accountId", "address-book-bulk-upload", "tasks", ":taskId" ], "variable": [ { "id": "a61cbe21-4851-443d-9a86-b3d26cc2b3d9", "key": "accountId", "value": "~", "description": "(Required) Internal identifier of the RingCentral account\n(can be set to \"~\" to indicate that the account associated with current authorization session should be used)\n" }, { "id": "6aec27ad-5c4f-4f33-bc67-c602328a2786", "key": "taskId", "value": "", "description": "(Required) Internal identifier of a task" } ] }, "description": "Returns the status of a task on adding multiple contacts to multiple extensions.\n" }, "response": [ { "id": "1c760fb1-5d42-4295-84c0-e7b114eea843", "name": "Contacts upload task", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/restapi/v1.0/account/:accountId/address-book-bulk-upload/tasks/:taskId", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v1.0", "account", ":accountId", "address-book-bulk-upload", "tasks", ":taskId" ], "variable": [ { "key": "accountId" }, { "key": "taskId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"uri\": \"\",\n \"creationTime\": \"\",\n \"lastModifiedTime\": \"\",\n \"status\": \"Accepted\",\n \"results\": {\n \"affectedItems\": [\n {\n \"extensionId\": \"\",\n \"contacts\": [\n {\n \"email\": \"\",\n \"notes\": \"\",\n \"company\": \"\",\n \"firstName\": \"\",\n \"lastName\": \"\",\n \"jobTitle\": \"\",\n \"birthday\": \"\",\n \"webPage\": \"\",\n \"middleName\": \"\",\n \"nickName\": \"\",\n \"email2\": \"\",\n \"email3\": \"\",\n \"homePhone\": \"\",\n \"homePhone2\": \"\",\n \"businessPhone\": \"\",\n \"businessPhone2\": \"\",\n \"mobilePhone\": \"\",\n \"businessFax\": \"\",\n \"companyPhone\": \"\",\n \"assistantPhone\": \"\",\n \"carPhone\": \"\",\n \"otherPhone\": \"\",\n \"otherFax\": \"\",\n \"callbackPhone\": \"\",\n \"businessAddress\": {\n \"country\": \"\",\n \"state\": \"\",\n \"city\": \"\",\n \"street\": \"\",\n \"zip\": \"\"\n },\n \"homeAddress\": {\n \"country\": \"\",\n \"state\": \"\",\n \"city\": \"\",\n \"street\": \"\",\n \"zip\": \"\"\n },\n \"otherAddress\": {\n \"country\": \"\",\n \"state\": \"\",\n \"city\": \"\",\n \"street\": \"\",\n \"zip\": \"\"\n }\n }\n ]\n },\n {\n \"extensionId\": \"\",\n \"contacts\": [\n {\n \"email\": \"\",\n \"notes\": \"\",\n \"company\": \"\",\n \"firstName\": \"\",\n \"lastName\": \"\",\n \"jobTitle\": \"\",\n \"birthday\": \"\",\n \"webPage\": \"\",\n \"middleName\": \"\",\n \"nickName\": \"\",\n \"email2\": \"\",\n \"email3\": \"\",\n \"homePhone\": \"\",\n \"homePhone2\": \"\",\n \"businessPhone\": \"\",\n \"businessPhone2\": \"\",\n \"mobilePhone\": \"\",\n \"businessFax\": \"\",\n \"companyPhone\": \"\",\n \"assistantPhone\": \"\",\n \"carPhone\": \"\",\n \"otherPhone\": \"\",\n \"otherFax\": \"\",\n \"callbackPhone\": \"\",\n \"businessAddress\": {\n \"country\": \"\",\n \"state\": \"\",\n \"city\": \"\",\n \"street\": \"\",\n \"zip\": \"\"\n },\n \"homeAddress\": {\n \"country\": \"\",\n \"state\": \"\",\n \"city\": \"\",\n \"street\": \"\",\n \"zip\": \"\"\n },\n \"otherAddress\": {\n \"country\": \"\",\n \"state\": \"\",\n \"city\": \"\",\n \"street\": \"\",\n \"zip\": \"\"\n }\n }\n ]\n }\n ],\n \"errors\": [\n {\n \"errorCode\": \"\",\n \"message\": \"\",\n \"parameterName\": \"\",\n \"parameterValue\": \"\"\n },\n {\n \"errorCode\": \"\",\n \"message\": \"\",\n \"parameterName\": \"\",\n \"parameterValue\": \"\"\n }\n ]\n }\n}", "createdAt": "2026-07-28T02:49:25.000Z", "updatedAt": "2026-07-28T02:49:25.000Z", "uid": "35240-1c760fb1-5d42-4295-84c0-e7b114eea843" } ], "createdAt": "2026-07-28T02:49:25.000Z", "updatedAt": "2026-07-28T02:49:25.000Z", "uid": "35240-9b047e44-ff45-4b60-8518-160ea8aa6a74" } ], "id": "060c3f16-874f-48d8-a43d-d9aa593484e3", "createdAt": "2026-07-28T02:49:24.000Z", "updatedAt": "2026-07-28T02:49:24.000Z", "uid": "35240-060c3f16-874f-48d8-a43d-d9aa593484e3" } ], "id": "de8deb4e-fc0d-4a2e-856b-e48526b60261", "createdAt": "2026-07-28T02:49:24.000Z", "updatedAt": "2026-07-28T02:49:24.000Z", "uid": "35240-de8deb4e-fc0d-4a2e-856b-e48526b60261" }, { "name": "Upload Multiple User Contacts", "id": "c9ddb5b8-583f-4c4d-9da8-3ad979dc4ab0", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"records\": [\n {\n \"extensionId\": \"\",\n \"contacts\": [\n {\n \"email\": \"\",\n \"notes\": \"\",\n \"company\": \"\",\n \"firstName\": \"\",\n \"lastName\": \"\",\n \"jobTitle\": \"\",\n \"birthday\": \"\",\n \"webPage\": \"\",\n \"middleName\": \"\",\n \"nickName\": \"\",\n \"email2\": \"\",\n \"email3\": \"\",\n \"homePhone\": \"\",\n \"homePhone2\": \"\",\n \"businessPhone\": \"\",\n \"businessPhone2\": \"\",\n \"mobilePhone\": \"\",\n \"businessFax\": \"\",\n \"companyPhone\": \"\",\n \"assistantPhone\": \"\",\n \"carPhone\": \"\",\n \"otherPhone\": \"\",\n \"otherFax\": \"\",\n \"callbackPhone\": \"\",\n \"businessAddress\": {\n \"country\": \"\",\n \"state\": \"\",\n \"city\": \"\",\n \"street\": \"\",\n \"zip\": \"\"\n },\n \"homeAddress\": {\n \"country\": \"\",\n \"state\": \"\",\n \"city\": \"\",\n \"street\": \"\",\n \"zip\": \"\"\n },\n \"otherAddress\": {\n \"country\": \"\",\n \"state\": \"\",\n \"city\": \"\",\n \"street\": \"\",\n \"zip\": \"\"\n }\n }\n ]\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/restapi/v1.0/account/:accountId/address-book-bulk-upload", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v1.0", "account", ":accountId", "address-book-bulk-upload" ], "variable": [ { "id": "b1063c56-7c7b-4ea7-9b7b-fef2eb5fee66", "key": "accountId", "value": "~", "description": "(Required) Internal identifier of the RingCentral account\n(can be set to \"~\" to indicate that the account associated with current authorization session should be used)\n" } ] }, "description": "Uploads multiple contacts for multiple extensions at once.\nMaximum 500 extensions can be uploaded per request. Max amount\nof contacts that can be uploaded per extension is 10,000.\nEach contact uploaded for a certain extension is not visible\nto other extensions.\n" }, "response": [ { "id": "4f9b0ada-273d-43ac-90e3-c6812a2b2c80", "name": "Accepted", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"records\": [\n {\n \"extensionId\": \"\",\n \"contacts\": [\n {\n \"email\": \"\",\n \"notes\": \"\",\n \"company\": \"\",\n \"firstName\": \"\",\n \"lastName\": \"\",\n \"jobTitle\": \"\",\n \"birthday\": \"\",\n \"webPage\": \"\",\n \"middleName\": \"\",\n \"nickName\": \"\",\n \"email2\": \"\",\n \"email3\": \"\",\n \"homePhone\": \"\",\n \"homePhone2\": \"\",\n \"businessPhone\": \"\",\n \"businessPhone2\": \"\",\n \"mobilePhone\": \"\",\n \"businessFax\": \"\",\n \"companyPhone\": \"\",\n \"assistantPhone\": \"\",\n \"carPhone\": \"\",\n \"otherPhone\": \"\",\n \"otherFax\": \"\",\n \"callbackPhone\": \"\",\n \"businessAddress\": {\n \"country\": \"\",\n \"state\": \"\",\n \"city\": \"\",\n \"street\": \"\",\n \"zip\": \"\"\n },\n \"homeAddress\": {\n \"country\": \"\",\n \"state\": \"\",\n \"city\": \"\",\n \"street\": \"\",\n \"zip\": \"\"\n },\n \"otherAddress\": {\n \"country\": \"\",\n \"state\": \"\",\n \"city\": \"\",\n \"street\": \"\",\n \"zip\": \"\"\n }\n }\n ]\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/restapi/v1.0/account/:accountId/address-book-bulk-upload", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v1.0", "account", ":accountId", "address-book-bulk-upload" ], "variable": [ { "key": "accountId" } ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"uri\": \"\",\n \"creationTime\": \"\",\n \"lastModifiedTime\": \"\",\n \"status\": \"Accepted\",\n \"results\": {\n \"affectedItems\": [\n {\n \"extensionId\": \"\",\n \"contacts\": [\n {\n \"email\": \"\",\n \"notes\": \"\",\n \"company\": \"\",\n \"firstName\": \"\",\n \"lastName\": \"\",\n \"jobTitle\": \"\",\n \"birthday\": \"\",\n \"webPage\": \"\",\n \"middleName\": \"\",\n \"nickName\": \"\",\n \"email2\": \"\",\n \"email3\": \"\",\n \"homePhone\": \"\",\n \"homePhone2\": \"\",\n \"businessPhone\": \"\",\n \"businessPhone2\": \"\",\n \"mobilePhone\": \"\",\n \"businessFax\": \"\",\n \"companyPhone\": \"\",\n \"assistantPhone\": \"\",\n \"carPhone\": \"\",\n \"otherPhone\": \"\",\n \"otherFax\": \"\",\n \"callbackPhone\": \"\",\n \"businessAddress\": {\n \"country\": \"\",\n \"state\": \"\",\n \"city\": \"\",\n \"street\": \"\",\n \"zip\": \"\"\n },\n \"homeAddress\": {\n \"country\": \"\",\n \"state\": \"\",\n \"city\": \"\",\n \"street\": \"\",\n \"zip\": \"\"\n },\n \"otherAddress\": {\n \"country\": \"\",\n \"state\": \"\",\n \"city\": \"\",\n \"street\": \"\",\n \"zip\": \"\"\n }\n }\n ]\n },\n {\n \"extensionId\": \"\",\n \"contacts\": [\n {\n \"email\": \"\",\n \"notes\": \"\",\n \"company\": \"\",\n \"firstName\": \"\",\n \"lastName\": \"\",\n \"jobTitle\": \"\",\n \"birthday\": \"\",\n \"webPage\": \"\",\n \"middleName\": \"\",\n \"nickName\": \"\",\n \"email2\": \"\",\n \"email3\": \"\",\n \"homePhone\": \"\",\n \"homePhone2\": \"\",\n \"businessPhone\": \"\",\n \"businessPhone2\": \"\",\n \"mobilePhone\": \"\",\n \"businessFax\": \"\",\n \"companyPhone\": \"\",\n \"assistantPhone\": \"\",\n \"carPhone\": \"\",\n \"otherPhone\": \"\",\n \"otherFax\": \"\",\n \"callbackPhone\": \"\",\n \"businessAddress\": {\n \"country\": \"\",\n \"state\": \"\",\n \"city\": \"\",\n \"street\": \"\",\n \"zip\": \"\"\n },\n \"homeAddress\": {\n \"country\": \"\",\n \"state\": \"\",\n \"city\": \"\",\n \"street\": \"\",\n \"zip\": \"\"\n },\n \"otherAddress\": {\n \"country\": \"\",\n \"state\": \"\",\n \"city\": \"\",\n \"street\": \"\",\n \"zip\": \"\"\n }\n }\n ]\n }\n ],\n \"errors\": [\n {\n \"errorCode\": \"\",\n \"message\": \"\",\n \"parameterName\": \"\",\n \"parameterValue\": \"\"\n },\n {\n \"errorCode\": \"\",\n \"message\": \"\",\n \"parameterName\": \"\",\n \"parameterValue\": \"\"\n }\n ]\n }\n}", "createdAt": "2026-07-28T02:49:25.000Z", "updatedAt": "2026-07-28T02:49:25.000Z", "uid": "35240-4f9b0ada-273d-43ac-90e3-c6812a2b2c80" } ], "createdAt": "2026-07-28T02:49:25.000Z", "updatedAt": "2026-07-28T02:49:25.000Z", "uid": "35240-c9ddb5b8-583f-4c4d-9da8-3ad979dc4ab0" } ], "id": "e3c4a260-81ed-41d5-985f-804206290bbd", "createdAt": "2026-07-28T02:49:24.000Z", "updatedAt": "2026-07-28T02:49:24.000Z", "uid": "35240-e3c4a260-81ed-41d5-985f-804206290bbd" }, { "name": "extension", "item": [ { "name": "{extensionId}", "item": [ { "name": "favorite", "item": [ { "name": "List Favorite Contacts", "id": "41af4768-526f-4387-a31a-eadf347c8f5f", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/restapi/v1.0/account/:accountId/extension/:extensionId/favorite", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v1.0", "account", ":accountId", "extension", ":extensionId", "favorite" ], "variable": [ { "id": "9af8e984-8299-4903-b711-62278b2fab96", "key": "accountId", "value": "~", "description": "(Required) Internal identifier of the RingCentral account\n(can be set to \"~\" to indicate that the account associated with current authorization session should be used)\n" }, { "id": "d88b3b1a-93bf-47b9-afb9-75eadb2ef75e", "key": "extensionId", "value": "~", "description": "(Required) Internal identifier of the RingCentral extension/user\n(can be set to \"~\" to indicate that the extension associated with current authorization session should be used)\n" } ] }, "description": "Returns the list of favorite contacts of the current extension.\nFavorite contacts include both company contacts (extensions) and personal\ncontacts (address book records).\n" }, "response": [ { "id": "f983a6b0-1811-4276-b5aa-cf1f21ef9741", "name": "Favorite Contact List", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/restapi/v1.0/account/:accountId/extension/:extensionId/favorite", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v1.0", "account", ":accountId", "extension", ":extensionId", "favorite" ], "variable": [ { "key": "accountId" }, { "key": "extensionId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"uri\": \"\",\n \"records\": [\n {\n \"id\": \"\",\n \"extensionId\": \"\",\n \"accountId\": \"\",\n \"contactId\": \"\"\n },\n {\n \"id\": \"\",\n \"extensionId\": \"\",\n \"accountId\": \"\",\n \"contactId\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:49:25.000Z", "updatedAt": "2026-07-28T02:49:25.000Z", "uid": "35240-f983a6b0-1811-4276-b5aa-cf1f21ef9741" } ], "createdAt": "2026-07-28T02:49:25.000Z", "updatedAt": "2026-07-28T02:49:25.000Z", "uid": "35240-41af4768-526f-4387-a31a-eadf347c8f5f" }, { "name": "Update Favorite Contact List", "id": "ae316c4b-e414-4eba-abef-91dfa314719d", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"records\": [\n {\n \"id\": \"\",\n \"extensionId\": \"\",\n \"accountId\": \"\",\n \"contactId\": \"\"\n },\n {\n \"id\": \"\",\n \"extensionId\": \"\",\n \"accountId\": \"\",\n \"contactId\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/restapi/v1.0/account/:accountId/extension/:extensionId/favorite", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v1.0", "account", ":accountId", "extension", ":extensionId", "favorite" ], "variable": [ { "id": "7933669f-2732-4aa8-92eb-8dc52fd58a34", "key": "accountId", "value": "~", "description": "(Required) Internal identifier of the RingCentral account\n(can be set to \"~\" to indicate that the account associated with current authorization session should be used)\n" }, { "id": "2005714f-6978-4c26-bf5d-d2836ae40b05", "key": "extensionId", "value": "~", "description": "(Required) Internal identifier of the RingCentral extension/user\n(can be set to \"~\" to indicate that the extension associated with current authorization session should be used)\n" } ] }, "description": "Updates the list of favorite contacts of the current extension.\nFavorite contacts include both company contacts (extensions) and personal\ncontacts (address book records).**Please note**: Currently personal address\nbook size is limited to 10 000 contacts.\n" }, "response": [ { "id": "6815cdfc-caa4-4e39-9f87-b4516793690a", "name": "Favorite contacts list", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"records\": [\n {\n \"id\": \"\",\n \"extensionId\": \"\",\n \"accountId\": \"\",\n \"contactId\": \"\"\n },\n {\n \"id\": \"\",\n \"extensionId\": \"\",\n \"accountId\": \"\",\n \"contactId\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/restapi/v1.0/account/:accountId/extension/:extensionId/favorite", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v1.0", "account", ":accountId", "extension", ":extensionId", "favorite" ], "variable": [ { "key": "accountId" }, { "key": "extensionId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"uri\": \"\",\n \"records\": [\n {\n \"id\": \"\",\n \"extensionId\": \"\",\n \"accountId\": \"\",\n \"contactId\": \"\"\n },\n {\n \"id\": \"\",\n \"extensionId\": \"\",\n \"accountId\": \"\",\n \"contactId\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:49:25.000Z", "updatedAt": "2026-07-28T02:49:25.000Z", "uid": "35240-6815cdfc-caa4-4e39-9f87-b4516793690a" } ], "createdAt": "2026-07-28T02:49:25.000Z", "updatedAt": "2026-07-28T02:49:25.000Z", "uid": "35240-ae316c4b-e414-4eba-abef-91dfa314719d" } ], "id": "419353ba-301e-4067-8277-53567e49315a", "createdAt": "2026-07-28T02:49:24.000Z", "updatedAt": "2026-07-28T02:49:24.000Z", "uid": "35240-419353ba-301e-4067-8277-53567e49315a" }, { "name": "address-book", "item": [ { "name": "contact", "item": [ { "name": "{contactId}", "item": [ { "name": "Get User Contact(s)", "id": "92408dde-c0a7-450f-8fd0-75475c9c036e", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/restapi/v1.0/account/:accountId/extension/:extensionId/address-book/contact/:contactId", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v1.0", "account", ":accountId", "extension", ":extensionId", "address-book", "contact", ":contactId" ], "variable": [ { "id": "6ba1eeba-3cb0-4bd3-926a-4a7614030f66", "key": "accountId", "value": "~", "description": "(Required) Internal identifier of the RingCentral account\n(can be set to \"~\" to indicate that the account associated with current authorization session should be used)\n" }, { "id": "3931ffd0-b52c-4a59-8094-4cef8f85d63b", "key": "extensionId", "value": "~", "description": "(Required) Internal identifier of the RingCentral extension/user\n(can be set to \"~\" to indicate that the extension associated with current authorization session should be used)\n" }, { "id": "008163ce-4aa7-41c1-958d-e4f3bf53644e", "key": "contactId", "value": "", "description": "(Required) The list of contact identifiers (comma-separated)" } ] }, "description": "Returns the user personal contact(s). \n[Batch request syntax](https://developers.ringcentral.com/api-reference/Batch-Requests) is supported.\n" }, "response": [ { "id": "1d37e86e-f215-46bc-a924-399940707cef", "name": "User personal contact(s) information", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/restapi/v1.0/account/:accountId/extension/:extensionId/address-book/contact/:contactId", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v1.0", "account", ":accountId", "extension", ":extensionId", "address-book", "contact", ":contactId" ], "variable": [ { "key": "accountId" }, { "key": "extensionId" }, { "key": "contactId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"uri\": \"\",\n \"availability\": \"Alive\",\n \"email\": \"\",\n \"id\": \"\",\n \"notes\": \"\",\n \"company\": \"\",\n \"firstName\": \"\",\n \"lastName\": \"\",\n \"jobTitle\": \"\",\n \"birthday\": \"\",\n \"webPage\": \"\",\n \"middleName\": \"\",\n \"nickName\": \"\",\n \"email2\": \"\",\n \"email3\": \"\",\n \"homePhone\": \"\",\n \"homePhone2\": \"\",\n \"businessPhone\": \"\",\n \"businessPhone2\": \"\",\n \"mobilePhone\": \"\",\n \"businessFax\": \"\",\n \"companyPhone\": \"\",\n \"assistantPhone\": \"\",\n \"carPhone\": \"\",\n \"otherPhone\": \"\",\n \"otherFax\": \"\",\n \"callbackPhone\": \"\",\n \"businessAddress\": {\n \"street\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"state\": \"\",\n \"zip\": \"\"\n },\n \"homeAddress\": {\n \"street\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"state\": \"\",\n \"zip\": \"\"\n },\n \"otherAddress\": {\n \"street\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"state\": \"\",\n \"zip\": \"\"\n },\n \"ringtoneIndex\": \"\"\n}", "createdAt": "2026-07-28T02:49:25.000Z", "updatedAt": "2026-07-28T02:49:25.000Z", "uid": "35240-1d37e86e-f215-46bc-a924-399940707cef" } ], "createdAt": "2026-07-28T02:49:25.000Z", "updatedAt": "2026-07-28T02:49:25.000Z", "uid": "35240-92408dde-c0a7-450f-8fd0-75475c9c036e" }, { "name": "Update User Contact(s)", "id": "25645efd-a920-4fba-811c-58246393be19", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"firstName\": \"\",\n \"lastName\": \"\",\n \"middleName\": \"\",\n \"nickName\": \"\",\n \"company\": \"\",\n \"jobTitle\": \"\",\n \"email\": \"\",\n \"email2\": \"\",\n \"email3\": \"\",\n \"birthday\": \"\",\n \"webPage\": \"\",\n \"notes\": \"\",\n \"homePhone\": \"\",\n \"homePhone2\": \"\",\n \"businessPhone\": \"\",\n \"businessPhone2\": \"\",\n \"mobilePhone\": \"\",\n \"businessFax\": \"\",\n \"companyPhone\": \"\",\n \"assistantPhone\": \"\",\n \"carPhone\": \"\",\n \"otherPhone\": \"\",\n \"otherFax\": \"\",\n \"callbackPhone\": \"\",\n \"homeAddress\": {\n \"street\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"state\": \"\",\n \"zip\": \"\"\n },\n \"businessAddress\": {\n \"street\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"state\": \"\",\n \"zip\": \"\"\n },\n \"otherAddress\": {\n \"street\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"state\": \"\",\n \"zip\": \"\"\n },\n \"ringtoneIndex\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/restapi/v1.0/account/:accountId/extension/:extensionId/address-book/contact/:contactId?dialingPlan=", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v1.0", "account", ":accountId", "extension", ":extensionId", "address-book", "contact", ":contactId" ], "query": [ { "description": "Country code value complying with the [ISO 3166-1 alpha-2](https://ru.wikipedia.org/wiki/ISO_3166-1_alpha-2) format. \nThe default value is home country of the current extension\n", "key": "dialingPlan", "value": "" } ], "variable": [ { "id": "a2b4c7b9-6b47-45ae-9a63-550ad44072b5", "key": "accountId", "value": "~", "description": "(Required) Internal identifier of the RingCentral account\n(can be set to \"~\" to indicate that the account associated with current authorization session should be used)\n" }, { "id": "a6b05e19-9724-41f7-81ca-2c4a5dfbaeb3", "key": "extensionId", "value": "~", "description": "(Required) Internal identifier of the RingCentral extension/user\n(can be set to \"~\" to indicate that the extension associated with current authorization session should be used)\n" }, { "id": "04ebdb34-0d08-4caf-8335-e6a06cc2bd02", "key": "contactId", "value": "", "description": "(Required) The list of contact identifiers (comma-separated)" } ] }, "description": "Updates the user personal contact(s) (full resource update). \n[Batch request syntax](https://developers.ringcentral.com/api-reference/Batch-Requests) is supported.\n" }, "response": [ { "id": "61cc0116-1c13-4ea1-b987-13dd67615b73", "name": "Success", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"firstName\": \"\",\n \"lastName\": \"\",\n \"middleName\": \"\",\n \"nickName\": \"\",\n \"company\": \"\",\n \"jobTitle\": \"\",\n \"email\": \"\",\n \"email2\": \"\",\n \"email3\": \"\",\n \"birthday\": \"\",\n \"webPage\": \"\",\n \"notes\": \"\",\n \"homePhone\": \"\",\n \"homePhone2\": \"\",\n \"businessPhone\": \"\",\n \"businessPhone2\": \"\",\n \"mobilePhone\": \"\",\n \"businessFax\": \"\",\n \"companyPhone\": \"\",\n \"assistantPhone\": \"\",\n \"carPhone\": \"\",\n \"otherPhone\": \"\",\n \"otherFax\": \"\",\n \"callbackPhone\": \"\",\n \"homeAddress\": {\n \"street\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"state\": \"\",\n \"zip\": \"\"\n },\n \"businessAddress\": {\n \"street\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"state\": \"\",\n \"zip\": \"\"\n },\n \"otherAddress\": {\n \"street\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"state\": \"\",\n \"zip\": \"\"\n },\n \"ringtoneIndex\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/restapi/v1.0/account/:accountId/extension/:extensionId/address-book/contact/:contactId?dialingPlan=", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v1.0", "account", ":accountId", "extension", ":extensionId", "address-book", "contact", ":contactId" ], "query": [ { "description": "Country code value complying with the [ISO 3166-1 alpha-2](https://ru.wikipedia.org/wiki/ISO_3166-1_alpha-2) format. \nThe default value is home country of the current extension\n", "key": "dialingPlan", "value": "" } ], "variable": [ { "key": "accountId" }, { "key": "extensionId" }, { "key": "contactId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"uri\": \"\",\n \"availability\": \"Alive\",\n \"email\": \"\",\n \"id\": \"\",\n \"notes\": \"\",\n \"company\": \"\",\n \"firstName\": \"\",\n \"lastName\": \"\",\n \"jobTitle\": \"\",\n \"birthday\": \"\",\n \"webPage\": \"\",\n \"middleName\": \"\",\n \"nickName\": \"\",\n \"email2\": \"\",\n \"email3\": \"\",\n \"homePhone\": \"\",\n \"homePhone2\": \"\",\n \"businessPhone\": \"\",\n \"businessPhone2\": \"\",\n \"mobilePhone\": \"\",\n \"businessFax\": \"\",\n \"companyPhone\": \"\",\n \"assistantPhone\": \"\",\n \"carPhone\": \"\",\n \"otherPhone\": \"\",\n \"otherFax\": \"\",\n \"callbackPhone\": \"\",\n \"businessAddress\": {\n \"street\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"state\": \"\",\n \"zip\": \"\"\n },\n \"homeAddress\": {\n \"street\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"state\": \"\",\n \"zip\": \"\"\n },\n \"otherAddress\": {\n \"street\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"state\": \"\",\n \"zip\": \"\"\n },\n \"ringtoneIndex\": \"\"\n}", "createdAt": "2026-07-28T02:49:25.000Z", "updatedAt": "2026-07-28T02:49:25.000Z", "uid": "35240-61cc0116-1c13-4ea1-b987-13dd67615b73" } ], "createdAt": "2026-07-28T02:49:25.000Z", "updatedAt": "2026-07-28T02:49:25.000Z", "uid": "35240-25645efd-a920-4fba-811c-58246393be19" }, { "name": "Update Contact Attributes", "id": "062f14cb-8a7b-4363-9632-653288ebcbfc", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"firstName\": \"\",\n \"lastName\": \"\",\n \"middleName\": \"\",\n \"nickName\": \"\",\n \"company\": \"\",\n \"jobTitle\": \"\",\n \"email\": \"\",\n \"email2\": \"\",\n \"email3\": \"\",\n \"birthday\": \"\",\n \"webPage\": \"\",\n \"notes\": \"\",\n \"homePhone\": \"\",\n \"homePhone2\": \"\",\n \"businessPhone\": \"\",\n \"businessPhone2\": \"\",\n \"mobilePhone\": \"\",\n \"businessFax\": \"\",\n \"companyPhone\": \"\",\n \"assistantPhone\": \"\",\n \"carPhone\": \"\",\n \"otherPhone\": \"\",\n \"otherFax\": \"\",\n \"callbackPhone\": \"\",\n \"homeAddress\": {\n \"street\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"state\": \"\",\n \"zip\": \"\"\n },\n \"businessAddress\": {\n \"street\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"state\": \"\",\n \"zip\": \"\"\n },\n \"otherAddress\": {\n \"street\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"state\": \"\",\n \"zip\": \"\"\n },\n \"ringtoneIndex\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/restapi/v1.0/account/:accountId/extension/:extensionId/address-book/contact/:contactId?dialingPlan=", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v1.0", "account", ":accountId", "extension", ":extensionId", "address-book", "contact", ":contactId" ], "query": [ { "description": "Country code value complying with the [ISO 3166-1 alpha-2](https://ru.wikipedia.org/wiki/ISO_3166-1_alpha-2)\nformat. The default value is home country of the current extension\n", "key": "dialingPlan", "value": "" } ], "variable": [ { "id": "9972eccb-06b4-4e84-aa66-d5e94644e64e", "key": "accountId", "value": "~", "description": "(Required) Internal identifier of the RingCentral account\n(can be set to \"~\" to indicate that the account associated with current authorization session should be used)\n" }, { "id": "5566037f-fb39-4233-b825-c62bbf6202c7", "key": "extensionId", "value": "~", "description": "(Required) Internal identifier of the RingCentral extension/user\n(can be set to \"~\" to indicate that the extension associated with current authorization session should be used)\n" }, { "id": "ce130458-f97d-447f-8489-e6bba8440652", "key": "contactId", "value": "", "description": "(Required) Internal identifier of a contact record in the RingCentral database\n" } ] }, "description": "Updates particular values of a personal contact attributes specified in request (partial resource update). Omitted attributes will remain unchanged.\nIf any attribute is passed in request body with the null value, then this attribute value will be removed.\n" }, "response": [ { "id": "b2a1801a-716f-4d39-a71a-bed922004c3d", "name": "Edited personal contact information", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"firstName\": \"\",\n \"lastName\": \"\",\n \"middleName\": \"\",\n \"nickName\": \"\",\n \"company\": \"\",\n \"jobTitle\": \"\",\n \"email\": \"\",\n \"email2\": \"\",\n \"email3\": \"\",\n \"birthday\": \"\",\n \"webPage\": \"\",\n \"notes\": \"\",\n \"homePhone\": \"\",\n \"homePhone2\": \"\",\n \"businessPhone\": \"\",\n \"businessPhone2\": \"\",\n \"mobilePhone\": \"\",\n \"businessFax\": \"\",\n \"companyPhone\": \"\",\n \"assistantPhone\": \"\",\n \"carPhone\": \"\",\n \"otherPhone\": \"\",\n \"otherFax\": \"\",\n \"callbackPhone\": \"\",\n \"homeAddress\": {\n \"street\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"state\": \"\",\n \"zip\": \"\"\n },\n \"businessAddress\": {\n \"street\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"state\": \"\",\n \"zip\": \"\"\n },\n \"otherAddress\": {\n \"street\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"state\": \"\",\n \"zip\": \"\"\n },\n \"ringtoneIndex\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/restapi/v1.0/account/:accountId/extension/:extensionId/address-book/contact/:contactId?dialingPlan=", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v1.0", "account", ":accountId", "extension", ":extensionId", "address-book", "contact", ":contactId" ], "query": [ { "description": "Country code value complying with the [ISO 3166-1 alpha-2](https://ru.wikipedia.org/wiki/ISO_3166-1_alpha-2)\nformat. The default value is home country of the current extension\n", "key": "dialingPlan", "value": "" } ], "variable": [ { "key": "accountId" }, { "key": "extensionId" }, { "key": "contactId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"uri\": \"\",\n \"availability\": \"Alive\",\n \"email\": \"\",\n \"id\": \"\",\n \"notes\": \"\",\n \"company\": \"\",\n \"firstName\": \"\",\n \"lastName\": \"\",\n \"jobTitle\": \"\",\n \"birthday\": \"\",\n \"webPage\": \"\",\n \"middleName\": \"\",\n \"nickName\": \"\",\n \"email2\": \"\",\n \"email3\": \"\",\n \"homePhone\": \"\",\n \"homePhone2\": \"\",\n \"businessPhone\": \"\",\n \"businessPhone2\": \"\",\n \"mobilePhone\": \"\",\n \"businessFax\": \"\",\n \"companyPhone\": \"\",\n \"assistantPhone\": \"\",\n \"carPhone\": \"\",\n \"otherPhone\": \"\",\n \"otherFax\": \"\",\n \"callbackPhone\": \"\",\n \"businessAddress\": {\n \"street\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"state\": \"\",\n \"zip\": \"\"\n },\n \"homeAddress\": {\n \"street\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"state\": \"\",\n \"zip\": \"\"\n },\n \"otherAddress\": {\n \"street\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"state\": \"\",\n \"zip\": \"\"\n },\n \"ringtoneIndex\": \"\"\n}", "createdAt": "2026-07-28T02:49:25.000Z", "updatedAt": "2026-07-28T02:49:25.000Z", "uid": "35240-b2a1801a-716f-4d39-a71a-bed922004c3d" } ], "createdAt": "2026-07-28T02:49:25.000Z", "updatedAt": "2026-07-28T02:49:25.000Z", "uid": "35240-062f14cb-8a7b-4363-9632-653288ebcbfc" }, { "name": "Delete User Contact(s)", "id": "f1d95894-4283-4899-9ac2-6696eb911163", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "DELETE", "header": [], "url": { "raw": "{{baseUrl}}/restapi/v1.0/account/:accountId/extension/:extensionId/address-book/contact/:contactId", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v1.0", "account", ":accountId", "extension", ":extensionId", "address-book", "contact", ":contactId" ], "variable": [ { "id": "d9d46297-2737-4333-bde2-743c03fedc6e", "key": "accountId", "value": "~", "description": "(Required) Internal identifier of the RingCentral account\n(can be set to \"~\" to indicate that the account associated with current authorization session should be used)\n" }, { "id": "647d90fb-dd28-4101-97d8-3a3bfebe4835", "key": "extensionId", "value": "~", "description": "(Required) Internal identifier of the RingCentral extension/user\n(can be set to \"~\" to indicate that the extension associated with current authorization session should be used)\n" }, { "id": "d97ab9ce-a631-4355-9217-085f999fdc0d", "key": "contactId", "value": "", "description": "(Required) The list of contact identifiers (comma-separated)" } ] }, "description": "Deletes the user personal contact(s). \n[Batch request syntax](https://developers.ringcentral.com/api-reference/Batch-Requests) is supported.\n" }, "response": [ { "id": "e995c7e7-48ee-4204-a270-3931e2c1d060", "name": "No Content", "originalRequest": { "method": "DELETE", "header": [ { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/restapi/v1.0/account/:accountId/extension/:extensionId/address-book/contact/:contactId", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v1.0", "account", ":accountId", "extension", ":extensionId", "address-book", "contact", ":contactId" ], "variable": [ { "key": "accountId" }, { "key": "extensionId" }, { "key": "contactId" } ] } }, "status": "No Content", "code": 204, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T02:49:25.000Z", "updatedAt": "2026-07-28T02:49:25.000Z", "uid": "35240-e995c7e7-48ee-4204-a270-3931e2c1d060" } ], "createdAt": "2026-07-28T02:49:25.000Z", "updatedAt": "2026-07-28T02:49:25.000Z", "uid": "35240-f1d95894-4283-4899-9ac2-6696eb911163" } ], "id": "54541928-73ed-4503-9448-8bdab1f0c661", "createdAt": "2026-07-28T02:49:24.000Z", "updatedAt": "2026-07-28T02:49:24.000Z", "uid": "35240-54541928-73ed-4503-9448-8bdab1f0c661" }, { "name": "List Contacts", "id": "a461f991-94e5-4bcf-a1b1-fe044f165427", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/restapi/v1.0/account/:accountId/extension/:extensionId/address-book/contact?startsWith=&sortBy=Company&sortBy=FirstName&page=1&perPage=100&phoneNumber=&phoneNumber=", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v1.0", "account", ":accountId", "extension", ":extensionId", "address-book", "contact" ], "query": [ { "description": "If specified, only contacts which 'First name' or 'Last name' start\nwith the mentioned substring will be returned. Case-insensitive\n", "key": "startsWith", "value": "" }, { "description": "Sorts results by the specified property", "key": "sortBy", "value": "Company" }, { "description": "Sorts results by the specified property", "key": "sortBy", "value": "FirstName" }, { "description": "The result set page number (1-indexed) to return", "key": "page", "value": "1" }, { "description": "The number of items per page. If provided value in the request\nis greater than a maximum, the maximum value is applied\n", "key": "perPage", "value": "100" }, { "description": "Phone number in e.164 format", "key": "phoneNumber", "value": "" }, { "description": "Phone number in e.164 format", "key": "phoneNumber", "value": "" } ], "variable": [ { "id": "c89e7a25-ad64-4c7d-8e91-8c8287867545", "key": "accountId", "value": "~", "description": "(Required) Internal identifier of the RingCentral account\n(can be set to \"~\" to indicate that the account associated with current authorization session should be used)\n" }, { "id": "412c12da-db8d-4ed3-8fa0-79e8878f2735", "key": "extensionId", "value": "~", "description": "(Required) Internal identifier of the RingCentral extension/user\n(can be set to \"~\" to indicate that the extension associated with current authorization session should be used)\n" } ] }, "description": "Returns the user personal contacts.\n" }, "response": [ { "id": "e2d2e4b1-7689-4e30-b23c-13ef475714bb", "name": "Contact list", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/restapi/v1.0/account/:accountId/extension/:extensionId/address-book/contact?startsWith=&sortBy=FirstName&page=1&perPage=100&phoneNumber=", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v1.0", "account", ":accountId", "extension", ":extensionId", "address-book", "contact" ], "query": [ { "description": "If specified, only contacts which 'First name' or 'Last name' start\nwith the mentioned substring will be returned. Case-insensitive\n", "key": "startsWith", "value": "" }, { "description": "Sorts results by the specified property", "key": "sortBy", "value": "FirstName" }, { "description": "The result set page number (1-indexed) to return", "key": "page", "value": "1" }, { "description": "The number of items per page. If provided value in the request\nis greater than a maximum, the maximum value is applied\n", "key": "perPage", "value": "100" }, { "description": "Phone number in e.164 format", "key": "phoneNumber", "value": "" } ], "variable": [ { "key": "accountId" }, { "key": "extensionId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"uri\": \"\",\n \"records\": [\n {\n \"uri\": \"\",\n \"availability\": \"Purged\",\n \"email\": \"\",\n \"id\": \"\",\n \"notes\": \"\",\n \"company\": \"\",\n \"firstName\": \"\",\n \"lastName\": \"\",\n \"jobTitle\": \"\",\n \"birthday\": \"\",\n \"webPage\": \"\",\n \"middleName\": \"\",\n \"nickName\": \"\",\n \"email2\": \"\",\n \"email3\": \"\",\n \"homePhone\": \"\",\n \"homePhone2\": \"\",\n \"businessPhone\": \"\",\n \"businessPhone2\": \"\",\n \"mobilePhone\": \"\",\n \"businessFax\": \"\",\n \"companyPhone\": \"\",\n \"assistantPhone\": \"\",\n \"carPhone\": \"\",\n \"otherPhone\": \"\",\n \"otherFax\": \"\",\n \"callbackPhone\": \"\",\n \"businessAddress\": {\n \"street\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"state\": \"\",\n \"zip\": \"\"\n },\n \"homeAddress\": {\n \"street\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"state\": \"\",\n \"zip\": \"\"\n },\n \"otherAddress\": {\n \"street\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"state\": \"\",\n \"zip\": \"\"\n },\n \"ringtoneIndex\": \"\"\n },\n {\n \"uri\": \"\",\n \"availability\": \"Purged\",\n \"email\": \"\",\n \"id\": \"\",\n \"notes\": \"\",\n \"company\": \"\",\n \"firstName\": \"\",\n \"lastName\": \"\",\n \"jobTitle\": \"\",\n \"birthday\": \"\",\n \"webPage\": \"\",\n \"middleName\": \"\",\n \"nickName\": \"\",\n \"email2\": \"\",\n \"email3\": \"\",\n \"homePhone\": \"\",\n \"homePhone2\": \"\",\n \"businessPhone\": \"\",\n \"businessPhone2\": \"\",\n \"mobilePhone\": \"\",\n \"businessFax\": \"\",\n \"companyPhone\": \"\",\n \"assistantPhone\": \"\",\n \"carPhone\": \"\",\n \"otherPhone\": \"\",\n \"otherFax\": \"\",\n \"callbackPhone\": \"\",\n \"businessAddress\": {\n \"street\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"state\": \"\",\n \"zip\": \"\"\n },\n \"homeAddress\": {\n \"street\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"state\": \"\",\n \"zip\": \"\"\n },\n \"otherAddress\": {\n \"street\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"state\": \"\",\n \"zip\": \"\"\n },\n \"ringtoneIndex\": \"\"\n }\n ],\n \"navigation\": {\n \"firstPage\": {\n \"uri\": \"\"\n },\n \"nextPage\": {\n \"uri\": \"\"\n },\n \"previousPage\": {\n \"uri\": \"\"\n },\n \"lastPage\": {\n \"uri\": \"\"\n }\n },\n \"paging\": {\n \"page\": \"\",\n \"perPage\": \"\",\n \"pageStart\": \"\",\n \"pageEnd\": \"\",\n \"totalPages\": \"\",\n \"totalElements\": \"\"\n },\n \"groups\": {\n \"uri\": \"\"\n }\n}", "createdAt": "2026-07-28T02:49:25.000Z", "updatedAt": "2026-07-28T02:49:25.000Z", "uid": "35240-e2d2e4b1-7689-4e30-b23c-13ef475714bb" } ], "createdAt": "2026-07-28T02:49:25.000Z", "updatedAt": "2026-07-28T02:49:25.000Z", "uid": "35240-a461f991-94e5-4bcf-a1b1-fe044f165427" }, { "name": "Create User Contact", "id": "0f06d39b-a3ac-4b48-93cd-3adcf7ef2204", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"firstName\": \"\",\n \"lastName\": \"\",\n \"middleName\": \"\",\n \"nickName\": \"\",\n \"company\": \"\",\n \"jobTitle\": \"\",\n \"email\": \"\",\n \"email2\": \"\",\n \"email3\": \"\",\n \"birthday\": \"\",\n \"webPage\": \"\",\n \"notes\": \"\",\n \"homePhone\": \"\",\n \"homePhone2\": \"\",\n \"businessPhone\": \"\",\n \"businessPhone2\": \"\",\n \"mobilePhone\": \"\",\n \"businessFax\": \"\",\n \"companyPhone\": \"\",\n \"assistantPhone\": \"\",\n \"carPhone\": \"\",\n \"otherPhone\": \"\",\n \"otherFax\": \"\",\n \"callbackPhone\": \"\",\n \"homeAddress\": {\n \"street\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"state\": \"\",\n \"zip\": \"\"\n },\n \"businessAddress\": {\n \"street\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"state\": \"\",\n \"zip\": \"\"\n },\n \"otherAddress\": {\n \"street\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"state\": \"\",\n \"zip\": \"\"\n },\n \"ringtoneIndex\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/restapi/v1.0/account/:accountId/extension/:extensionId/address-book/contact?dialingPlan=", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v1.0", "account", ":accountId", "extension", ":extensionId", "address-book", "contact" ], "query": [ { "description": "Country code value complying with the [ISO 3166-1 alpha-2](https://ru.wikipedia.org/wiki/ISO_3166-1_alpha-2)\nformat. The default value is home country of the current extension\n", "key": "dialingPlan", "value": "" } ], "variable": [ { "id": "322b3b63-35ad-4b1d-8d03-9a5f3192c21f", "key": "accountId", "value": "~", "description": "(Required) Internal identifier of the RingCentral account\n(can be set to \"~\" to indicate that the account associated with current authorization session should be used)\n" }, { "id": "072c9ce2-e6d6-4f1f-be37-3d09ee132a95", "key": "extensionId", "value": "~", "description": "(Required) Internal identifier of the RingCentral extension/user\n(can be set to \"~\" to indicate that the extension associated with current authorization session should be used)\n" } ] }, "description": "Creates the user personal contact.\n" }, "response": [ { "id": "a3ae39fc-0fdf-407b-be8c-76a24c54a8d8", "name": "Created contact information", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"firstName\": \"\",\n \"lastName\": \"\",\n \"middleName\": \"\",\n \"nickName\": \"\",\n \"company\": \"\",\n \"jobTitle\": \"\",\n \"email\": \"\",\n \"email2\": \"\",\n \"email3\": \"\",\n \"birthday\": \"\",\n \"webPage\": \"\",\n \"notes\": \"\",\n \"homePhone\": \"\",\n \"homePhone2\": \"\",\n \"businessPhone\": \"\",\n \"businessPhone2\": \"\",\n \"mobilePhone\": \"\",\n \"businessFax\": \"\",\n \"companyPhone\": \"\",\n \"assistantPhone\": \"\",\n \"carPhone\": \"\",\n \"otherPhone\": \"\",\n \"otherFax\": \"\",\n \"callbackPhone\": \"\",\n \"homeAddress\": {\n \"street\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"state\": \"\",\n \"zip\": \"\"\n },\n \"businessAddress\": {\n \"street\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"state\": \"\",\n \"zip\": \"\"\n },\n \"otherAddress\": {\n \"street\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"state\": \"\",\n \"zip\": \"\"\n },\n \"ringtoneIndex\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/restapi/v1.0/account/:accountId/extension/:extensionId/address-book/contact?dialingPlan=", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v1.0", "account", ":accountId", "extension", ":extensionId", "address-book", "contact" ], "query": [ { "description": "Country code value complying with the [ISO 3166-1 alpha-2](https://ru.wikipedia.org/wiki/ISO_3166-1_alpha-2)\nformat. The default value is home country of the current extension\n", "key": "dialingPlan", "value": "" } ], "variable": [ { "key": "accountId" }, { "key": "extensionId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"uri\": \"\",\n \"availability\": \"Alive\",\n \"email\": \"\",\n \"id\": \"\",\n \"notes\": \"\",\n \"company\": \"\",\n \"firstName\": \"\",\n \"lastName\": \"\",\n \"jobTitle\": \"\",\n \"birthday\": \"\",\n \"webPage\": \"\",\n \"middleName\": \"\",\n \"nickName\": \"\",\n \"email2\": \"\",\n \"email3\": \"\",\n \"homePhone\": \"\",\n \"homePhone2\": \"\",\n \"businessPhone\": \"\",\n \"businessPhone2\": \"\",\n \"mobilePhone\": \"\",\n \"businessFax\": \"\",\n \"companyPhone\": \"\",\n \"assistantPhone\": \"\",\n \"carPhone\": \"\",\n \"otherPhone\": \"\",\n \"otherFax\": \"\",\n \"callbackPhone\": \"\",\n \"businessAddress\": {\n \"street\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"state\": \"\",\n \"zip\": \"\"\n },\n \"homeAddress\": {\n \"street\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"state\": \"\",\n \"zip\": \"\"\n },\n \"otherAddress\": {\n \"street\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"state\": \"\",\n \"zip\": \"\"\n },\n \"ringtoneIndex\": \"\"\n}", "createdAt": "2026-07-28T02:49:25.000Z", "updatedAt": "2026-07-28T02:49:25.000Z", "uid": "35240-a3ae39fc-0fdf-407b-be8c-76a24c54a8d8" }, { "id": "125de317-4cdf-4813-bc6d-d133c597247b", "name": "Contact cannot be created: max contacts count reached ($limit)", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"firstName\": \"\",\n \"lastName\": \"\",\n \"middleName\": \"\",\n \"nickName\": \"\",\n \"company\": \"\",\n \"jobTitle\": \"\",\n \"email\": \"\",\n \"email2\": \"\",\n \"email3\": \"\",\n \"birthday\": \"\",\n \"webPage\": \"\",\n \"notes\": \"\",\n \"homePhone\": \"\",\n \"homePhone2\": \"\",\n \"businessPhone\": \"\",\n \"businessPhone2\": \"\",\n \"mobilePhone\": \"\",\n \"businessFax\": \"\",\n \"companyPhone\": \"\",\n \"assistantPhone\": \"\",\n \"carPhone\": \"\",\n \"otherPhone\": \"\",\n \"otherFax\": \"\",\n \"callbackPhone\": \"\",\n \"homeAddress\": {\n \"street\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"state\": \"\",\n \"zip\": \"\"\n },\n \"businessAddress\": {\n \"street\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"state\": \"\",\n \"zip\": \"\"\n },\n \"otherAddress\": {\n \"street\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"state\": \"\",\n \"zip\": \"\"\n },\n \"ringtoneIndex\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/restapi/v1.0/account/:accountId/extension/:extensionId/address-book/contact?dialingPlan=", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v1.0", "account", ":accountId", "extension", ":extensionId", "address-book", "contact" ], "query": [ { "description": "Country code value complying with the [ISO 3166-1 alpha-2](https://ru.wikipedia.org/wiki/ISO_3166-1_alpha-2)\nformat. The default value is home country of the current extension\n", "key": "dialingPlan", "value": "" } ], "variable": [ { "key": "accountId" }, { "key": "extensionId" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T02:49:25.000Z", "updatedAt": "2026-07-28T02:49:25.000Z", "uid": "35240-125de317-4cdf-4813-bc6d-d133c597247b" } ], "createdAt": "2026-07-28T02:49:25.000Z", "updatedAt": "2026-07-28T02:49:25.000Z", "uid": "35240-0f06d39b-a3ac-4b48-93cd-3adcf7ef2204" } ], "id": "960757f1-fd84-4ee1-adbc-80322126d683", "createdAt": "2026-07-28T02:49:24.000Z", "updatedAt": "2026-07-28T02:49:24.000Z", "uid": "35240-960757f1-fd84-4ee1-adbc-80322126d683" } ], "id": "23222169-56aa-4892-96a4-e4f1f1ab43f8", "createdAt": "2026-07-28T02:49:24.000Z", "updatedAt": "2026-07-28T02:49:24.000Z", "uid": "35240-23222169-56aa-4892-96a4-e4f1f1ab43f8" }, { "name": "address-book-sync", "item": [ { "name": "Address Book Synchronization", "id": "10bbb1ca-164e-479a-bf7e-524ae107e33d", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/restapi/v1.0/account/:accountId/extension/:extensionId/address-book-sync?syncType=ISync&syncToken=&perPage=&pageId=", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v1.0", "account", ":accountId", "extension", ":extensionId", "address-book-sync" ], "query": [ { "description": "Type of synchronization", "key": "syncType", "value": "ISync" }, { "description": "Value of syncToken property of the last sync request response\n", "key": "syncToken", "value": "" }, { "description": "Number of records per page to be returned. Max number of\nrecords is 250, which is also the default.\nFor 'FSync' - if the number of records exceeds the parameter value\n(either specified or default), all of the pages can be retrieved\nin several requests. For 'ISync' - if the number of records exceeds\npage size, then the number of incoming changes to this\nnumber is limited\n", "key": "perPage", "value": "" }, { "description": "Internal identifier of a page. It can be obtained from the 'nextPageId'\nparameter passed in response body\n", "key": "pageId", "value": "" } ], "variable": [ { "id": "6409bbb6-2e3d-4140-a4be-998dd3b875af", "key": "accountId", "value": "~", "description": "(Required) Internal identifier of the RingCentral account\n(can be set to \"~\" to indicate that the account associated with current authorization session should be used)\n" }, { "id": "f3e0ea6d-9800-4315-85ee-97e2fc7619fd", "key": "extensionId", "value": "~", "description": "(Required) Internal identifier of the RingCentral extension/user\n(can be set to \"~\" to indicate that the extension associated with current authorization session should be used)\n" } ] }, "description": "Synchronizes user contacts.\n" }, "response": [ { "id": "fb8a6cbd-b318-411a-b0e8-9800b52d7130", "name": "Synchronized user contacts", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/restapi/v1.0/account/:accountId/extension/:extensionId/address-book-sync?syncType=ISync&syncToken=&perPage=&pageId=", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v1.0", "account", ":accountId", "extension", ":extensionId", "address-book-sync" ], "query": [ { "description": "Type of synchronization", "key": "syncType", "value": "ISync" }, { "description": "Value of syncToken property of the last sync request response\n", "key": "syncToken", "value": "" }, { "description": "Number of records per page to be returned. Max number of\nrecords is 250, which is also the default.\nFor 'FSync' - if the number of records exceeds the parameter value\n(either specified or default), all of the pages can be retrieved\nin several requests. For 'ISync' - if the number of records exceeds\npage size, then the number of incoming changes to this\nnumber is limited\n", "key": "perPage", "value": "" }, { "description": "Internal identifier of a page. It can be obtained from the 'nextPageId'\nparameter passed in response body\n", "key": "pageId", "value": "" } ], "variable": [ { "key": "accountId" }, { "key": "extensionId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"uri\": \"\",\n \"records\": [\n {\n \"uri\": \"\",\n \"availability\": \"Purged\",\n \"email\": \"\",\n \"id\": \"\",\n \"notes\": \"\",\n \"company\": \"\",\n \"firstName\": \"\",\n \"lastName\": \"\",\n \"jobTitle\": \"\",\n \"birthday\": \"\",\n \"webPage\": \"\",\n \"middleName\": \"\",\n \"nickName\": \"\",\n \"email2\": \"\",\n \"email3\": \"\",\n \"homePhone\": \"\",\n \"homePhone2\": \"\",\n \"businessPhone\": \"\",\n \"businessPhone2\": \"\",\n \"mobilePhone\": \"\",\n \"businessFax\": \"\",\n \"companyPhone\": \"\",\n \"assistantPhone\": \"\",\n \"carPhone\": \"\",\n \"otherPhone\": \"\",\n \"otherFax\": \"\",\n \"callbackPhone\": \"\",\n \"businessAddress\": {\n \"street\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"state\": \"\",\n \"zip\": \"\"\n },\n \"homeAddress\": {\n \"street\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"state\": \"\",\n \"zip\": \"\"\n },\n \"otherAddress\": {\n \"street\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"state\": \"\",\n \"zip\": \"\"\n },\n \"ringtoneIndex\": \"\"\n },\n {\n \"uri\": \"\",\n \"availability\": \"Alive\",\n \"email\": \"\",\n \"id\": \"\",\n \"notes\": \"\",\n \"company\": \"\",\n \"firstName\": \"\",\n \"lastName\": \"\",\n \"jobTitle\": \"\",\n \"birthday\": \"\",\n \"webPage\": \"\",\n \"middleName\": \"\",\n \"nickName\": \"\",\n \"email2\": \"\",\n \"email3\": \"\",\n \"homePhone\": \"\",\n \"homePhone2\": \"\",\n \"businessPhone\": \"\",\n \"businessPhone2\": \"\",\n \"mobilePhone\": \"\",\n \"businessFax\": \"\",\n \"companyPhone\": \"\",\n \"assistantPhone\": \"\",\n \"carPhone\": \"\",\n \"otherPhone\": \"\",\n \"otherFax\": \"\",\n \"callbackPhone\": \"\",\n \"businessAddress\": {\n \"street\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"state\": \"\",\n \"zip\": \"\"\n },\n \"homeAddress\": {\n \"street\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"state\": \"\",\n \"zip\": \"\"\n },\n \"otherAddress\": {\n \"street\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"state\": \"\",\n \"zip\": \"\"\n },\n \"ringtoneIndex\": \"\"\n }\n ],\n \"syncInfo\": {\n \"syncType\": \"FSync\",\n \"syncToken\": \"\",\n \"syncTime\": \"\",\n \"olderRecordsExist\": false\n },\n \"nextPageId\": \"\",\n \"nextPageUri\": \"\"\n}", "createdAt": "2026-07-28T02:49:25.000Z", "updatedAt": "2026-07-28T02:49:25.000Z", "uid": "35240-fb8a6cbd-b318-411a-b0e8-9800b52d7130" } ], "createdAt": "2026-07-28T02:49:25.000Z", "updatedAt": "2026-07-28T02:49:25.000Z", "uid": "35240-10bbb1ca-164e-479a-bf7e-524ae107e33d" } ], "id": "55e0bcd6-4f10-4826-94ba-6e2249ca928a", "createdAt": "2026-07-28T02:49:24.000Z", "updatedAt": "2026-07-28T02:49:24.000Z", "uid": "35240-55e0bcd6-4f10-4826-94ba-6e2249ca928a" } ], "id": "73f83c12-7601-48f9-a86b-3ebf2013bcbb", "createdAt": "2026-07-28T02:49:24.000Z", "updatedAt": "2026-07-28T02:49:24.000Z", "uid": "35240-73f83c12-7601-48f9-a86b-3ebf2013bcbb" } ], "id": "7d73d23a-f248-4910-af17-8af2aa16ce61", "createdAt": "2026-07-28T02:49:24.000Z", "updatedAt": "2026-07-28T02:49:24.000Z", "uid": "35240-7d73d23a-f248-4910-af17-8af2aa16ce61" } ], "id": "88a9421b-1a99-4190-b2c2-09681f92847a", "createdAt": "2026-07-28T02:49:24.000Z", "updatedAt": "2026-07-28T02:49:24.000Z", "uid": "35240-88a9421b-1a99-4190-b2c2-09681f92847a" } ], "id": "2f97fe8d-8e93-4f44-a69f-b42c1ab5f008", "createdAt": "2026-07-28T02:49:24.000Z", "updatedAt": "2026-07-28T02:49:24.000Z", "uid": "35240-2f97fe8d-8e93-4f44-a69f-b42c1ab5f008" } ], "id": "1bff32b0-2e67-4614-8b23-bdc0ea0f3b8c", "createdAt": "2026-07-28T02:49:24.000Z", "updatedAt": "2026-07-28T02:49:24.000Z", "uid": "35240-1bff32b0-2e67-4614-8b23-bdc0ea0f3b8c" } ], "id": "11e1d6e6-0d08-453c-9ed1-f9b932b69e79", "createdAt": "2026-07-28T02:49:24.000Z", "updatedAt": "2026-07-28T02:49:24.000Z", "uid": "35240-11e1d6e6-0d08-453c-9ed1-f9b932b69e79" } ], "auth": { "type": "oauth2", "oauth2": [ { "key": "redirect_uri", "value": "https://platform.ringcentral.com/restapi/oauth/token", "type": "string" }, { "key": "accessTokenUrl", "value": "https://platform.ringcentral.com/restapi/oauth/token", "type": "string" }, { "key": "authUrl", "value": "https://platform.ringcentral.com/restapi/oauth/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "https://platform.ringcentral.com" } ] }