Chilkat Online Tools

PureBasic / New FreshBooks / Send Invoice by Email

Back to Collection Items

IncludeFile "CkJsonObject.pb"
IncludeFile "CkStringBuilder.pb"
IncludeFile "CkHttp.pb"
IncludeFile "CkHttpResponse.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

    ; Use this online tool to generate code from sample JSON: Generate Code to Create JSON

    ; The following JSON is sent in the request body.

    ; {
    ;   "invoice": {
    ;     "email_recipients": [
    ;       "example@freshbooks.com",
    ;       "example2@freshbooks.com"
    ;     ],
    ;     "invoice_customized_email": {
    ;       "subject": "::company name:: has sent you an invoice (::invoice number::)",
    ;       "body": "::company name:: sent you invoice (::invoice number::) for ::invoice amount:: that's due on ::invoice due date::"
    ;     },
    ;     "action_email": true
    ;   }
    ; }

    json.i = CkJsonObject::ckCreate()
    If json.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkJsonObject::ckUpdateString(json,"invoice.email_recipients[0]","example@freshbooks.com")
    CkJsonObject::ckUpdateString(json,"invoice.email_recipients[1]","example2@freshbooks.com")
    CkJsonObject::ckUpdateString(json,"invoice.invoice_customized_email.subject","::company name:: has sent you an invoice (::invoice number::)")
    CkJsonObject::ckUpdateString(json,"invoice.invoice_customized_email.body","::company name:: sent you invoice (::invoice number::) for ::invoice amount:: that's due on ::invoice due date::")
    CkJsonObject::ckUpdateBool(json,"invoice.action_email",1)

    ; Adds the "Authorization: Bearer <access_token>" header.
    CkHttp::setCkAuthToken(http, "<access_token>")
    CkHttp::ckSetRequestHeader(http,"Content-Type","application/json")

    sbRequestBody.i = CkStringBuilder::ckCreate()
    If sbRequestBody.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkJsonObject::ckEmitSb(json,sbRequestBody)

    resp.i = CkHttp::ckPTextSb(http,"PUT","https://api.freshbooks.com/accounting/account/{{accountid}}/invoices/invoices/{{invoiceid}}",sbRequestBody,"utf-8","application/json",0,0)
    If CkHttp::ckLastMethodSuccess(http) = 0
        Debug CkHttp::ckLastErrorText(http)
        CkHttp::ckDispose(http)
        CkJsonObject::ckDispose(json)
        CkStringBuilder::ckDispose(sbRequestBody)
        ProcedureReturn
    EndIf

    Debug Str(CkHttpResponse::ckStatusCode(resp))
    Debug CkHttpResponse::ckBodyStr(resp)
    CkHttpResponse::ckDispose(resp)



    CkHttp::ckDispose(http)
    CkJsonObject::ckDispose(json)
    CkStringBuilder::ckDispose(sbRequestBody)


    ProcedureReturn
EndProcedure

Curl Command

curl -X PUT
	-H "Authorization: Bearer <access_token>"
	-H "Content-Type: application/json"
	-d '{
    "invoice": {
        
        "email_recipients": [
            "example@freshbooks.com",
            "example2@freshbooks.com"
        ],
        "invoice_customized_email": {
        "subject": "::company name:: has sent you an invoice (::invoice number::)",
                "body":"::company name:: sent you invoice (::invoice number::) for ::invoice amount:: that\'s due on ::invoice due date::"
            },
            "action_email": true
    }
}'
https://api.freshbooks.com/accounting/account/{{accountid}}/invoices/invoices/{{invoiceid}}

Postman Collection Item JSON

{
  "name": "Send Invoice by Email",
  "request": {
    "method": "PUT",
    "header": [
      {
        "key": "Content-Type",
        "name": "Content-Type",
        "value": "application/json",
        "type": "text"
      }
    ],
    "body": {
      "mode": "raw",
      "raw": "{\n    \"invoice\": {\n        \n        \"email_recipients\": [\n            \"example@freshbooks.com\",\n            \"example2@freshbooks.com\"\n        ],\n        \"invoice_customized_email\": {\n        \"subject\": \"::company name:: has sent you an invoice (::invoice number::)\",\n                \"body\":\"::company name:: sent you invoice (::invoice number::) for ::invoice amount:: that's due on ::invoice due date::\"\n            },\n            \"action_email\": true\n    }\n}",
      "options": {
        "raw": {
          "language": "json"
        }
      }
    },
    "url": {
      "raw": "https://api.freshbooks.com/accounting/account/{{accountid}}/invoices/invoices/{{invoiceid}}",
      "protocol": "https",
      "host": [
        "api",
        "freshbooks",
        "com"
      ],
      "path": [
        "accounting",
        "account",
        "{{accountid}}",
        "invoices",
        "invoices",
        "{{invoiceid}}"
      ]
    }
  },
  "response": [
  ]
}