{"_id":"588b5ed36aca6f2500d11554","project":"55c8cff571d7580d0063a5e5","category":{"_id":"588b5e5f2966b2230009cbf9","project":"55c8cff571d7580d0063a5e5","version":"57624356653c2d2200fec79c","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2017-01-27T14:51:11.181Z","from_sync":false,"order":6,"slug":"account-calls","title":"Account Calls"},"user":"56f99ab84d2b4f3400edb636","version":{"_id":"57624356653c2d2200fec79c","__v":21,"project":"55c8cff571d7580d0063a5e5","createdAt":"2016-06-16T06:12:38.244Z","releaseDate":"2016-06-16T06:12:38.244Z","categories":["57624356653c2d2200fec79d","57624356653c2d2200fec79e","57624356653c2d2200fec79f","57624356653c2d2200fec7a0","57624356653c2d2200fec7a1","57624356653c2d2200fec7a2","57624356653c2d2200fec7a3","57624356653c2d2200fec7a4","57624356653c2d2200fec7a5","57624356653c2d2200fec7a6","57624356653c2d2200fec7a7","57624356653c2d2200fec7a8","57624356653c2d2200fec7a9","57624356653c2d2200fec7aa","5779ca1b99b40b0e005abb3a","5779d198aea88b0e00f63277","5797d3ab17ced017003c4be4","57ac170ef1cdae0e0053cdfc","57dbfc723ed3450e00dc9e6d","5804d12d16161c0f0077df9b","5841064b652e5b0f0015a7c8","588b5e5f2966b2230009cbf9","58a68ebf3239fa0f00857619","58c23c8b4922930f0050ac91","58fd1460809fc30f00f2ee07","5934eaf5328680002d77de6a","594bf91601cfe6000f40f4c5","595c4ed696b447001ba0cf6d","596524495cee50001575f5be","5970d4f1313162004dd303b5","59780fac24dbd1001a1fa057","59a8cfd3ead78a002d63cafe","59e0323d93da1f001c9ec170","5b0c16f2be9fcb0003e28222"],"is_deprecated":false,"is_hidden":false,"is_beta":true,"is_stable":true,"codename":"","version_clean":"4.0.0","version":"4"},"__v":0,"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-01-27T14:53:07.195Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"settings":"","results":{"codes":[]},"auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"Note: This API is for users with Account Owner scope access token.  Users with Extension User scope token should invoke the Calls API with the following definition:\\n\\nhttps://api.phone.com/v4/accounts/:account_id/extensions/:extension_id/calls\"\n}\n[/block]\n## Supported Services\n* [Create Calls](doc:create-account-calls) \n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Extension ID\",\n  \"body\": \"Please note that Extension ID mentioned below is the system ID of the Extension Number.  Users may need to use the List Extension API to find the Extension ID.\"\n}\n[/block]\nWe currently support three calling scenarios:\n\n1.  Place a call from a DID to my extension, required parameters are:\n      a.  Caller Phone Number\n      b.  Callee Extension ID\n\n2.  Place a call from a DID to another DID, required parameters are:\n      a.  Caller Phone Number\n      b.  Callee Phone Number\n      c.  Caller Extension ID\n\n3.  Place a call from my Extension to a DID, required parameters are:\n      a.  Caller Extension ID\n      b.  Callee Phone Number\n\n\n\nThe Calls API supports caller ID, an user may specify the caller caller ID or the callee caller ID.  The following rules are applied when a caller ID is provided.\n\n1.  The caller caller ID must be the same as the callee phone number, or a phone number owned by the user account\n2.  The callee caller ID must be the same as the caller phone number, or a phone number owned by the user account\n\nUser may also set the caller caller ID or callee caller ID to 'private' by setting flag caller_private and callee_private to true respectively.","excerpt":"This API places a call to the caller phone number (or caller extension ID). If that number (or extension) answers within the timeout period, then the callee DID (or extension) will be connected to the call.","slug":"account-calls","type":"basic","title":"Calls"}

Calls

This API places a call to the caller phone number (or caller extension ID). If that number (or extension) answers within the timeout period, then the callee DID (or extension) will be connected to the call.

[block:callout] { "type": "info", "body": "Note: This API is for users with Account Owner scope access token. Users with Extension User scope token should invoke the Calls API with the following definition:\n\nhttps://api.phone.com/v4/accounts/:account_id/extensions/:extension_id/calls" } [/block] ## Supported Services * [Create Calls](doc:create-account-calls) [block:callout] { "type": "info", "title": "Extension ID", "body": "Please note that Extension ID mentioned below is the system ID of the Extension Number. Users may need to use the List Extension API to find the Extension ID." } [/block] We currently support three calling scenarios: 1. Place a call from a DID to my extension, required parameters are: a. Caller Phone Number b. Callee Extension ID 2. Place a call from a DID to another DID, required parameters are: a. Caller Phone Number b. Callee Phone Number c. Caller Extension ID 3. Place a call from my Extension to a DID, required parameters are: a. Caller Extension ID b. Callee Phone Number The Calls API supports caller ID, an user may specify the caller caller ID or the callee caller ID. The following rules are applied when a caller ID is provided. 1. The caller caller ID must be the same as the callee phone number, or a phone number owned by the user account 2. The callee caller ID must be the same as the caller phone number, or a phone number owned by the user account User may also set the caller caller ID or callee caller ID to 'private' by setting flag caller_private and callee_private to true respectively.