Get Folders

description retrieves a list of email folders from the specified 'email address' using the microsoft graph api endpoint url v1 0/users/{{email address}}/mailfolders method get inputs path parameters (object) – required path parameters email address (string) – required the account associated with the email parameters (object) parameters include hidden folders (boolean) include hidden folders in the results output example \[ { "status code" 200, "response headers" { "cache control" "private", "transfer encoding" "chunked", "content type" "application/json; odata metadata=minimal; odata streaming=true; ieee754compatible=false; charset=utf 8", "content encoding" "gzip", "vary" "accept encoding", "strict transport security" "max age=31536000", "request id" "2da48e9f b869 4db1 8603 6d81205534f9", "client request id" "2da48e9f b869 4db1 8603 6d81205534f9", "x ms ags diagnostic" "{\\"serverinfo\\" {\\"datacenter\\" \\"brazil south\\",\\"slice\\" \\"e\\",\\"ring\\" \\"3\\",\\"scaleunit\\" \\"002\\",\\"roleinstance\\" \\"cp1pepf00002f10\\"}}", "date" "fri, 04 nov 2022 20 43 54 gmt" }, "reason" "ok", "json body" { "@odata context" "https //graph microsoft com/v1 0/$metadata#users('integrations%40swimlaneintegrations onmicrosoft com')/mailfolders", "value" \[ { "id" "aqmkadmxzmu3zwq4ltmzadriltrmn2qtyjnlms1jnza0mzhlyzm5zdcalgaaawdg c5xaxzksv7iu pcczmbaielfp3 iinmukudjlg8 qiaaaibowaaaa==", "displayname" "archive", "parentfolderid" "aqmkadmxzmu3zwq4ltmzadriltrmn2qtyjnlms1jnza0mzhlyzm5zdcalgaaawdg c5xaxzksv7iu pcczmbaielfp3 iinmukudjlg8 qiaaaibcaaaaa==", "childfoldercount" 0, "unreaditemcount" 1, "totalitemcount" 7, "sizeinbytes" 777420, "ishidden" false }, { "id" "aqmkadmxzmu3zwq4ltmzadriltrmn2qtyjnlms1jnza0mzhlyzm5zdcalgaaawdg c5xaxzksv7iu pcczmbaielfp3 iinmukudjlg8 qiaaaibnaaaaa==", "displayname" "conversation history", "parentfolderid" "aqmkadmxzmu3zwq4ltmzadriltrmn2qtyjnlms1jnza0mzhlyzm5zdcalgaaawdg c5xaxzksv7iu pcczmbaielfp3 iinmukudjlg8 qiaaaibcaaaaa==", "childfoldercount" 1, "unreaditemcount" 0, "totalitemcount" 0, "sizeinbytes" 0, "ishidden" false }, { "id" "aqmkadmxzmu3zwq4ltmzadriltrmn2qtyjnlms1jnza0mzhlyzm5zdcalgaaawdg c5xaxzksv7iu pcczmbaielfp3 iinmukudjlg8 qiaaaibcgaaaa==", "displayname" "deleted items", "parentfolderid" "aqmkadmxzmu3zwq4ltmzadriltrmn2qtyjnlms1jnza0mzhlyzm5zdcalgaaawdg c5xaxzksv7iu pcczmbaielfp3 iinmukudjlg8 qiaaaibcaaaaa==", "childfoldercount" 0, "unreaditemcount" 0, "totalitemcount" 82, "sizeinbytes" 6203144, "ishidden" false }, { "id" "aqmkadmxzmu3zwq4ltmzadriltrmn2qtyjnlms1jnza0mzhlyzm5zdcalgaaawdg c5xaxzksv7iu pcczmbaielfp3 iinmukudjlg8 qiaaaibdwaaaa==", "displayname" "drafts", "parentfolderid" "aqmkadmxzmu3zwq4ltmzadriltrmn2qtyjnlms1jnza0mzhlyzm5zdcalgaaawdg c5xaxzksv7iu pcczmbaielfp3 iinmukudjlg8 qiaaaibcaaaaa==", "childfoldercount" 0, "unreaditemcount" 0, "totalitemcount" 0, "sizeinbytes" 0, "ishidden" false }, { "id" "aqmkadmxzmu3zwq4ltmzadriltrmn2qtyjnlms1jnza0mzhlyzm5zdcalgaaawdg c5xaxzksv7iu pcczmbaielfp3 iinmukudjlg8 qiaaaibdaaaaa==", "displayname" "inbox", "parentfolderid" "aqmkadmxzmu3zwq4ltmzadriltrmn2qtyjnlms1jnza0mzhlyzm5zdcalgaaawdg c5xaxzksv7iu pcczmbaielfp3 iinmukudjlg8 qiaaaibcaaaaa==", "childfoldercount" 1, "unreaditemcount" 1, "totalitemcount" 62, "sizeinbytes" 14221822, "ishidden" false }, { "id" "aqmkadmxzmu3zwq4ltmzadriltrmn2qtyjnlms1jnza0mzhlyzm5zdcalgaaawdg c5xaxzksv7iu pcczmbaielfp3 iinmukudjlg8 qiaaaibgqaaaa==", "displayname" "junk email", "parentfolderid" "aqmkadmxzmu3zwq4ltmzadriltrmn2qtyjnlms1jnza0mzhlyzm5zdcalgaaawdg c5xaxzksv7iu pcczmbaielfp3 iinmukudjlg8 qiaaaibcaaaaa==", "childfoldercount" 0, "unreaditemcount" 1, "totalitemcount" 1, "sizeinbytes" 50975, "ishidden" false }, { "id" "aqmkadmxzmu3zwq4ltmzadriltrmn2qtyjnlms1jnza0mzhlyzm5zdcalgaaawdg c5xaxzksv7iu pcczmbaielfp3 iinmukudjlg8 qiaaaibcwaaaa==", "displayname" "outbox", "parentfolderid" "aqmkadmxzmu3zwq4ltmzadriltrmn2qtyjnlms1jnza0mzhlyzm5zdcalgaaawdg c5xaxzksv7iu pcczmbaielfp3 iinmukudjlg8 qiaaaibcaaaaa==", "childfoldercount" 0, "unreaditemcount" 0, "totalitemcount" 0, "sizeinbytes" 0, "ishidden" false }, { "id" "aamkadmxzmu3zwq4ltmzngitngy3zc1im2uxlwm3mdqzogvjmzlknwauaaaaaaahypwuvwmwsrfeylv6xhmzaqcbjrt9 oidtlplg45rvpkcaagycwu6aaa=", "displayname" "quarantine", "parentfolderid" "aqmkadmxzmu3zwq4ltmzadriltrmn2qtyjnlms1jnza0mzhlyzm5zdcalgaaawdg c5xaxzksv7iu pcczmbaielfp3 iinmukudjlg8 qiaaaibcaaaaa==", "childfoldercount" 0, "unreaditemcount" 0, "totalitemcount" 1, "sizeinbytes" 16890, "ishidden" false }, { "id" "aqmkadmxzmu3zwq4ltmzadriltrmn2qtyjnlms1jnza0mzhlyzm5zdcalgaaawdg c5xaxzksv7iu pcczmbaielfp3 iinmukudjlg8 qiaaaibcqaaaa==", "displayname" "sent items", "parentfolderid" "aqmkadmxzmu3zwq4ltmzadriltrmn2qtyjnlms1jnza0mzhlyzm5zdcalgaaawdg c5xaxzksv7iu pcczmbaielfp3 iinmukudjlg8 qiaaaibcaaaaa==", "childfoldercount" 0, "unreaditemcount" 0, "totalitemcount" 1057, "sizeinbytes" 45926120, "ishidden" false }, { "id" "aamkadmxzmu3zwq4ltmzngitngy3zc1im2uxlwm3mdqzogvjmzlknwauaaaaaaahypwuvwmwsrfeylv6xhmzaqcbjrt9 oidtlplg45rvpkcaaamxawjaaa=", "displayname" "testfolder", "parentfolderid" "aqmkadmxzmu3zwq4ltmzadriltrmn2qtyjnlms1jnza0mzhlyzm5zdcalgaaawdg c5xaxzksv7iu pcczmbaielfp3 iinmukudjlg8 qiaaaibcaaaaa==", "childfoldercount" 1, "unreaditemcount" 0, "totalitemcount" 11, "sizeinbytes" 578098, "ishidden" false } ], "@odata nextlink" "https //graph microsoft com/v1 0/users/integrations\@swimlaneintegrations onmicrosoft com/mailfolders?include hidden folders=true&%24skip=10" } } ] output parameters status code (number) reason (string) json body (object) @odata context (string) value (array) id (string) displayname (string) parentfolderid (string) childfoldercount (number) unreaditemcount (number) totalitemcount (number) sizeinbytes (number) ishidden (boolean) @odata nextlink (string) response headers header type cache control string transfer encoding string content type string content encoding string vary string strict transport security string request id string client request id string x ms ags diagnostic string date string