{"__v":53,"_id":"542ecc0a6b0eb6080066ca79","api":{"auth":"never","basic_auth":false,"params":[],"results":{"codes":[]},"settings":"","try":true,"url":""},"body":"Starting with Zang couldn't be easier. The first thing you need to do is [Sign Up](https://www.zang.io/signup) for an account. Once you have signed up, you'll notice that you now have a trial account. A trial account comes with some free credit that will allow you to experiment with our service. Developing on the Zang platform is actually free and you're only charged on a per-usage basis. Once you have experimented and/or tested your use case, you can upgrade to a production account by clicking on the *Request Production Access* button found in the Dashboard of your account. This will unlock the trial account restrictions and also allow you to add funds to your account. \n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Making a Call\"\n}\n[/block]\nAll you need are 3 things: \n\n1. Account SID and Auth Token (available on your [Dashboard](https://www.zang.io/dashboard)).\n2. The 'To' and 'From' numbers.\n3. The URL that Zang will reach out to for instructions once the call connects.\n\nMaking a call can be done a couple of ways.  We'll show you how to send an SMS via our API Explorer and using cURL.  To make a call using our API Explorer, you would need to log into your account, and follow these steps:\n\n1. Go to your Dashboard\n2. Click on Developers > API Explorer\n3. Select Calls -> Make Call\n4. Enter a number in 'From'.  This could be a Zang number or any other number. (Beware, you'll get charged extra for Caller ID Spoofing if the number is not a Zang number!)\n5. Enter a number in 'To' for the call to go to.\n6. Enter the URL in 'Url' for the call to go to once connected.(This could be an InboundXML document, you can find out more about that [here](http://docs.zang.io/docs/inboundxml-overview)\n7. Click 'Make Request'\n\nIf you have done this correctly, your call should be connected and sent to that URL!\n\nIn the following example, we'll show you how to make a call using cURL.\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"curl -X POST 'https://api.zang.io/v2/Accounts/{AccountSid}/Calls' -u '{AccountSid}:{AuthToken}' -d 'From=19082435612&To=19082340162&Url=http://zang.io/ivr/welcome/call'\",\n      \"language\": \"shell\"\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"body\": \"If you're using cURL on Windows, be sure to change those single quotes to double quotes!\"\n}\n[/block]\nHere's a breakdown of the cURL request:\n[block:parameters]\n{\n  \"data\": {\n    \"0-0\": \"'https://api.zang.io/v2/Accounts/{AccountSid}/Calls'\",\n    \"1-0\": \"-u '{AccountSid}:{AuthToken}'\",\n    \"2-0\": \"From=19082435612&To=19082340162&Url=http://zang.io/ivr/welcome/call'\",\n    \"1-1\": \"This is used for authentication. You must change **{AccountSID}** to reflect your Account SID which can be found in your Dashboard. You must also change **{AuthToken}** to reflect your AuthToken which can be found in your Dashboard as well. Make sure to remove the curly braces as they are just place holders in this example.\",\n    \"0-1\": \"This is the base URL where you send the request to. Note that there is **{AccountSid}** in this URL. You must change this to reflect your Account SID, which can be found in your Dashboard. Make sure to remove the curly braces as they are just place holders in this example.\",\n    \"2-1\": \"This is the meat of the request.  The 'From' will contain your chosen number.  The 'To' field will contain the destination number.  The 'Url' will contain the Url where the call will go once it's connected (This could be a InboundXML document).\"\n  },\n  \"cols\": 2,\n  \"rows\": 3\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Hint!\",\n  \"body\": \"If you are making a call using the API Explorer, here is a helpful tip. Once you have completed step 1 through step 6 from above, scroll down to the cURL example before clicking on 'Make Request'. You will notice that the cURL is now pre-populated with the parameters and appropriate authentication (Account SID and AuthToken) for you to use. Feel free to copy and paste!\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Sending an SMS\"\n}\n[/block]\nLike placing a call, it is super easy send an SMS!  All you need is the following:\n\n1. Account SID and Auth Token (available on your [Dashboard](https://www.zang.io/dashboard))\n2. An SMS-enabled Zang number (click [here](https://www.zang.io/numbers/buy/) to purchase one)\n3. The 'To' number (the destination number that your message will be sent to)\n4. The 'Body' (the actual message) \n\nSending an SMS can be done a couple of ways. We'll show you how to send an SMS via our API Explorer and using cURL. To send an SMS using our API Explorer, you would need to log into your account, and follow these steps:\n\n1. Go to your Dashboard\n2. Click on Developers > API Explorer\n3. Select SMS > Send SMS\n4. Select an SMS-enabled Zang number from the drop down menu under 'From'\n5. Enter an SMS capable 'To' number\n6. Enter your message under 'Body'\n7. Click 'Make Request'\n\nIf you have done this correctly, your SMS will be sent and you should now see the response details.\n\nIn the following example, we'll show you how to send an SMS using the cURL.\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"curl -X POST \\\"https://api.zang.io/v2/Accounts/{AccountSid}/SMS/Messages\\\" -u \\\"{AccountSid}:{AuthToken}\\\" \\\"To=19081523462&From=19087465123&Body=My First SMS!\\\"\",\n      \"language\": \"shell\"\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"body\": \"If you're using cURL on Windows, be sure to change those single quotes to double quotes!\"\n}\n[/block]\nHere's a breakdown of the cURL request:\n[block:parameters]\n{\n  \"data\": {\n    \"0-0\": \"\\\"https://api.zang.io/v2/Accounts/{AccountSid}/SMS/Message\\\"\",\n    \"0-1\": \"This is the base URL where you send the request to. Note that there is **{AccountSid}** in this URL. You must change this to reflect your Account SID, which can be found in your Dashboard. Make sure to remove the curly braces as they are just place holders in this example.\",\n    \"1-0\": \"-u \\\"{AccountSid}:{AuthToken}\\\"\",\n    \"1-1\": \"This is used for authentication. You must change **{AccountSID}** to reflect your Account SID which can be found in your Dashboard. You must also change **{AuthToken}** to reflect your AuthToken which can be found in your Dashboard as well. Make sure to remove the curly braces as they are just place holders in this example.\",\n    \"2-0\": \"\\\"To=19081523462&From=19087465123&Body=My First SMS!\\\"\",\n    \"2-1\": \"This is the meat of your SMS. The 'To' will contain your destination number. The 'From' will contain your SMS-enabled Zang number. The 'Body' will contain your message.\",\n    \"h-1\": \"Explanation\",\n    \"h-0\": \"Parameter\"\n  },\n  \"cols\": 2,\n  \"rows\": 3\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Hint!\",\n  \"body\": \"If you are sending an SMS using the API Explorer, here is a helpful tip. Once you have completed step 1 through step 6 from above, scroll down to the cURL example before clicking on 'Make Request'. You will notice that the cURL is now pre-populated with the parameters and appropriate authentication (Account SID and AuthToken) for you to use. Feel free to copy and paste!\"\n}\n[/block]\nThat's all there is to it! If you have made it this far, then maybe you are willing to go a little further. Please check out the rest of the documentation and feel free to experiment with InboundXML and the REST API!","category":"5453ea9547c30114004fb375","createdAt":"2014-10-02T21:05:19.081Z","excerpt":"This page will help you get started with Zang. You'll be up and running in a jiffy!","githubsync":"","hidden":false,"isReference":false,"is_link":false,"link_external":false,"link_url":"","next":{"description":"","pages":[]},"order":0,"parentDoc":null,"project":"542dbe0ecb19820800c1f4d7","slug":"getting-started","sync_unique":"","title":"Getting Started","type":"basic","updates":["577c19d25fd4de0e00cc3b85","57a8a59c2ad1150e009daaf1","582f2f67f5d0123900c326c3","5830926d6f9ee60f0062f334"],"user":"542dbdddcb19820800c1f4d6","version":"542ecc0a6b0eb6080066ca77","childrenPages":[]}

