Chilkat Online Tools

Swift3 / Support API / Create Or Update Organization

Back to Collection Items

func chilkatTest() {
    // This example assumes the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    let http = CkoHttp()!
    var success: Bool

    http.basicAuth = true
    http.login = "login"
    http.password = "password"

    http.setRequestHeader("Accept", value: "application/json")

    var resp: CkoHttpResponse? = http.quickRequest("POST", url: "https://example.zendesk.com/api/v2/organizations/create_or_update")
    if http.lastMethodSuccess == false {
        print("\(http.lastErrorText!)")
        return
    }

    let sbResponseBody = CkoStringBuilder()!
    resp!.getBodySb(sbResponseBody)

    let jResp = CkoJsonObject()!
    jResp.loadSb(sbResponseBody)
    jResp.emitCompact = false

    print("Response Body:")
    print("\(jResp.emit()!)")

    var respStatusCode: Int = resp!.statusCode.intValue
    print("Response Status Code = \(respStatusCode)")
    if respStatusCode >= 400 {
        print("Response Header:")
        print("\(resp!.header!)")
        print("Failed.")
        resp = nil
        return
    }

    resp = nil

    // Sample JSON response:
    // (Sample code for parsing the JSON response is shown below)

    // {
    //   "organization": {
    //     "created_at": "<string>",
    //     "details": "<string>",
    //     "domain_names": [
    //       "<string>",
    //       "<string>"
    //     ],
    //     "external_id": "<string>",
    //     "group_id": "<integer>",
    //     "id": "<integer>",
    //     "name": "<string>",
    //     "notes": "<string>",
    //     "organization_fields": {
    //       "fugiat5_0": "<string>",
    //       "exercitation_039": "<string>",
    //       "laboris_60": "<string>"
    //     },
    //     "shared_comments": "<boolean>",
    //     "shared_tickets": "<boolean>",
    //     "tags": [
    //       "<string>",
    //       "<string>"
    //     ],
    //     "updated_at": "<string>",
    //     "url": "<string>"
    //   }
    // }

    // Sample code for parsing the JSON response...
    // Use this online tool to generate parsing code from sample JSON: Generate JSON Parsing Code

    var strVal: String?

    var Created_at: String? = jResp.string(of: "organization.created_at")
    var Details: String? = jResp.string(of: "organization.details")
    var External_id: String? = jResp.string(of: "organization.external_id")
    var Group_id: String? = jResp.string(of: "organization.group_id")
    var Id: String? = jResp.string(of: "organization.id")
    var Name: String? = jResp.string(of: "organization.name")
    var Notes: String? = jResp.string(of: "organization.notes")
    var Fugiat5_0: String? = jResp.string(of: "organization.organization_fields.fugiat5_0")
    var Exercitation_039: String? = jResp.string(of: "organization.organization_fields.exercitation_039")
    var Laboris_60: String? = jResp.string(of: "organization.organization_fields.laboris_60")
    var Shared_comments: String? = jResp.string(of: "organization.shared_comments")
    var Shared_tickets: String? = jResp.string(of: "organization.shared_tickets")
    var Updated_at: String? = jResp.string(of: "organization.updated_at")
    var v_Url: String? = jResp.string(of: "organization.url")
    var i: Int = 0
    var count_i: Int = jResp.size(ofArray: "organization.domain_names").intValue
    while i < count_i {
        jResp.i = i
        strVal = jResp.string(of: "organization.domain_names[i]")
        i = i + 1
    }

    i = 0
    count_i = jResp.size(ofArray: "organization.tags").intValue
    while i < count_i {
        jResp.i = i
        strVal = jResp.string(of: "organization.tags[i]")
        i = i + 1
    }


}

Curl Command

curl  -u login:password -X POST
	-H "Accept: application/json"
https://example.zendesk.com/api/v2/organizations/create_or_update

Postman Collection Item JSON

{
  "name": "Create Or Update Organization",
  "request": {
    "method": "POST",
    "header": [
      {
        "key": "Accept",
        "value": "application/json"
      }
    ],
    "url": {
      "raw": "{{baseUrl}}/api/v2/organizations/create_or_update",
      "host": [
        "{{baseUrl}}"
      ],
      "path": [
        "api",
        "v2",
        "organizations",
        "create_or_update"
      ]
    },
    "description": "Creates an organization if it doesn't already exist, or updates\nan existing organization. Using this method means one less call\nto check if an organization exists before creating it. You need\nto specify the id or external id when updating\nan organization to avoid a duplicate error response. Name is\nnot available as a matching criteria.\n\n#### Allowed For\n\n* Agents, with restrictions on certain actions\n"
  },
  "response": [
    {
      "name": "Success response",
      "originalRequest": {
        "method": "POST",
        "header": [
          {
            "description": "Added as a part of security scheme: basic",
            "key": "Authorization",
            "value": "Basic <credentials>"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/api/v2/organizations/create_or_update",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "v2",
            "organizations",
            "create_or_update"
          ]
        }
      },
      "status": "OK",
      "code": 200,
      "_postman_previewlanguage": "json",
      "header": [
        {
          "key": "Content-Type",
          "value": "application/json"
        }
      ],
      "cookie": [
      ],
      "body": "{\n  \"organization\": {\n    \"created_at\": \"<string>\",\n    \"details\": \"<string>\",\n    \"domain_names\": [\n      \"<string>\",\n      \"<string>\"\n    ],\n    \"external_id\": \"<string>\",\n    \"group_id\": \"<integer>\",\n    \"id\": \"<integer>\",\n    \"name\": \"<string>\",\n    \"notes\": \"<string>\",\n    \"organization_fields\": {\n      \"fugiat5_0\": \"<string>\",\n      \"exercitation_039\": \"<string>\",\n      \"laboris_60\": \"<string>\"\n    },\n    \"shared_comments\": \"<boolean>\",\n    \"shared_tickets\": \"<boolean>\",\n    \"tags\": [\n      \"<string>\",\n      \"<string>\"\n    ],\n    \"updated_at\": \"<string>\",\n    \"url\": \"<string>\"\n  }\n}"
    },
    {
      "name": "Created response",
      "originalRequest": {
        "method": "POST",
        "header": [
          {
            "description": "Added as a part of security scheme: basic",
            "key": "Authorization",
            "value": "Basic <credentials>"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/api/v2/organizations/create_or_update",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "v2",
            "organizations",
            "create_or_update"
          ]
        }
      },
      "status": "Created",
      "code": 201,
      "_postman_previewlanguage": "json",
      "header": [
        {
          "key": "Content-Type",
          "value": "application/json"
        }
      ],
      "cookie": [
      ],
      "body": "{\n  \"organization\": {\n    \"created_at\": \"<string>\",\n    \"details\": \"<string>\",\n    \"domain_names\": [\n      \"<string>\",\n      \"<string>\"\n    ],\n    \"external_id\": \"<string>\",\n    \"group_id\": \"<integer>\",\n    \"id\": \"<integer>\",\n    \"name\": \"<string>\",\n    \"notes\": \"<string>\",\n    \"organization_fields\": {\n      \"fugiat5_0\": \"<string>\",\n      \"exercitation_039\": \"<string>\",\n      \"laboris_60\": \"<string>\"\n    },\n    \"shared_comments\": \"<boolean>\",\n    \"shared_tickets\": \"<boolean>\",\n    \"tags\": [\n      \"<string>\",\n      \"<string>\"\n    ],\n    \"updated_at\": \"<string>\",\n    \"url\": \"<string>\"\n  }\n}"
    }
  ]
}