{"metadata":{"image":[],"title":"","description":""},"api":{"url":"/accounts/:account_id/sms","auth":"required","settings":"","examples":{"codes":[{"language":"php","code":"<?php\n\n$curl = curl_init();\n\ncurl_setopt_array($curl, array(\n    CURLOPT_URL => \"https://api.phone.com/v4/accounts/345765/sms\",\n    CURLOPT_RETURNTRANSFER => true,\n    CURLOPT_ENCODING => \"\",\n    CURLOPT_MAXREDIRS => 10,\n    CURLOPT_TIMEOUT => 30,\n    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,\n    CURLOPT_CUSTOMREQUEST => \"POST\",\n    CURLOPT_POSTFIELDS => '{ \"from\": \"+12015880100\", \"to\": [\"+17328810138\", \"+17324840911\"], \"text\": \"Hello from Phone.com\" }',\n    CURLOPT_HTTPHEADER => array(\n        \"authorization: Bearer 5CoImLE8cSNrJNDqT1gNgREVFK6nDGYS9FbBakHl\",\n        \"cache-control: no-cache\",\n        \"content-type: application/json\",\n  ),\n));\n\n$response = curl_exec($curl);\n$err = curl_error($curl);\n\ncurl_close($curl);\n\nif ($err) {\n    echo \"cURL Error #:\" . $err;\n} else {\n    echo $response;\n}"}]},"method":"post","params":[{"name":"account_id","type":"int","default":"","desc":"Account ID","required":false,"in":"path","ref":"","_id":"56fac74b6c4e0e1900b1d820"},{"name":"from","type":"string","default":"","desc":"Phone number of sender","required":true,"in":"body","ref":"","_id":"56fac74b6c4e0e1900b1d81e"},{"name":"to","type":"string","default":"","desc":"Outgoing destination numbers","required":true,"in":"body","ref":"","_id":"56faca7ee982ce220059bad3"},{"name":"text","type":"string","default":"","desc":"Text body of the outgoing SMS message.","required":true,"in":"body","ref":"","_id":"56faca7ee982ce220059bad2"},{"name":"extension_id","type":"int","default":"","desc":"ID of Extension where the sms is saved","required":false,"in":"body","ref":"","_id":"588b448970e57b2f0031b624"}],"results":{"codes":[{"name":"","status":201,"language":"json","code":"{\n    \"from\": \"+12015880100\",\n    \"to\": [\n        {\n            \"number\": \"+17328810138\",\n            \"status\": \"sent\",\n            \"id\": \"07beccb9b60eeb9dec91a0ac76844cc0066c31b4\"\n        },\n        {\n            \"number\": \"+17324840911\",\n            \"status\": \"delivered\",\n            \"id\": \"4224659aaf2c1a3ba2ede8d5c4c244b67c8464b5\",\n            \"sent_at\": 1506974539,\n            \"delivered_at\": 1506974539\n        }\n    ], \n    \"direction\": \"out\",\n    \"created_epoch\": 1506974539,\n    \"created_at\": \"2017-10-02T20:02:19+00:00\",\n    \"is_new\": true,\n    \"text\": \"Hello from Phone.com\",\n    \"extension\": {\n        \"id\": 709038,\n        \"voip_id\": 345765,\n        \"name\": \"Home 1\",\n        \"extension\": 18\n    }\n}"}]}},"next":{"description":"","pages":[]},"title":"Create SMS","type":"endpoint","slug":"create-account-sms","excerpt":"Send a SMS to one or a group of recipients.  For details on the input fields, see [Intro to SMS](doc:account-sms).\n\nNote: This API is for users with Account Owner scope access token. Users with Extension User scope token should invoke the Extension level Create SMS API with the following definition:\n\nPOST https://api.phone.com/v4/accounts/:account_id/extensions/:extension_id/sms","body":"[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"Assign extension to store outbound messages\",\n  \"body\": \"If extension_id is not set in the post body, a default extension must be set for the \\\"from\\\" phone number in order to save the outbound messages into the Phone.com system.  On the Create Phone Number and Replace Phone Number API's, there is a sms_forwarding field which may be used to set the default extension.\\n\\n* [Create Phone Number](doc:create-account-phone-number)\\n* [Replace Phone Number](doc:replace-account-phone-number)\"\n}\n[/block]","updates":[],"order":3,"isReference":true,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"580527255703391b003dd137","githubsync":"","parentDoc":null,"user":"56f99ab84d2b4f3400edb636","__v":5,"createdAt":"2016-10-17T19:31:49.511Z","project":"55c8cff571d7580d0063a5e5","version":{"version":"4","version_clean":"4.0.0","codename":"","is_stable":true,"is_beta":true,"is_hidden":false,"is_deprecated":false,"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","5ba8fd1a4c8c220003a08f0f","5ede526e75bc22005d0adecc"],"_id":"57624356653c2d2200fec79c","createdAt":"2016-06-16T06:12:38.244Z","releaseDate":"2016-06-16T06:12:38.244Z","__v":23,"project":"55c8cff571d7580d0063a5e5"},"category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Account SMS","slug":"account-sms","order":26,"from_sync":false,"reference":true,"_id":"5804d12d16161c0f0077df9b","project":"55c8cff571d7580d0063a5e5","version":"57624356653c2d2200fec79c","__v":0,"createdAt":"2016-10-17T13:25:01.088Z"}}