Back to Collection Items
<?php
// This example assumes the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.
// For versions of Chilkat < 10.0.0, use new COM('Chilkat_9_5_0.Chilkat.Http')
$http = new COM("Chilkat.Http");
// 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
// }
// For versions of Chilkat < 10.0.0, use new COM('Chilkat_9_5_0.Chilkat.JsonObject')
$json = new COM("Chilkat.JsonObject");
$json->UpdateString('name','Kevin's Corral');
$json->UpdateString('date_format','mm/dd/yyyy');
$json->UpdateString('address_attributes.country','Canada');
$json->UpdateNull('phone_number_attributes');
// Adds the "Authorization: Bearer <access_token>" header.
$http->AuthToken = '<access_token>';
$http->SetRequestHeader('Content-Type','application/json');
// resp is a Chilkat.HttpResponse
$resp = $http->PostJson3('https://api.freshbooks.com/auth/api/v1/users/business','application/json',$json);
if ($http->LastMethodSuccess == 0) {
print $http->LastErrorText . "\n";
exit;
}
// For versions of Chilkat < 10.0.0, use new COM('Chilkat_9_5_0.Chilkat.StringBuilder')
$sbResponseBody = new COM("Chilkat.StringBuilder");
$resp->GetBodySb($sbResponseBody);
// For versions of Chilkat < 10.0.0, use new COM('Chilkat_9_5_0.Chilkat.JsonObject')
$jResp = new COM("Chilkat.JsonObject");
$jResp->LoadSb($sbResponseBody);
$jResp->EmitCompact = 0;
print 'Response Body:' . "\n";
print $jResp->emit() . "\n";
$respStatusCode = $resp->StatusCode;
print 'Response Status Code = ' . $respStatusCode . "\n";
if ($respStatusCode >= 400) {
print 'Response Header:' . "\n";
print $resp->Header . "\n";
print 'Failed.' . "\n";
exit;
}
// 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
// For versions of Chilkat < 10.0.0, use new COM('Chilkat_9_5_0.Chilkat.DtObj')
$Date_format = new COM("Chilkat.DtObj");
$Id = $jResp->IntOf('response.id');
$Name = $jResp->stringOf('response.name');
$Account_id = $jResp->stringOf('response.account_id');
$Business_groupId = $jResp->IntOf('response.business_group.id');
$Category = $jResp->stringOf('response.business_group.category');
$jResp->DtOf('response.date_format',0,$Date_format);
$AddressId = $jResp->IntOf('response.address.id');
$Street = $jResp->stringOf('response.address.street');
$City = $jResp->stringOf('response.address.city');
$Province = $jResp->stringOf('response.address.province');
$Country = $jResp->stringOf('response.address.country');
$Postal_code = $jResp->stringOf('response.address.postal_code');
$Phone_number = $jResp->stringOf('response.phone_number');
$i = 0;
$count_i = $jResp->SizeOfArray('response.business_group.members');
while ($i < $count_i) {
$jResp->I = $i;
$id = $jResp->IntOf('response.business_group.members[i].id');
$group_id = $jResp->IntOf('response.business_group.members[i].group_id');
$role = $jResp->stringOf('response.business_group.members[i].role');
$identity_id = $jResp->IntOf('response.business_group.members[i].identity_id');
$first_name = $jResp->stringOf('response.business_group.members[i].first_name');
$last_name = $jResp->stringOf('response.business_group.members[i].last_name');
$email = $jResp->stringOf('response.business_group.members[i].email');
$company = $jResp->stringOf('response.business_group.members[i].company');
$business_id = $jResp->IntOf('response.business_group.members[i].business_id');
$unacknowledged_change = $jResp->BoolOf('response.business_group.members[i].unacknowledged_change');
$active = $jResp->BoolOf('response.business_group.members[i].active');
$i = $i + 1;
}
$i = 0;
$count_i = $jResp->SizeOfArray('response.business_clients');
while ($i < $count_i) {
$jResp->I = $i;
$i = $i + 1;
}
?>
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}"
}
]
}
