Back to Collection Items
IncludeFile "CkStringBuilder.pb"
IncludeFile "CkHttpResponse.pb"
IncludeFile "CkHttp.pb"
IncludeFile "CkJsonObject.pb"
IncludeFile "CkHttpRequest.pb"
IncludeFile "CkDtObj.pb"
Procedure ChilkatExample()
; This example assumes the Chilkat API to have been previously unlocked.
; See Global Unlock Sample for sample code.
http.i = CkHttp::ckCreate()
If http.i = 0
Debug "Failed to create object."
ProcedureReturn
EndIf
success.i
CkHttp::setCkBasicAuth(http, 1)
CkHttp::setCkLogin(http, "{{TWILIO_ACCOUNT_SID}}")
CkHttp::setCkPassword(http, "{{TWILIO_AUTH_TOKEN}}")
req.i = CkHttpRequest::ckCreate()
If req.i = 0
Debug "Failed to create object."
ProcedureReturn
EndIf
CkHttpRequest::ckAddParam(req,"PhoneNumber","+12513060906")
resp.i = CkHttp::ckPostUrlEncoded(http,"https://api.twilio.com/2010-04-01/Accounts/:AccountSid/IncomingPhoneNumbers.json",req)
If CkHttp::ckLastMethodSuccess(http) = 0
Debug CkHttp::ckLastErrorText(http)
CkHttp::ckDispose(http)
CkHttpRequest::ckDispose(req)
ProcedureReturn
EndIf
sbResponseBody.i = CkStringBuilder::ckCreate()
If sbResponseBody.i = 0
Debug "Failed to create object."
ProcedureReturn
EndIf
CkHttpResponse::ckGetBodySb(resp,sbResponseBody)
jResp.i = CkJsonObject::ckCreate()
If jResp.i = 0
Debug "Failed to create object."
ProcedureReturn
EndIf
CkJsonObject::ckLoadSb(jResp,sbResponseBody)
CkJsonObject::setCkEmitCompact(jResp, 0)
Debug "Response Body:"
Debug CkJsonObject::ckEmit(jResp)
respStatusCode.i = CkHttpResponse::ckStatusCode(resp)
Debug "Response Status Code = " + Str(respStatusCode)
If respStatusCode >= 400
Debug "Response Header:"
Debug CkHttpResponse::ckHeader(resp)
Debug "Failed."
CkHttpResponse::ckDispose(resp)
CkHttp::ckDispose(http)
CkHttpRequest::ckDispose(req)
CkStringBuilder::ckDispose(sbResponseBody)
CkJsonObject::ckDispose(jResp)
ProcedureReturn
EndIf
CkHttpResponse::ckDispose(resp)
; Sample JSON response:
; (Sample code for parsing the JSON response is shown below)
; {
; "account_sid": "ACB6",
; "address_requirements": "foreign",
; "address_sid": "ADeA",
; "api_version": "reprehenderit laborum Excepteur",
; "beta": false,
; "bundle_sid": "BUB2",
; "capabilities": {},
; "date_created": "incididunt ad",
; "date_updated": "consequat nostrud non Excepteur",
; "emergency_address_sid": "ADAd",
; "emergency_status": "Inactive",
; "friendly_name": "Excepteur qui aute occaecat",
; "identity_sid": "RI4F",
; "origin": "ex sit non",
; "phone_number": "incididunt",
; "sid": "PNFd",
; "sms_application_sid": "APD1",
; "sms_fallback_method": "put",
; "sms_fallback_url": "https://sqnVhokvKfX.ggVS",
; "sms_method": "delete",
; "sms_url": "http://KvTTK.eixDOBAKnXDodC",
; "status": "Duis est",
; "status_callback": "https://lukPySBKCSJZRDfZeLGCQEJiiZlrSGtT.slbsog2f2Byb3SNOpnvFCnKiEUbexVWC5tK9Qaj0IFkIVhVKN+mNB826euAwsZOYNBGrdhphsN",
; "status_callback_method": "HEAD",
; "trunk_sid": "TK29",
; "uri": "http://efvlxkNPQlPFtoHjtYEM.qceW6gOSsyL5X8uZPGhiRrpPWucrUmJlQexyf4Dl9T7ahcoPDgC3k2TRG",
; "voice_application_sid": "AP5b",
; "voice_caller_id_lookup": true,
; "voice_fallback_method": "head",
; "voice_fallback_url": "https://YYJSXXIemHJDgyPulvPuSDhUfIJ.ofhsUNmlqzZSTo7nnhXYYLQgunn2ScfFWt4qoJ,M2zYA,",
; "voice_method": "PATCH",
; "voice_receive_mode": "voice",
; "voice_url": "https://lNOljQzheebolftPuuCa.qjzdVdF,m6lXjsq+rV4sijQkntubbHInkrQaJO2zBraF0"
; }
; Sample code for parsing the JSON response...
; Use this online tool to generate parsing code from sample JSON: Generate JSON Parsing Code
date_created.i = CkDtObj::ckCreate()
If date_created.i = 0
Debug "Failed to create object."
ProcedureReturn
EndIf
date_updated.i = CkDtObj::ckCreate()
If date_updated.i = 0
Debug "Failed to create object."
ProcedureReturn
EndIf
account_sid.s = CkJsonObject::ckStringOf(jResp,"account_sid")
address_requirements.s = CkJsonObject::ckStringOf(jResp,"address_requirements")
address_sid.s = CkJsonObject::ckStringOf(jResp,"address_sid")
api_version.s = CkJsonObject::ckStringOf(jResp,"api_version")
beta.i = CkJsonObject::ckBoolOf(jResp,"beta")
bundle_sid.s = CkJsonObject::ckStringOf(jResp,"bundle_sid")
CkJsonObject::ckDtOf(jResp,"date_created",0,date_created)
CkJsonObject::ckDtOf(jResp,"date_updated",0,date_updated)
emergency_address_sid.s = CkJsonObject::ckStringOf(jResp,"emergency_address_sid")
emergency_status.s = CkJsonObject::ckStringOf(jResp,"emergency_status")
friendly_name.s = CkJsonObject::ckStringOf(jResp,"friendly_name")
identity_sid.s = CkJsonObject::ckStringOf(jResp,"identity_sid")
origin.s = CkJsonObject::ckStringOf(jResp,"origin")
phone_number.s = CkJsonObject::ckStringOf(jResp,"phone_number")
sid.s = CkJsonObject::ckStringOf(jResp,"sid")
sms_application_sid.s = CkJsonObject::ckStringOf(jResp,"sms_application_sid")
sms_fallback_method.s = CkJsonObject::ckStringOf(jResp,"sms_fallback_method")
sms_fallback_url.s = CkJsonObject::ckStringOf(jResp,"sms_fallback_url")
sms_method.s = CkJsonObject::ckStringOf(jResp,"sms_method")
sms_url.s = CkJsonObject::ckStringOf(jResp,"sms_url")
status.s = CkJsonObject::ckStringOf(jResp,"status")
status_callback.s = CkJsonObject::ckStringOf(jResp,"status_callback")
status_callback_method.s = CkJsonObject::ckStringOf(jResp,"status_callback_method")
trunk_sid.s = CkJsonObject::ckStringOf(jResp,"trunk_sid")
uri.s = CkJsonObject::ckStringOf(jResp,"uri")
voice_application_sid.s = CkJsonObject::ckStringOf(jResp,"voice_application_sid")
voice_caller_id_lookup.i = CkJsonObject::ckBoolOf(jResp,"voice_caller_id_lookup")
voice_fallback_method.s = CkJsonObject::ckStringOf(jResp,"voice_fallback_method")
voice_fallback_url.s = CkJsonObject::ckStringOf(jResp,"voice_fallback_url")
voice_method.s = CkJsonObject::ckStringOf(jResp,"voice_method")
voice_receive_mode.s = CkJsonObject::ckStringOf(jResp,"voice_receive_mode")
voice_url.s = CkJsonObject::ckStringOf(jResp,"voice_url")
CkHttp::ckDispose(http)
CkHttpRequest::ckDispose(req)
CkStringBuilder::ckDispose(sbResponseBody)
CkJsonObject::ckDispose(jResp)
CkDtObj::ckDispose(date_created)
CkDtObj::ckDispose(date_updated)
ProcedureReturn
EndProcedure
Curl Command
curl -X POST
-u '{{TWILIO_ACCOUNT_SID}}:{{TWILIO_AUTH_TOKEN}}'
-H "Content-Type: application/x-www-form-urlencoded"
--data-urlencode 'PhoneNumber=+12513060906'
https://api.twilio.com/2010-04-01/Accounts/:AccountSid/IncomingPhoneNumbers.json
Postman Collection Item JSON
{
"name": "Buy a phone number",
"event": [
{
"listen": "test",
"script": {
"exec": [
"var jsonData = JSON.parse(responseBody);",
"postman.setEnvironmentVariable('TWILIO_PHONE_NUMBER', jsonData.phone_number);"
],
"type": "text/javascript"
}
}
],
"request": {
"auth": {
"type": "basic",
"basic": [
{
"key": "password",
"value": "{{TWILIO_AUTH_TOKEN}}",
"type": "string"
},
{
"key": "username",
"value": "{{TWILIO_ACCOUNT_SID}}",
"type": "string"
}
]
},
"method": "POST",
"header": [
{
"key": "Content-Type",
"value": "application/x-www-form-urlencoded"
}
],
"body": {
"mode": "urlencoded",
"urlencoded": [
{
"key": "PhoneNumber",
"value": "+12513060906",
"description": "The phone number to purchase specified in [E.164](https://www.twilio.com/docs/glossary/what-e164) format. E.164 phone numbers consist of a + followed by the country code and subscriber number without punctuation characters. For example, +14155551234."
},
{
"key": "AddressSid",
"value": "<string>",
"description": "The SID of the Address resource we should associate with the new phone number. Some regions require addresses to meet local regulations.",
"disabled": true
},
{
"key": "ApiVersion",
"value": "<string>",
"description": "The API version to use for incoming calls made to the new phone number. The default is `2010-04-01`.",
"disabled": true
},
{
"key": "AreaCode",
"value": "<string>",
"description": "The desired area code for your new incoming phone number. Can be any three-digit, US or Canada area code. We will provision an available phone number within this area code for you. **You must provide an `area_code` or a `phone_number`.** (US and Canada only).",
"disabled": true
},
{
"key": "BundleSid",
"value": "<string>",
"description": "The SID of the Bundle resource that you associate with the phone number. Some regions require a Bundle to meet local Regulations.",
"disabled": true
},
{
"key": "EmergencyAddressSid",
"value": "<string>",
"description": "The SID of the emergency address configuration to use for emergency calling from the new phone number.",
"disabled": true
},
{
"key": "EmergencyStatus",
"value": "<string>",
"description": "The configuration status parameter that determines whether the new phone number is enabled for emergency calling. (This can only be one of Active,Inactive)",
"disabled": true
},
{
"key": "FriendlyName",
"value": "<string>",
"description": "A descriptive string that you created to describe the new phone number. It can be up to 64 characters long. By default, this is a formatted version of the new phone number.",
"disabled": true
},
{
"key": "IdentitySid",
"value": "<string>",
"description": "The SID of the Identity resource that we should associate with the new phone number. Some regions require an identity to meet local regulations.",
"disabled": true
},
{
"key": "SmsApplicationSid",
"value": "<string>",
"description": "The SID of the application that should handle SMS messages sent to the new phone number. If an `sms_application_sid` is present, we ignore all of the `sms_*_url` urls and use those set on the application.",
"disabled": true
},
{
"key": "SmsFallbackMethod",
"value": "<string>",
"description": "The HTTP method that we should use to call `sms_fallback_url`. Can be: `GET` or `POST` and defaults to `POST`. (This can only be one of head,get,post,patch,put,delete,HEAD,GET,POST,PATCH,PUT,DELETE)",
"disabled": true
},
{
"key": "SmsFallbackUrl",
"value": "<uri>",
"description": "The URL that we should call when an error occurs while requesting or executing the TwiML defined by `sms_url`.",
"disabled": true
},
{
"key": "SmsMethod",
"value": "<string>",
"description": "The HTTP method that we should use to call `sms_url`. Can be: `GET` or `POST` and defaults to `POST`. (This can only be one of head,get,post,patch,put,delete,HEAD,GET,POST,PATCH,PUT,DELETE)",
"disabled": true
},
{
"key": "SmsUrl",
"value": "<uri>",
"description": "The URL we should call when the new phone number receives an incoming SMS message.",
"disabled": true
},
{
"key": "StatusCallback",
"value": "<uri>",
"description": "The URL we should call using the `status_callback_method` to send status information to your application.",
"disabled": true
},
{
"key": "StatusCallbackMethod",
"value": "<string>",
"description": "The HTTP method we should use to call `status_callback`. Can be: `GET` or `POST` and defaults to `POST`. (This can only be one of head,get,post,patch,put,delete,HEAD,GET,POST,PATCH,PUT,DELETE)",
"disabled": true
},
{
"key": "TrunkSid",
"value": "<string>",
"description": "The SID of the Trunk we should use to handle calls to the new phone number. If a `trunk_sid` is present, we ignore all of the voice urls and voice applications and use only those set on the Trunk. Setting a `trunk_sid` will automatically delete your `voice_application_sid` and vice versa.",
"disabled": true
},
{
"key": "VoiceApplicationSid",
"value": "<string>",
"description": "The SID of the application we should use to handle calls to the new phone number. If a `voice_application_sid` is present, we ignore all of the voice urls and use only those set on the application. Setting a `voice_application_sid` will automatically delete your `trunk_sid` and vice versa.",
"disabled": true
},
{
"key": "VoiceCallerIdLookup",
"value": "<boolean>",
"description": "Whether to lookup the caller's name from the CNAM database and post it to your app. Can be: `true` or `false` and defaults to `false`.",
"disabled": true
},
{
"key": "VoiceFallbackMethod",
"value": "<string>",
"description": "The HTTP method that we should use to call `voice_fallback_url`. Can be: `GET` or `POST` and defaults to `POST`. (This can only be one of head,get,post,patch,put,delete,HEAD,GET,POST,PATCH,PUT,DELETE)",
"disabled": true
},
{
"key": "VoiceFallbackUrl",
"value": "<uri>",
"description": "The URL that we should call when an error occurs retrieving or executing the TwiML requested by `url`.",
"disabled": true
},
{
"key": "VoiceMethod",
"value": "<string>",
"description": "The HTTP method that we should use to call `voice_url`. Can be: `GET` or `POST` and defaults to `POST`. (This can only be one of head,get,post,patch,put,delete,HEAD,GET,POST,PATCH,PUT,DELETE)",
"disabled": true
},
{
"key": "VoiceReceiveMode",
"value": "<string>",
"description": "The configuration parameter for the new phone number to receive incoming voice calls or faxes. Can be: `fax` or `voice` and defaults to `voice`. (This can only be one of voice,fax)",
"disabled": true
},
{
"key": "VoiceUrl",
"value": "<uri>",
"description": "The URL that we should call to answer a call to the new phone number. The `voice_url` will not be called if a `voice_application_sid` or a `trunk_sid` is set.",
"disabled": true
}
]
},
"url": {
"raw": "{{2010-04-01-Accounts-AccountSid-IncomingPhoneNumbers.json-Url}}/2010-04-01/Accounts/:AccountSid/IncomingPhoneNumbers.json",
"host": [
"{{2010-04-01-Accounts-AccountSid-IncomingPhoneNumbers.json-Url}}"
],
"path": [
"2010-04-01",
"Accounts",
":AccountSid",
"IncomingPhoneNumbers.json"
],
"variable": [
{
"key": "AccountSid",
"value": "{{TWILIO_ACCOUNT_SID}}",
"description": "(Required) The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that will create the resource."
}
]
},
"description": "Purchase a phone-number for your Twilio account. Afterwards you can use this number to send or receive SMS and calls.\n\nRead more about it in the [Twilio Docs](https://www.twilio.com/docs/phone-numbers/api/incomingphonenumber-resource#create-an-incomingphonenumber-resource)"
},
"response": [
{
"name": "Created",
"originalRequest": {
"method": "POST",
"header": [
{
"description": "Added as a part of security scheme: basic",
"key": "Authorization",
"value": "Basic <credentials>"
}
],
"body": {
"mode": "urlencoded",
"urlencoded": [
{
"key": "AddressSid",
"value": "<string>",
"description": "The SID of the Address resource we should associate with the new phone number. Some regions require addresses to meet local regulations."
},
{
"key": "ApiVersion",
"value": "<string>",
"description": "The API version to use for incoming calls made to the new phone number. The default is `2010-04-01`."
},
{
"key": "AreaCode",
"value": "<string>",
"description": "The desired area code for your new incoming phone number. Can be any three-digit, US or Canada area code. We will provision an available phone number within this area code for you. **You must provide an `area_code` or a `phone_number`.** (US and Canada only)."
},
{
"key": "BundleSid",
"value": "<string>",
"description": "The SID of the Bundle resource that you associate with the phone number. Some regions require a Bundle to meet local Regulations."
},
{
"key": "EmergencyAddressSid",
"value": "<string>",
"description": "The SID of the emergency address configuration to use for emergency calling from the new phone number."
},
{
"key": "EmergencyStatus",
"value": "<string>",
"description": "The configuration status parameter that determines whether the new phone number is enabled for emergency calling. (This can only be one of Active,Inactive)"
},
{
"key": "FriendlyName",
"value": "<string>",
"description": "A descriptive string that you created to describe the new phone number. It can be up to 64 characters long. By default, this is a formatted version of the new phone number."
},
{
"key": "IdentitySid",
"value": "<string>",
"description": "The SID of the Identity resource that we should associate with the new phone number. Some regions require an identity to meet local regulations."
},
{
"key": "PhoneNumber",
"value": "<string>",
"description": "The phone number to purchase specified in [E.164](https://www.twilio.com/docs/glossary/what-e164) format. E.164 phone numbers consist of a + followed by the country code and subscriber number without punctuation characters. For example, +14155551234."
},
{
"key": "SmsApplicationSid",
"value": "<string>",
"description": "The SID of the application that should handle SMS messages sent to the new phone number. If an `sms_application_sid` is present, we ignore all of the `sms_*_url` urls and use those set on the application."
},
{
"key": "SmsFallbackMethod",
"value": "<string>",
"description": "The HTTP method that we should use to call `sms_fallback_url`. Can be: `GET` or `POST` and defaults to `POST`. (This can only be one of head,get,post,patch,put,delete,HEAD,GET,POST,PATCH,PUT,DELETE)"
},
{
"key": "SmsFallbackUrl",
"value": "<uri>",
"description": "The URL that we should call when an error occurs while requesting or executing the TwiML defined by `sms_url`."
},
{
"key": "SmsMethod",
"value": "<string>",
"description": "The HTTP method that we should use to call `sms_url`. Can be: `GET` or `POST` and defaults to `POST`. (This can only be one of head,get,post,patch,put,delete,HEAD,GET,POST,PATCH,PUT,DELETE)"
},
{
"key": "SmsUrl",
"value": "<uri>",
"description": "The URL we should call when the new phone number receives an incoming SMS message."
},
{
"key": "StatusCallback",
"value": "<uri>",
"description": "The URL we should call using the `status_callback_method` to send status information to your application."
},
{
"key": "StatusCallbackMethod",
"value": "<string>",
"description": "The HTTP method we should use to call `status_callback`. Can be: `GET` or `POST` and defaults to `POST`. (This can only be one of head,get,post,patch,put,delete,HEAD,GET,POST,PATCH,PUT,DELETE)"
},
{
"key": "TrunkSid",
"value": "<string>",
"description": "The SID of the Trunk we should use to handle calls to the new phone number. If a `trunk_sid` is present, we ignore all of the voice urls and voice applications and use only those set on the Trunk. Setting a `trunk_sid` will automatically delete your `voice_application_sid` and vice versa."
},
{
"key": "VoiceApplicationSid",
"value": "<string>",
"description": "The SID of the application we should use to handle calls to the new phone number. If a `voice_application_sid` is present, we ignore all of the voice urls and use only those set on the application. Setting a `voice_application_sid` will automatically delete your `trunk_sid` and vice versa."
},
{
"key": "VoiceCallerIdLookup",
"value": "<boolean>",
"description": "Whether to lookup the caller's name from the CNAM database and post it to your app. Can be: `true` or `false` and defaults to `false`."
},
{
"key": "VoiceFallbackMethod",
"value": "<string>",
"description": "The HTTP method that we should use to call `voice_fallback_url`. Can be: `GET` or `POST` and defaults to `POST`. (This can only be one of head,get,post,patch,put,delete,HEAD,GET,POST,PATCH,PUT,DELETE)"
},
{
"key": "VoiceFallbackUrl",
"value": "<uri>",
"description": "The URL that we should call when an error occurs retrieving or executing the TwiML requested by `url`."
},
{
"key": "VoiceMethod",
"value": "<string>",
"description": "The HTTP method that we should use to call `voice_url`. Can be: `GET` or `POST` and defaults to `POST`. (This can only be one of head,get,post,patch,put,delete,HEAD,GET,POST,PATCH,PUT,DELETE)"
},
{
"key": "VoiceReceiveMode",
"value": "<string>",
"description": "The configuration parameter for the new phone number to receive incoming voice calls or faxes. Can be: `fax` or `voice` and defaults to `voice`. (This can only be one of voice,fax)"
},
{
"key": "VoiceUrl",
"value": "<uri>",
"description": "The URL that we should call to answer a call to the new phone number. The `voice_url` will not be called if a `voice_application_sid` or a `trunk_sid` is set."
}
]
},
"url": {
"raw": "{{2010-04-01-Accounts-AccountSid-IncomingPhoneNumbers.json-Url}}/2010-04-01/Accounts/:AccountSid/IncomingPhoneNumbers.json",
"host": [
"{{2010-04-01-Accounts-AccountSid-IncomingPhoneNumbers.json-Url}}"
],
"path": [
"2010-04-01",
"Accounts",
":AccountSid",
"IncomingPhoneNumbers.json"
],
"variable": [
{
"key": "AccountSid"
}
]
}
},
"status": "Created",
"code": 201,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"cookie": [
],
"body": "{\n \"account_sid\": \"ACB6\",\n \"address_requirements\": \"foreign\",\n \"address_sid\": \"ADeA\",\n \"api_version\": \"reprehenderit laborum Excepteur\",\n \"beta\": false,\n \"bundle_sid\": \"BUB2\",\n \"capabilities\": {},\n \"date_created\": \"incididunt ad\",\n \"date_updated\": \"consequat nostrud non Excepteur\",\n \"emergency_address_sid\": \"ADAd\",\n \"emergency_status\": \"Inactive\",\n \"friendly_name\": \"Excepteur qui aute occaecat\",\n \"identity_sid\": \"RI4F\",\n \"origin\": \"ex sit non\",\n \"phone_number\": \"incididunt\",\n \"sid\": \"PNFd\",\n \"sms_application_sid\": \"APD1\",\n \"sms_fallback_method\": \"put\",\n \"sms_fallback_url\": \"https://sqnVhokvKfX.ggVS\",\n \"sms_method\": \"delete\",\n \"sms_url\": \"http://KvTTK.eixDOBAKnXDodC\",\n \"status\": \"Duis est\",\n \"status_callback\": \"https://lukPySBKCSJZRDfZeLGCQEJiiZlrSGtT.slbsog2f2Byb3SNOpnvFCnKiEUbexVWC5tK9Qaj0IFkIVhVKN+mNB826euAwsZOYNBGrdhphsN\",\n \"status_callback_method\": \"HEAD\",\n \"trunk_sid\": \"TK29\",\n \"uri\": \"http://efvlxkNPQlPFtoHjtYEM.qceW6gOSsyL5X8uZPGhiRrpPWucrUmJlQexyf4Dl9T7ahcoPDgC3k2TRG\",\n \"voice_application_sid\": \"AP5b\",\n \"voice_caller_id_lookup\": true,\n \"voice_fallback_method\": \"head\",\n \"voice_fallback_url\": \"https://YYJSXXIemHJDgyPulvPuSDhUfIJ.ofhsUNmlqzZSTo7nnhXYYLQgunn2ScfFWt4qoJ,M2zYA,\",\n \"voice_method\": \"PATCH\",\n \"voice_receive_mode\": \"voice\",\n \"voice_url\": \"https://lNOljQzheebolftPuuCa.qjzdVdF,m6lXjsq+rV4sijQkntubbHInkrQaJO2zBraF0\"\n}"
}
]
}
