Chilkat Online Tools

C / Microsoft Graph / Invite a guest user

Back to Collection Items

#include <C_CkHttp.h>
#include <C_CkJsonObject.h>
#include <C_CkHttpResponse.h>

void ChilkatSample(void)
    {
    HCkHttp http;
    BOOL success;
    HCkJsonObject json;
    HCkHttpResponse resp;

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

    http = CkHttp_Create();

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

    // The following JSON is sent in the request body.

    // {
    //   "invitedUserDisplayName": "<Display Name of Invited User>",
    //   "invitedUserEmailAddress": "<Email Address of Invited User>",
    //   "invitedUserMessageInfo": {
    //     "messageLanguage": "en-US",
    //     "ccRecipients": [
    //       {
    //         "emailAddress": {
    //           "name": "<Optional CC for Invitation>",
    //           "address": "<Optional CC Email Address for Invitation>"
    //         }
    //       }
    //     ],
    //     "customizedMessageBody": "Hi, you have just been invited to Azure AD with Postman using Microsoft Graph!"
    //   },
    //   "sendInvitationMessage": true,
    //   "inviteRedirectUrl": "https://myapps.microsoft.com"
    // }

    json = CkJsonObject_Create();
    CkJsonObject_UpdateString(json,"invitedUserDisplayName","<Display Name of Invited User>");
    CkJsonObject_UpdateString(json,"invitedUserEmailAddress","<Email Address of Invited User>");
    CkJsonObject_UpdateString(json,"invitedUserMessageInfo.messageLanguage","en-US");
    CkJsonObject_UpdateString(json,"invitedUserMessageInfo.ccRecipients[0].emailAddress.name","<Optional CC for Invitation>");
    CkJsonObject_UpdateString(json,"invitedUserMessageInfo.ccRecipients[0].emailAddress.address","<Optional CC Email Address for Invitation>");
    CkJsonObject_UpdateString(json,"invitedUserMessageInfo.customizedMessageBody","Hi, you have just been invited to Azure AD with Postman using Microsoft Graph!");
    CkJsonObject_UpdateBool(json,"sendInvitationMessage",TRUE);
    CkJsonObject_UpdateString(json,"inviteRedirectUrl","https://myapps.microsoft.com");

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

    resp = CkHttp_PostJson3(http,"https://graph.microsoft.com/v1.0/invitations","application/json",json);
    if (CkHttp_getLastMethodSuccess(http) == FALSE) {
        printf("%s\n",CkHttp_lastErrorText(http));
        CkHttp_Dispose(http);
        CkJsonObject_Dispose(json);
        return;
    }

    printf("%d\n",CkHttpResponse_getStatusCode(resp));
    printf("%s\n",CkHttpResponse_bodyStr(resp));
    CkHttpResponse_Dispose(resp);


    CkHttp_Dispose(http);
    CkJsonObject_Dispose(json);

    }

Curl Command

curl -X POST
	-H "Authorization: Bearer <access_token>"
	-H "Content-Type: application/json"
	-d '{ 
    "invitedUserDisplayName": "<Display Name of Invited User>", 
    "invitedUserEmailAddress": "<Email Address of Invited User>", 
    "invitedUserMessageInfo": {
        "messageLanguage": "en-US",
        "ccRecipients": [
             {
                "emailAddress": {
                    "name": "<Optional CC for Invitation>",
                    "address": "<Optional CC Email Address for Invitation>"
                 }
             }
        ],
        "customizedMessageBody": "Hi, you have just been invited to Azure AD with Postman using Microsoft Graph!"
     },
    "sendInvitationMessage": true, 
    "inviteRedirectUrl": "https://myapps.microsoft.com" 
}'
https://graph.microsoft.com/v1.0/invitations

Postman Collection Item JSON

{
  "name": "Invite a guest user",
  "event": [
    {
      "listen": "test",
      "script": {
        "exec": [
          "try {\r",
          "    if (responseBody.indexOf(\"InvalidAuthenticationToken\") !== -1)\r",
          "    {\r",
          "        console.log(\"You need to run *On behalf of a User | Get User Access Token* request first.\");\r",
          "    }\r",
          "    else\r",
          "    {\r",
          "        if (pm.response.status === \"Forbidden\")\r",
          "        {\r",
          "            console.log(\"You need to add user delegated permissions in your application to at least *User.Invite.All* in portal.azure.com and then consent as user or Grant admin consent in portal. And re-run *On behalf of a User | Get User Access Token* request to update access token. \");\r",
          "        }\r",
          "        else\r",
          "        {\r",
          "            var json = JSON.parse(responseBody);\r",
          "            // Get invited user id\r",
          "            postman.setEnvironmentVariable(\"UserId\", json.invitedUser.id);\r",
          "        }\r",
          "    }\r",
          "}\r",
          "catch (e) {\r",
          "    console.log(e);\r",
          "}\r",
          ""
        ],
        "type": "text/javascript"
      }
    }
  ],
  "request": {
    "method": "POST",
    "header": [
      {
        "key": "Content-Type",
        "name": "Content-Type",
        "value": "application/json",
        "type": "text"
      }
    ],
    "body": {
      "mode": "raw",
      "raw": "{ \r\n    \"invitedUserDisplayName\": \"<Display Name of Invited User>\", \r\n    \"invitedUserEmailAddress\": \"<Email Address of Invited User>\", \r\n    \"invitedUserMessageInfo\": {\r\n        \"messageLanguage\": \"en-US\",\r\n        \"ccRecipients\": [\r\n             {\r\n                \"emailAddress\": {\r\n                    \"name\": \"<Optional CC for Invitation>\",\r\n                    \"address\": \"<Optional CC Email Address for Invitation>\"\r\n                 }\r\n             }\r\n        ],\r\n        \"customizedMessageBody\": \"Hi, you have just been invited to Azure AD with Postman using Microsoft Graph!\"\r\n     },\r\n    \"sendInvitationMessage\": true, \r\n    \"inviteRedirectUrl\": \"https://myapps.microsoft.com\" \r\n} ",
      "options": {
        "raw": {
          "language": "json"
        }
      }
    },
    "url": {
      "raw": "https://graph.microsoft.com/v1.0/invitations",
      "protocol": "https",
      "host": [
        "graph",
        "microsoft",
        "com"
      ],
      "path": [
        "v1.0",
        "invitations"
      ]
    },
    "description": "Invite Azure AD B2B Guest User using Delegated Permission"
  },
  "response": [
  ]
}