Chilkat Online Tools

TCL / Squadcast API V3 / Add User

Back to Collection Items

load ./chilkat.dll

# This example assumes the Chilkat API to have been previously unlocked.
# See Global Unlock Sample for sample code.

set http [new_CkHttp]

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

# The following JSON is sent in the request body.

# {
#   "email": "<string>",
#   "role": "<string>",
#   "first_name": "<string>",
#   "last_name": "<string>"
# }

set json [new_CkJsonObject]

CkJsonObject_UpdateString $json "email" "<string>"
CkJsonObject_UpdateString $json "role" "<string>"
CkJsonObject_UpdateString $json "first_name" "<string>"
CkJsonObject_UpdateString $json "last_name" "<string>"

CkHttp_SetRequestHeader $http "Authorization" ""
CkHttp_SetRequestHeader $http "Content-Type" "application/json"

# resp is a CkHttpResponse
set resp [CkHttp_PostJson3 $http "https://api.squadcast.com/v3/users" "application/json" $json]
if {[CkHttp_get_LastMethodSuccess $http] == 0} then {
    puts [CkHttp_lastErrorText $http]
    delete_CkHttp $http
    delete_CkJsonObject $json
    exit
}

set sbResponseBody [new_CkStringBuilder]

CkHttpResponse_GetBodySb $resp $sbResponseBody

set jResp [new_CkJsonObject]

CkJsonObject_LoadSb $jResp $sbResponseBody
CkJsonObject_put_EmitCompact $jResp 0

puts "Response Body:"
puts [CkJsonObject_emit $jResp]

set respStatusCode [CkHttpResponse_get_StatusCode $resp]
puts "Response Status Code = $respStatusCode"
if {$respStatusCode >= 400} then {
    puts "Response Header:"
    puts [CkHttpResponse_header $resp]
    puts "Failed."
    delete_CkHttpResponse $resp

    delete_CkHttp $http
    delete_CkJsonObject $json
    delete_CkStringBuilder $sbResponseBody
    delete_CkJsonObject $jResp
    exit
}

delete_CkHttpResponse $resp

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

# {
#   "data": {
#     "id": "5e9c204dbde1298f6bcb5ef2",
#     "first_name": "Manigandan",
#     "last_name": "Dharmalingam",
#     "email": "manigandan@squadcast.com",
#     "contact": {
#       "dial_code": "",
#       "phone_number": ""
#     },
#     "secondary_emails": null,
#     "email_verified": false,
#     "time_zone": "",
#     "title": "",
#     "bio": "",
#     "notification_rules": [
#       {
#         "type": "Email",
#         "time": 0
#       },
#       {
#         "type": "Push",
#         "time": 0
#       },
#       {
#         "type": "SMS",
#         "time": 1
#       },
#       {
#         "type": "Phone",
#         "time": 2
#       }
#     ],
#     "user_image": false
#   }
# }

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

set Id [CkJsonObject_stringOf $jResp "data.id"]
set First_name [CkJsonObject_stringOf $jResp "data.first_name"]
set Last_name [CkJsonObject_stringOf $jResp "data.last_name"]
set v_Email [CkJsonObject_stringOf $jResp "data.email"]
set Dial_code [CkJsonObject_stringOf $jResp "data.contact.dial_code"]
set Phone_number [CkJsonObject_stringOf $jResp "data.contact.phone_number"]
set Secondary_emails [CkJsonObject_stringOf $jResp "data.secondary_emails"]
set Email_verified [CkJsonObject_BoolOf $jResp "data.email_verified"]
set Time_zone [CkJsonObject_stringOf $jResp "data.time_zone"]
set Title [CkJsonObject_stringOf $jResp "data.title"]
set Bio [CkJsonObject_stringOf $jResp "data.bio"]
set User_image [CkJsonObject_BoolOf $jResp "data.user_image"]
set i 0
set count_i [CkJsonObject_SizeOfArray $jResp "data.notification_rules"]
while {$i < $count_i} {
    CkJsonObject_put_I $jResp $i
    set v_type [CkJsonObject_stringOf $jResp "data.notification_rules[i].type"]
    set time [CkJsonObject_IntOf $jResp "data.notification_rules[i].time"]
    set i [expr $i + 1]
}

