Back to Collection Items
; This example assumes the Chilkat API to have been previously unlocked.
; See Global Unlock Sample for sample code.
$oHttp = ObjCreate("Chilkat.Http")
Local $bSuccess
; Use this online tool to generate code from sample JSON: Generate Code to Create JSON
; The following JSON is sent in the request body.
; {
; "name": "Kevin's Corral",
; "date_format": "mm/dd/yyyy",
; "address_attributes": {
; "country": "Canada"
; },
; "phone_number_attributes": null
; }
$oJson = ObjCreate("Chilkat.JsonObject")
$oJson.UpdateString("name","Kevin's Corral")
$oJson.UpdateString("date_format","mm/dd/yyyy")
$oJson.UpdateString("address_attributes.country","Canada")
$oJson.UpdateNull("phone_number_attributes")
; Adds the "Authorization: Bearer <access_token>" header.
$oHttp.AuthToken = "<access_token>"
$oHttp.SetRequestHeader "Content-Type","application/json"
Local $oResp = $oHttp.PostJson3("https://api.freshbooks.com/auth/api/v1/users/business","application/json",$oJson)
If ($oHttp.LastMethodSuccess = False) Then
ConsoleWrite($oHttp.LastErrorText & @CRLF)
Exit
EndIf
$oSbResponseBody = ObjCreate("Chilkat.StringBuilder")
$oResp.GetBodySb($oSbResponseBody)
$oJResp = ObjCreate("Chilkat.JsonObject")
$oJResp.LoadSb($oSbResponseBody)
$oJResp.EmitCompact = False
ConsoleWrite("Response Body:" & @CRLF)
ConsoleWrite($oJResp.Emit() & @CRLF)
Local $iRespStatusCode = $oResp.StatusCode
ConsoleWrite("Response Status Code = " & $iRespStatusCode & @CRLF)
If ($iRespStatusCode >= 400) Then
ConsoleWrite("Response Header:" & @CRLF)
ConsoleWrite($oResp.Header & @CRLF)
ConsoleWrite("Failed." & @CRLF)
Exit
EndIf
; Sample JSON response:
; (Sample code for parsing the JSON response is shown below)
; {
; "response": {
; "id": 1986590,
; "name": "Kevin's Corral",
; "account_id": "lwy0vG",
; "business_group": {
; "id": 4977602,
; "category": "business",
; "members": [
; {
; "id": 6487912,
; "group_id": 4977602,
; "role": "owner",
; "identity_id": 37256,
; "first_name": "Marshall",
; "last_name": "Johnston",
; "email": "api.freshbooks@gmail.com",
; "company": "Kevin's Corral",
; "business_id": 1986590,
; "unacknowledged_change": false,
; "active": true
; }
; ]
; },
; "date_format": "mm/dd/yyyy",
; "address": {
; "id": 2448988,
; "street": null,
; "city": null,
; "province": null,
; "country": "Canada",
; "postal_code": null
; },
; "phone_number": null,
; "business_clients": [
; ]
; }
; }
; Sample code for parsing the JSON response...
; Use this online tool to generate parsing code from sample JSON: Generate JSON Parsing Code
$oDate_format = ObjCreate("Chilkat.DtObj")
Local $id
Local $iGroup_id
Local $sRole
Local $identity_id
Local $sFirst_name
Local $sLast_name
Local $sEmail
Local $sCompany
Local $iBusiness_id
Local $bUnacknowledged_change
Local $bActive
Local $iId = $oJResp.IntOf("response.id")
Local $sName = $oJResp.StringOf("response.name")
Local $sAccount_id = $oJResp.StringOf("response.account_id")
Local $iBusiness_groupId = $oJResp.IntOf("response.business_group.id")
Local $sCategory = $oJResp.StringOf("response.business_group.category")
$oJResp.DtOf("response.date_format",False,$oDate_format)
Local $iAddressId = $oJResp.IntOf("response.address.id")
Local $sStreet = $oJResp.StringOf("response.address.street")
Local $sCity = $oJResp.StringOf("response.address.city")
Local $sProvince = $oJResp.StringOf("response.address.province")
Local $sCountry = $oJResp.StringOf("response.address.country")
Local $sPostal_code = $oJResp.StringOf("response.address.postal_code")
Local $sPhone_number = $oJResp.StringOf("response.phone_number")
Local $i = 0
Local $iCount_i = $oJResp.SizeOfArray("response.business_group.members")
While $i < $iCount_i
$oJResp.I = $i
$id = $oJResp.IntOf("response.business_group.members[i].id")
$iGroup_id = $oJResp.IntOf("response.business_group.members[i].group_id")
$sRole = $oJResp.StringOf("response.business_group.members[i].role")
$identity_id = $oJResp.IntOf("response.business_group.members[i].identity_id")
$sFirst_name = $oJResp.StringOf("response.business_group.members[i].first_name")
$sLast_name = $oJResp.StringOf("response.business_group.members[i].last_name")
$sEmail = $oJResp.StringOf("response.business_group.members[i].email")
$sCompany = $oJResp.StringOf("response.business_group.members[i].company")
$iBusiness_id = $oJResp.IntOf("response.business_group.members[i].business_id")
$bUnacknowledged_change = $oJResp.BoolOf("response.business_group.members[i].unacknowledged_change")
$bActive = $oJResp.BoolOf("response.business_group.members[i].active")
$i = $i + 1
Wend
$i = 0
$iCount_i = $oJResp.SizeOfArray("response.business_clients")
While $i < $iCount_i
$oJResp.I = $i
$i = $i + 1
Wend
Curl Command
curl -X POST
-H "Authorization: Bearer <access_token>"
-H "Content-Type: application/json"
-d '{
"name": "Kevin\'s Corral",
"date_format": "mm/dd/yyyy",
"address_attributes": {
"country": "Canada"
},
"phone_number_attributes": null
}'
https://api.freshbooks.com/auth/api/v1/users/business
Postman Collection Item JSON
{
"name": "Add Business",
"request": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"name\": \"Kevin's Corral\",\n \"date_format\": \"mm/dd/yyyy\",\n \"address_attributes\": {\n \"country\": \"Canada\"\n },\n \"phone_number_attributes\": null\n}"
},
"url": {
"raw": "https://api.freshbooks.com/auth/api/v1/users/business",
"protocol": "https",
"host": [
"api",
"freshbooks",
"com"
],
"path": [
"auth",
"api",
"v1",
"users",
"business"
]
}
},
"response": [
{
"name": "Add Business",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"name\": \"Kevin's Corral\",\n \"date_format\": \"mm/dd/yyyy\",\n \"address_attributes\": {\n \"country\": \"Canada\"\n },\n \"phone_number_attributes\": null\n}"
},
"url": {
"raw": "https://my.freshbooks.com/service/api/auth/api/v1/users/business",
"protocol": "https",
"host": [
"my",
"freshbooks",
"com"
],
"path": [
"service",
"api",
"auth",
"api",
"v1",
"users",
"business"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "nginx"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "X-Frame-Options",
"value": "SAMEORIGIN"
},
{
"key": "X-Frame-Options",
"value": "SAMEORIGIN"
},
{
"key": "X-XSS-Protection",
"value": "1; mode=block"
},
{
"key": "X-Content-Type-Options",
"value": "nosniff"
},
{
"key": "X-Download-Options",
"value": "noopen"
},
{
"key": "X-Permitted-Cross-Domain-Policies",
"value": "none"
},
{
"key": "Referrer-Policy",
"value": "strict-origin-when-cross-origin"
},
{
"key": "ETag",
"value": "W/\"ece9403d440d4badd777fca953dd9580\""
},
{
"key": "Cache-Control",
"value": "no-cache"
},
{
"key": "X-Request-Id",
"value": "49e5ba95-b7dc-42c7-b0c3-8d61d99d1f39"
},
{
"key": "X-Runtime",
"value": "0.670145"
},
{
"key": "X-NewRelic-App-Data",
"value": "PxQBWV5TCBABVlVSBAUHUFQTGhEhCQ0WQg1UDl1KG39aAV0NVBZSEAEZZQAFCBdyUxAIDVl1XhUUUEJQClxZMF8XTAtWXw4IYQpMFVQyVhZLVVYNCkEUAx5UTVIZBwBXVgUEBFNVWlAIUApQDxQZAx9HDlIAVQpQBQBUV1AFXFUBXUM/"
},
{
"key": "Access-Control-Allow-Origin",
"value": "*"
},
{
"key": "Expires",
"value": "Wed, 25 Apr 2018 16:51:20 GMT"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Via",
"value": "1.1 google"
},
{
"key": "Via",
"value": "1.1 varnish"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Accept-Ranges",
"value": "bytes"
},
{
"key": "Date",
"value": "Thu, 25 Apr 2019 16:51:20 GMT"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "X-Served-By",
"value": "cache-mdw17366-MDW"
},
{
"key": "X-Cache",
"value": "MISS"
},
{
"key": "X-Cache-Hits",
"value": "0"
},
{
"key": "Vary",
"value": "Accept-Encoding"
},
{
"key": "Country",
"value": "CA"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains; preload"
}
],
"cookie": [
],
"body": "{\n \"response\": {\n \"id\": 1986590,\n \"name\": \"Kevin's Corral\",\n \"account_id\": \"lwy0vG\",\n \"business_group\": {\n \"id\": 4977602,\n \"category\": \"business\",\n \"members\": [\n {\n \"id\": 6487912,\n \"group_id\": 4977602,\n \"role\": \"owner\",\n \"identity_id\": 37256,\n \"first_name\": \"Marshall\",\n \"last_name\": \"Johnston\",\n \"email\": \"api.freshbooks@gmail.com\",\n \"company\": \"Kevin's Corral\",\n \"business_id\": 1986590,\n \"unacknowledged_change\": false,\n \"active\": true\n }\n ]\n },\n \"date_format\": \"mm/dd/yyyy\",\n \"address\": {\n \"id\": 2448988,\n \"street\": null,\n \"city\": null,\n \"province\": null,\n \"country\": \"Canada\",\n \"postal_code\": null\n },\n \"phone_number\": null,\n \"business_clients\": []\n }\n}"
}
]
}