Chilkat Online Tools

Objective-C / Squadcast API V3 / Add User

Back to Collection Items

#import <CkoHttp.h>
#import <CkoJsonObject.h>
#import <CkoHttpResponse.h>
#import <CkoStringBuilder.h>
#import <NSString.h>

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

CkoHttp *http = [[CkoHttp alloc] init];
BOOL success;

// 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>"
// }

CkoJsonObject *json = [[CkoJsonObject alloc] init];
[json UpdateString: @"email" value: @"<string>"];
[json UpdateString: @"role" value: @"<string>"];
[json UpdateString: @"first_name" value: @"<string>"];
[json UpdateString: @"last_name" value: @"<string>"];

[http SetRequestHeader: @"Authorization" value: @""];
[http SetRequestHeader: @"Content-Type" value: @"application/json"];

CkoHttpResponse *resp = [http PostJson3: @"https://api.squadcast.com/v3/users" contentType: @"application/json" json: json];
if (http.LastMethodSuccess == NO) {
    NSLog(@"%@",http.LastErrorText);
    return;
}

CkoStringBuilder *sbResponseBody = [[CkoStringBuilder alloc] init];
[resp GetBodySb: sbResponseBody];

CkoJsonObject *jResp = [[CkoJsonObject alloc] init];
[jResp LoadSb: sbResponseBody];
jResp.EmitCompact = NO;

NSLog(@"%@",@"Response Body:");
NSLog(@"%@",[jResp Emit]);

int respStatusCode = [resp.StatusCode intValue];
NSLog(@"%@%d",@"Response Status Code = ",respStatusCode);
if (respStatusCode >= 400) {
    NSLog(@"%@",@"Response Header:");
    NSLog(@"%@",resp.Header);
    NSLog(@"%@",@"Failed.");

    return;
}

// 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

NSString *v_type = 0;
int time;

NSString *Id = [jResp StringOf: @"data.id"];
NSString *First_name = [jResp StringOf: @"data.first_name"];
NSString *Last_name = [jResp StringOf: @"data.last_name"];
NSString *v_Email = [jResp StringOf: @"data.email"];
NSString *Dial_code = [jResp StringOf: @"data.contact.dial_code"];
NSString *Phone_number = [jResp StringOf: @"data.contact.phone_number"];
NSString *Secondary_emails = [jResp StringOf: @"data.secondary_emails"];
BOOL Email_verified = [jResp BoolOf: @"data.email_verified"];
NSString *Time_zone = [jResp StringOf: @"data.time_zone"];
NSString *Title = [jResp StringOf: @"data.title"];
NSString *Bio = [jResp StringOf: @"data.bio"];
BOOL User_image = [jResp BoolOf: @"data.user_image"];
int i = 0;
int count_i = [[jResp SizeOfArray: @"data.notification_rules"] intValue];
while (i < count_i) {
    jResp.I = [NSNumber numberWithInt: i];
    v_type = [jResp StringOf: @"data.notification_rules[i].type"];
    time = [[jResp IntOf: @"data.notification_rules[i].time"] intValue];
    i = i + 1;
}

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}"
    }
  ]
}