Outlook Mail: Copy a Mail Folder and Its Contents
See more Outlook Examples
Copy a folder and its contents below a destination folder in the same mailbox. The source remains in place. Use the returned folder ID for the copy and refresh any cached folder map. The JSON property is destinationId, and Graph documents 200 OK for this action (unlike creating a child folder, which returns 201).
Live operation: running this example changes the mailbox. There is no automatic retry. Repeating a successful create/copy/send operation can create another item or send another message; reconcile ambiguous outcomes first.
Delegated permission: Mail.ReadWrite.
Uses direct Chilkat.Http calls to Microsoft Graph v1.0 for an Outlook.com or Microsoft 365 online mailbox. Save a current Graph access token as access_token in the private file qa_data/tokens/microsoftGraph.json. Obtain it through the Microsoft identity platform authorization-code flow with PKCE for a public interactive client; request offline_access if a refresh token is needed. Consent to the mail permission stated here. Tokens for SMTP/IMAP/POP, Calendar-only, or Contacts-only access are insufficient.
/me requires a signed-in user and delegated permissions. An unattended Microsoft 365 application instead uses administrator-approved application permissions and /users/{id-or-UPN}; limit it to the intended mailboxes. Client credentials is not available for personal Outlook.com mailboxes. These requests access cloud mailbox data, not local PST files, and do not require Outlook to be running. National clouds require their own authority and Graph hosts.
The code checks the HTTP status separately from transport success and validates JSON before reading it. For 401, refresh or authorize again; for 403, check consent, mailbox access, and policy; for 429, honor Retry-After with a bounded retry. A failed or timed-out write can have an uncertain outcome: reconcile before repeating it. Keep tokens, message content, continuation URLs, and detailed diagnostics private.
Chilkat Delphi DLL Downloads
var
success: Boolean;
token: HCkJsonObject;
http: HCkHttp;
resp: HCkHttpResponse;
result: HCkJsonObject;
sourceFolderId: PWideChar;
destinationFolderId: PWideChar;
body: HCkJsonObject;
endpoint: HCkStringBuilder;
begin
success := False;
// Assumes Chilkat is unlocked. See Global Unlock Sample.
success := False;
// Supply a current Microsoft Graph token with this example's mail permissions.
// Keep the token cache private and refresh expired tokens before running the example.
token := CkJsonObject_Create();
CkJsonObject_putStrict(token,True);
success := CkJsonObject_LoadFile(token,'qa_data/tokens/microsoftGraph.json');
if (success <> True) then
begin
Memo1.Lines.Add('Could not read the private Graph token cache.');
Exit;
end;
if ((CkJsonObject_JsonTypeOf(token,'access_token') <> 1) or (CkJsonObject_StringOfEquals(token,'access_token','',True) = True)) then
begin
Memo1.Lines.Add('Expected a nonempty access_token in the JSON.');
Exit;
end;
http := CkHttp_Create();
CkHttp_putAuthToken(http,CkJsonObject__stringOf(token,'access_token'));
CkHttp_putRequireSslCertVerify(http,True);
CkHttp_putFollowRedirects(http,False);
CkHttp_putConnectTimeout(http,20);
CkHttp_putReadTimeout(http,60);
CkHttp_SetRequestHeader(http,'Accept','application/json');
resp := CkHttpResponse_Create();
result := CkJsonObject_Create();
CkJsonObject_putStrict(result,True);
sourceFolderId := 'YOUR_SOURCE_FOLDER_ID';
destinationFolderId := 'YOUR_DESTINATION_FOLDER_ID';
body := CkJsonObject_Create();
CkJsonObject_UpdateString(body,'destinationId',destinationFolderId);
endpoint := CkStringBuilder_Create();
CkStringBuilder_Append(endpoint,'https://graph.microsoft.com/v1.0/me/mailFolders/');
CkStringBuilder_Append(endpoint,CkHttp__urlEncode(http,sourceFolderId));
CkStringBuilder_Append(endpoint,'/copy');
success := CkHttp_HttpJson(http,'POST',CkStringBuilder__getAsString(endpoint),body,'application/json',resp);
// A false result can still include an HTTP error response.
if ((success <> True) and (CkHttpResponse_getStatusCode(resp) = 0)) then
begin
Memo1.Lines.Add('No HTTP response was received. Inspect diagnostics privately; reconcile a write before retrying.');
Exit;
end;
if (CkHttpResponse_getStatusCode(resp) <> 200) then
begin
Memo1.Lines.Add('Unexpected HTTP status: ' + IntToStr(CkHttpResponse_getStatusCode(resp)));
Memo1.Lines.Add('Request ID: ' + CkHttpResponse__getHeaderField(resp,'request-id'));
if (CkHttpResponse_getStatusCode(resp) = 429) then
begin
Memo1.Lines.Add('Retry-After: ' + CkHttpResponse__getHeaderField(resp,'Retry-After'));
end;
if (CkHttpResponse_getStatusCode(resp) = 401) then
begin
Memo1.Lines.Add('Refresh the Graph access token or authorize again.');
end;
Exit;
end;
success := CkJsonObject_Load(result,CkHttpResponse__bodyStr(resp));
if (success <> True) then
begin
Memo1.Lines.Add('Expected a well-formed JSON response.');
Exit;
end;
if ((CkJsonObject_JsonTypeOf(result,'id') <> 1) or (CkJsonObject_StringOfEquals(result,'id','',True) = True)) then
begin
Memo1.Lines.Add('Expected a nonempty id in the JSON.');
Exit;
end;
Memo1.Lines.Add('Copied folder ID: ' + CkJsonObject__stringOf(result,'id'));
Memo1.Lines.Add('Parent folder ID: ' + CkJsonObject__stringOf(result,'parentFolderId'));
CkJsonObject_Dispose(token);
CkHttp_Dispose(http);
CkHttpResponse_Dispose(resp);
CkJsonObject_Dispose(result);
CkJsonObject_Dispose(body);
CkStringBuilder_Dispose(endpoint);