delete_CkHttp $http
delete_CkJsonObject $json
delete_CkStringBuilder $sbResponseBody
delete_CkJsonObject $jResp

Curl Command

curl -X POST
	-H "Authorization: "
	-H "Content-Type: application/json"
	-d '{
    "email": "<string>",
    "role": "<string>",
    "first_name": "<string>",
    "last_name": "<string>"
}'
https://api.squadcast.com/v3/users

Postman Collection Item JSON

{
  "name": "Add User",
  "request": {
    "auth": {
      "type": "noauth"
    },
    "method": "POST",
    "header": [
      {
        "key": "Authorization",
        "value": ""
      },
      {
        "key": "Content-Type",
        "value": "application/json"
      }
    ],
    "body": {
      "mode": "raw",
      "raw": "{\n    \"email\": \"<string>\",\n    \"role\": \"<string>\",\n    \"first_name\": \"<string>\",\n    \"last_name\": \"<string>\"\n}"
    },
    "url": {
      "raw": "{{baseUrl}}/users",
      "host": [
        "{{baseUrl}}"
      ],
      "path": [
        "users"
      ]
    },
    "description": "Add user to the organization with given role if not exists. Returns the user object in response. \nRequires `access_token` as a `Bearer {{token}}` in the `Authorization` header with `user-write` scope."
  },
  "response": [
    {
      "name": "Unprocessable Entity",
      "originalRequest": {
        "method": "POST",
        "header": [
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n    \"email\": \"manigandan@squadcast.com\",\n    \"role\": \"admin\",\n    \"first_name\": \"Manigandan\",\n    \"last_name\": \"Dharmalingam\"\n}"
        },
        "url": {
          "raw": "{{baseUrl}}/users",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "users"
          ]
        }
      },
      "status": "Unprocessable Entity (WebDAV) (RFC 4918)",
      "code": 422,
      "_postman_previewlanguage": "json",
      "header": [
        {
          "key": "Content-Type",
          "value": "application/json"
        }
      ],
      "cookie": [
      ],
      "body": "{\n \"meta\": {\n  \"status\": \"<integer>\",\n  \"error_message\": \"<string>\"\n }\n}"
    },
    {
      "name": "Internal Server Error",
      "originalRequest": {
        "method": "POST",
        "header": [
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n    \"email\": \"manigandan@squadcast.com\",\n    \"role\": \"admin\",\n    \"first_name\": \"Manigandan\",\n    \"last_name\": \"Dharmalingam\"\n}"
        },
        "url": {
          "raw": "{{baseUrl}}/users",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "users"
          ]
        }
      },
      "status": "Internal Server Error",
      "code": 500,
      "_postman_previewlanguage": "json",
      "header": [
        {
          "key": "Content-Type",
          "value": "application/json"
        }
      ],
      "cookie": [
      ],
      "body": "{\n \"meta\": {\n  \"status\": \"<integer>\",\n  \"error_message\": \"<string>\"\n }\n}"
    },
    {
      "name": "Created",
      "originalRequest": {
        "method": "POST",
        "header": [
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n    \"email\": \"manigandan@squadcast.com\",\n    \"role\": \"admin\",\n    \"first_name\": \"Manigandan\",\n    \"last_name\": \"Dharmalingam\"\n}"
        },
        "url": {
          "raw": "{{baseUrl}}/users",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "users"
          ]
        }
      },
      "status": "Created",
      "code": 201,
      "_postman_previewlanguage": "json",
      "header": [
        {
          "key": "Content-Type",
          "value": "application/json"
        }
      ],
      "cookie": [
      ],
      "body": "{\n \"data\": {\n  \"id\": \"5e9c204dbde1298f6bcb5ef2\",\n  \"first_name\": \"Manigandan\",\n  \"last_name\": \"Dharmalingam\",\n  \"email\": \"manigandan@squadcast.com\",\n  \"contact\": {\n   \"dial_code\": \"\",\n   \"phone_number\": \"\"\n  },\n  \"secondary_emails\": null,\n  \"email_verified\": false,\n  \"time_zone\": \"\",\n  \"title\": \"\",\n  \"bio\": \"\",\n  \"notification_rules\": [\n   {\n    \"type\": \"Email\",\n    \"time\": 0\n   },\n   {\n    \"type\": \"Push\",\n    \"time\": 0\n   },\n   {\n    \"type\": \"SMS\",\n    \"time\": 1\n   },\n   {\n    \"type\": \"Phone\",\n    \"time\": 2\n   }\n  ],\n  \"user_image\": false\n }\n}"
    },
    {
      "name": "Bad Request",
      "originalRequest": {
        "method": "POST",
        "header": [
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n    \"email\": \"manigandan@squadcast.com\",\n    \"role\": \"admin\",\n    \"first_name\": \"Manigandan\",\n    \"last_name\": \"Dharmalingam\"\n}"
        },
        "url": {
          "raw": "{{baseUrl}}/users",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "users"
          ]
        }
      },
      "status": "Bad Request",
      "code": 400,
      "_postman_previewlanguage": "json",
      "header": [
        {
          "key": "Content-Type",
          "value": "application/json"
        }
      ],
      "cookie": [
      ],
      "body": "{\n \"meta\": {\n  \"status\": 400,\n  \"error_message\": \"email required\"\n }\n}"
    },
    {
      "name": "Conflict",
      "originalRequest": {
        "method": "POST",
        "header": [
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n    \"email\": \"manigandan@squadcast.com\",\n    \"role\": \"admin\",\n    \"first_name\": \"Manigandan\",\n    \"last_name\": \"Dharmalingam\"\n}"
        },
        "url": {
          "raw": "{{baseUrl}}/users",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "users"
          ]
        }
      },
      "status": "Conflict",
      "code": 409,
      "_postman_previewlanguage": "json",
      "header": [
        {
          "key": "Content-Type",
          "value": "application/json"
        }
      ],
      "cookie": [
      ],
      "body": "{\n \"meta\": {\n  \"status\": 409,\n  \"error_message\": \"cannot add same user manigandan2293@gmail.com again to the organization\"\n }\n}"
    },
    {
      "name": "Unauthorized",
      "originalRequest": {
        "method": "POST",
        "header": [
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n    \"email\": \"manigandan@squadcast.com\",\n    \"role\": \"admin\",\n    \"first_name\": \"Manigandan\",\n    \"last_name\": \"Dharmalingam\"\n}"
        },
        "url": {
          "raw": "{{baseUrl}}/users",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "users"
          ]
        }
      },
      "status": "Unauthorized",
      "code": 401,
      "_postman_previewlanguage": "json",
      "header": [
        {
          "key": "Content-Type",
          "value": "application/json"
        }
      ],
      "cookie": [
      ],
      "body": "{\n \"meta\": {\n  \"status\": 401,\n  \"error_message\": \"invalid access token\"\n }\n}"
    },
    {
      "name": "Forbidden",
      "originalRequest": {
        "method": "POST",
        "header": [
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n    \"email\": \"manigandan@squadcast.com\",\n    \"role\": \"admin\",\n    \"first_name\": \"Manigandan\",\n    \"last_name\": \"Dharmalingam\"\n}"
        },
        "url": {
          "raw": "{{baseUrl}}/users",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "users"
          ]
        }
      },
      "status": "Forbidden",
      "code": 403,
      "_postman_previewlanguage": "json",
      "header": [
        {
          "key": "Content-Type",
          "value": "application/json"
        }
      ],
      "cookie": [
      ],
      "body": "{\n \"meta\": {\n  \"status\": \"<integer>\",\n  \"error_message\": \"<string>\"\n }\n}"
    }
  ]
}