Getting Started

This page will help you get started with Zang. You'll be up and running in a jiffy!

Starting with Zang couldn't be easier. The first thing you need to do is [Sign Up](https://www.zang.io/signup) for an account. Once you have signed up, you'll notice that you now have a trial account. A trial account comes with some free credit that will allow you to experiment with our service. Developing on the Zang platform is actually free and you're only charged on a per-usage basis. Once you have experimented and/or tested your use case, you can upgrade to a production account by clicking on the *Request Production Access* button found in the Dashboard of your account. This will unlock the trial account restrictions and also allow you to add funds to your account. [block:api-header] { "type": "basic", "title": "Making a Call" } [/block] All you need are 3 things: 1. Account SID and Auth Token (available on your [Dashboard](https://www.zang.io/dashboard)). 2. The 'To' and 'From' numbers. 3. The URL that Zang will reach out to for instructions once the call connects. Making a call can be done a couple of ways. We'll show you how to send an SMS via our API Explorer and using cURL. To make a call using our API Explorer, you would need to log into your account, and follow these steps: 1. Go to your Dashboard 2. Click on Developers > API Explorer 3. Select Calls -> Make Call 4. Enter a number in 'From'. This could be a Zang number or any other number. (Beware, you'll get charged extra for Caller ID Spoofing if the number is not a Zang number!) 5. Enter a number in 'To' for the call to go to. 6. Enter the URL in 'Url' for the call to go to once connected.(This could be an InboundXML document, you can find out more about that [here](http://docs.zang.io/docs/inboundxml-overview) 7. Click 'Make Request' If you have done this correctly, your call should be connected and sent to that URL! In the following example, we'll show you how to make a call using cURL. [block:code] { "codes": [ { "code": "curl -X POST 'https://api.zang.io/v2/Accounts/{AccountSid}/Calls' -u '{AccountSid}:{AuthToken}' -d 'From=19082435612&To=19082340162&Url=http://zang.io/ivr/welcome/call'", "language": "shell" } ] } [/block] [block:callout] { "type": "warning", "body": "If you're using cURL on Windows, be sure to change those single quotes to double quotes!" } [/block] Here's a breakdown of the cURL request: [block:parameters] { "data": { "0-0": "'https://api.zang.io/v2/Accounts/{AccountSid}/Calls'", "1-0": "-u '{AccountSid}:{AuthToken}'", "2-0": "From=19082435612&To=19082340162&Url=http://zang.io/ivr/welcome/call'", "1-1": "This is used for authentication. You must change **{AccountSID}** to reflect your Account SID which can be found in your Dashboard. You must also change **{AuthToken}** to reflect your AuthToken which can be found in your Dashboard as well. Make sure to remove the curly braces as they are just place holders in this example.", "0-1": "This is the base URL where you send the request to. Note that there is **{AccountSid}** in this URL. You must change this to reflect your Account SID, which can be found in your Dashboard. Make sure to remove the curly braces as they are just place holders in this example.", "2-1": "This is the meat of the request. The 'From' will contain your chosen number. The 'To' field will contain the destination number. The 'Url' will contain the Url where the call will go once it's connected (This could be a InboundXML document)." }, "cols": 2, "rows": 3 } [/block] [block:callout] { "type": "info", "title": "Hint!", "body": "If you are making a call using the API Explorer, here is a helpful tip. Once you have completed step 1 through step 6 from above, scroll down to the cURL example before clicking on 'Make Request'. You will notice that the cURL is now pre-populated with the parameters and appropriate authentication (Account SID and AuthToken) for you to use. Feel free to copy and paste!" } [/block] [block:api-header] { "type": "basic", "title": "Sending an SMS" } [/block] Like placing a call, it is super easy send an SMS! All you need is the following: 1. Account SID and Auth Token (available on your [Dashboard](https://www.zang.io/dashboard)) 2. An SMS-enabled Zang number (click [here](https://www.zang.io/numbers/buy/) to purchase one) 3. The 'To' number (the destination number that your message will be sent to) 4. The 'Body' (the actual message) Sending an SMS can be done a couple of ways. We'll show you how to send an SMS via our API Explorer and using cURL. To send an SMS using our API Explorer, you would need to log into your account, and follow these steps: 1. Go to your Dashboard 2. Click on Developers > API Explorer 3. Select SMS > Send SMS 4. Select an SMS-enabled Zang number from the drop down menu under 'From' 5. Enter an SMS capable 'To' number 6. Enter your message under 'Body' 7. Click 'Make Request' If you have done this correctly, your SMS will be sent and you should now see the response details. In the following example, we'll show you how to send an SMS using the cURL. [block:code] { "codes": [ { "code": "curl -X POST \"https://api.zang.io/v2/Accounts/{AccountSid}/SMS/Messages\" -u \"{AccountSid}:{AuthToken}\" \"To=19081523462&From=19087465123&Body=My First SMS!\"", "language": "shell" } ] } [/block] [block:callout] { "type": "warning", "body": "If you're using cURL on Windows, be sure to change those single quotes to double quotes!" } [/block] Here's a breakdown of the cURL request: [block:parameters] { "data": { "0-0": "\"https://api.zang.io/v2/Accounts/{AccountSid}/SMS/Message\"", "0-1": "This is the base URL where you send the request to. Note that there is **{AccountSid}** in this URL. You must change this to reflect your Account SID, which can be found in your Dashboard. Make sure to remove the curly braces as they are just place holders in this example.", "1-0": "-u \"{AccountSid}:{AuthToken}\"", "1-1": "This is used for authentication. You must change **{AccountSID}** to reflect your Account SID which can be found in your Dashboard. You must also change **{AuthToken}** to reflect your AuthToken which can be found in your Dashboard as well. Make sure to remove the curly braces as they are just place holders in this example.", "2-0": "\"To=19081523462&From=19087465123&Body=My First SMS!\"", "2-1": "This is the meat of your SMS. The 'To' will contain your destination number. The 'From' will contain your SMS-enabled Zang number. The 'Body' will contain your message.", "h-1": "Explanation", "h-0": "Parameter" }, "cols": 2, "rows": 3 } [/block] [block:callout] { "type": "info", "title": "Hint!", "body": "If you are sending an SMS using the API Explorer, here is a helpful tip. Once you have completed step 1 through step 6 from above, scroll down to the cURL example before clicking on 'Make Request'. You will notice that the cURL is now pre-populated with the parameters and appropriate authentication (Account SID and AuthToken) for you to use. Feel free to copy and paste!" } [/block] That's all there is to it! If you have made it this far, then maybe you are willing to go a little further. Please check out the rest of the documentation and feel free to experiment with InboundXML and the REST API!