Microsoft OneNote

onenote

Digital notebook for capturing and organizing notes, drawings, and information

Productivity Notes Web del proveedor

Acciones

Triggers

Autenticación

—

OAuth gestionado

Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

Acciones disponibles (62)

Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.

Copy notebook in groupONENOTE_COPY_ONENOTE_GROUP_NOTEBOOKAcción

Copies a OneNote notebook to the Notebooks folder in the destination Documents library. The notebook is copied asynchronously. This action initiates the copy operation and returns a 202 Accepted response with an Operation-Location header. Use the OnenoteOperationGet action to poll the Operation-Location endpoint to check the status of the copy operation until it completes. Use this action when you need to duplicate a notebook within a Microsoft 365 group, or copy it to a different group's documents library. The copied notebook's folder is created in the destination Documents library if it doesn't exist.

Parámetros de entrada

groupIdstring
The ID of the destination Microsoft 365 group to copy the notebook to. Use only when copying to a different Microsoft 365 group.
group_idstringObligatorio
The unique identifier of the Microsoft 365 group containing the notebook.
renameAsstring
The name to assign to the copied notebook. If not specified, the copy retains the name of the original notebook.
notebook_idstringObligatorio
The unique identifier of the OneNote notebook to copy.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Copy notebook in siteONENOTE_COPY_ONENOTE_SITE_NOTEBOOKAcción

Copies a OneNote notebook to the destination site in the SharePoint documents library. Use this action when you need to duplicate a notebook within a SharePoint site, or copy it to a different site's documents library. The copied notebook's folder is created in the destination documents library if it doesn't exist. This is an asynchronous operation — the API returns a 202 Accepted response with an Operation-Location header. Poll the provided URL to check whether the copy has completed. The copied notebook becomes available at the destination site once the operation succeeds.

Parámetros de entrada

folderstring
The name of the destination folder in the destination site where the notebook will be copied. If not specified, the notebook is copied to the root folder.
site_idstringObligatorio
The unique identifier of the SharePoint site containing the notebook.
renameAsstring
The name to assign to the copied notebook. If not specified, the copy retains the name of the original notebook.
notebook_idstringObligatorio
The unique identifier of the OneNote notebook to copy.
destinationIdstring
The ID of the site to copy the notebook to. Use only when copying to a different SharePoint site.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Copy section to notebook (site context)ONENOTE_COPY_SECTION_TO_NOTEBOOK2Acción

Copies a OneNote section to a specific notebook within a SharePoint site. Use this action when you need to duplicate an existing OneNote section into a different notebook within the same SharePoint site. The operation is asynchronous and returns an Operation-Location header that should be polled to get the final result. This action is irreversible once the copy operation is initiated.

Parámetros de entrada

idstringObligatorio
The unique identifier of the destination notebook to copy the section into. Required.
site_idstringObligatorio
The unique identifier of the SharePoint site that contains the notebook.
group_idstring
The ID of the Microsoft 365 group to copy to. Use only when copying to a Microsoft 365 group.
rename_asstring
The name to assign to the copied section. If not specified, defaults to the name of the original section.
section_idstringObligatorio
The unique identifier of the OneNote section to copy.
notebook_idstringObligatorio
The unique identifier of the OneNote notebook containing the section to copy.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Copy section to notebook (user)ONENOTE_COPY_SECTION_TO_NOTEBOOK_FOR_USER2Acción

Copies a OneNote section to a specific notebook for a specified user. Use this action when you need to duplicate an existing OneNote section into a different notebook under a specific user's account. The operation is asynchronous and returns an Operation-Location header that should be polled to get the final result. This action is irreversible once the copy operation is initiated.

Parámetros de entrada

idstringObligatorio
The unique identifier of the destination notebook to copy the section into. Required.
user_idstringObligatorio
The unique identifier (ID or userPrincipalName) of the user who owns the section.
group_idstring
The ID of the Microsoft 365 group to copy the section to. Use only when copying to a Microsoft 365 group.
rename_asstring
The name to assign to the copied section. If not specified, defaults to the name of the original section.
section_idstringObligatorio
The unique identifier of the OneNote section to copy.
notebook_idstringObligatorio
The unique identifier of the source notebook that contains the section to copy.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Copy group section to section groupONENOTE_COPY_SECTION_TO_SECTION_GROUPAcción

Copies a OneNote section from a Microsoft 365 group's notebook into another section group. Use this action when you need to duplicate an existing OneNote section that lives in a Microsoft 365 group's notebook into a different section group. The operation is asynchronous and returns an Operation-Location header that should be polled to get the final result. This action is irreversible once the copy operation is initiated.

Parámetros de entrada

idstringObligatorio
The unique identifier of the destination section group where the section will be copied. Required.
group_idstringObligatorio
The unique identifier of the Microsoft 365 group whose notebook owns the source section.
rename_asstring
The name to assign to the copied section. If not specified, defaults to the name of the original section.
section_idstringObligatorio
The unique identifier of the source section to copy.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Copy section to section group (user)ONENOTE_COPY_SECTION_TO_SECTION_GROUP_FOR_USERAcción

Copies a OneNote section to a specific section group for a specified user. Use this action when you need to duplicate an existing OneNote section into a different section group under a specific user's account. The operation is asynchronous and returns an Operation-Location header that should be polled to get the final result. This action is irreversible once the copy operation is initiated.

Parámetros de entrada

idstringObligatorio
The unique identifier of the destination section group where the section will be copied. Required.
user_idstringObligatorio
The unique identifier (ID or userPrincipalName) of the user who owns the section.
group_idstring
The ID of the Microsoft 365 group to copy to. Use only when copying to a Microsoft 365 group.
rename_asstring
The name to assign to the copied section. If not specified, defaults to the name of the original section.
section_idstringObligatorio
The unique identifier of the source section to copy.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Copy site page to sectionONENOTE_COPY_SITE_PAGE_TO_SECTION3Acción

Copies a OneNote page from a SharePoint site to a destination section. Use this action when you need to duplicate a OneNote page into a different section within the same or a different SharePoint site's notebook. The operation is asynchronous and returns a 202 Accepted response with an Operation-Location header. Poll that endpoint to determine when the copy completes and get the result of the operation. This is an asynchronous operation — the API returns a 202 Accepted response with an Operation-Location header. Poll the provided URL to check whether the copy has completed.

Parámetros de entrada

idstringObligatorio
Required. The unique identifier of the destination section to copy the page to.
siteIdstring
The unique identifier of the destination SharePoint web. Use only when copying to a SharePoint site.
groupIdstring
The id of the Microsoft 365 group to copy to. Use only when copying to a Microsoft 365 group.
page_idstringObligatorio
The unique identifier of the OneNote page to copy.
site_idstringObligatorio
The unique identifier of the SharePoint site that contains the notebook.
siteCollectionIdstring
The unique identifier of the SharePoint site collection. Use only when copying to a SharePoint site.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Copy user page to sectionONENOTE_COPY_USER_PAGE_TO_SECTIONAcción

Copy a OneNote page from a user's notebook to a specified section. Use this action when you need to duplicate a OneNote page into a different section within a user's Microsoft 365 account. This is an asynchronous operation that returns a 202 Accepted response with an Operation-Location header. Poll that endpoint to determine when the copy completes and get the result of the operation. The page is identified by its full path through the notebook's hierarchy.

Parámetros de entrada

idstringObligatorio
Required. The unique identifier of the destination section to copy the page to.
groupIdstring
The unique identifier of the destination Microsoft 365 group. Use only when copying to a group.
page_idstringObligatorio
The unique identifier of the OneNote page to copy.
user_idstringObligatorio
The unique identifier or user principal name of the user who owns the page.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Count notebook section group sectionsONENOTE_COUNT_NOTEBOOKS_SECTION_GROUPS_SECTIONSAcción

Gets the count of OneNote sections within a section group in a user's notebook. Use this action when you need to quickly determine the number of sections in a section group without retrieving the full list of section objects. This is a read-only operation.

Parámetros de entrada

user_idstringObligatorio
The unique identifier of the Microsoft Graph user. Use 'me' for the current authenticated user.
section_group_idstringObligatorio
The unique identifier of the section group within the notebook.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Count site notebook section group sectionsONENOTE_COUNT_SITE_NOTEBOOK_SECTION_GROUPS_SECTIONSAcción

Gets the count of sections within a OneNote section group in a SharePoint site notebook. Use this action when you need to quickly determine the number of sections in a section group without retrieving the full list of section objects. Microsoft Graph requires the `ConsistencyLevel: eventual` header when using the `$count=true` query parameter on OneNote endpoints.

Parámetros de entrada

site_idstringObligatorio
The unique identifier of the SharePoint site.
notebook_idstringObligatorio
The unique identifier of the OneNote notebook within the site.
section_group_idstringObligatorio
The unique identifier of the section group within the notebook.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create group notebookONENOTE_CREATE_GROUP_NOTEBOOKAcción

Creates a new OneNote notebook within a Microsoft 365 group. Use this action when you need to create a new notebook for storing notes within a specific Microsoft 365 group. The notebook will be owned by the specified group and accessible to all members of that group with appropriate permissions. Required permissions: Notes.Create (least privileged), Notes.ReadWrite, or Notes.ReadWrite.All for the group.

Parámetros de entrada

group_idstringObligatorio
The unique identifier of the Microsoft 365 group that will own the notebook.
display_namestringObligatorio
The name of the new notebook. This is the only required field when creating a notebook.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create group OneNote pageONENOTE_CREATE_GROUP_PAGESAcción

Creates a new OneNote page in the default section of the default notebook for a Microsoft 365 group. Use this action when you need to programmatically create a new page in a group's OneNote notebook. The page content must be provided as HTML. The page will be created in the default section of the default notebook unless a specific section name is provided via the sectionName query parameter.

Parámetros de entrada

group_idstringObligatorio
The unique identifier of the Microsoft 365 group.
html_contentstringObligatorio
The HTML content for the OneNote page. Must be valid HTML including html, head, and body tags.
section_namestring
Optional section name to create the page in a specific section of the default notebook. If the section doesn't exist, a new section will be created.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create section in section groupONENOTE_CREATE_GROUP_SECTION_GROUPS_SECTIONSAcción

Creates a new OneNote section within a specified section group of a Microsoft 365 group. Use this action when you need to add a new section to organize OneNote pages within a section group's hierarchy within a group. The section name must be unique within the same hierarchy level, cannot exceed 50 characters, and cannot contain the characters: ?*/:<>|&#''%~. This action is idempotent — calling it multiple times with the same display name may create duplicate sections depending on the API's handling of unique-name constraints.

Parámetros de entrada

group_idstringObligatorio
The unique identifier of the Microsoft 365 group.
display_namestringObligatorio
The name of the new section. Must be 50 characters or fewer and cannot contain the characters: ?*/:<>|&#''%~
section_group_idstringObligatorio
The unique identifier of the section group within the group.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create user notebookONENOTE_CREATE_ME_NOTEBOOKSAcción

Creates a new OneNote notebook for the signed-in user. Use this action when you need to create a new personal notebook to organize notes. The notebook will be created in the user's default OneDrive for Business location. Notebook names must be unique and cannot exceed 128 characters or contain special characters (?*\/:<>|&'""). Returns the full created notebook object including the server-assigned ID and URLs for accessing sections.

Parámetros de entrada

display_namestringObligatorio
The name of the new notebook. Must be 128 characters or fewer and cannot contain the characters: ?*\/:<>|&'"

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create section in user's section groupONENOTE_CREATE_ME_SECTION_GROUPS_SECTIONSAcción

Creates a new OneNote section within a specified section group of a notebook for the signed-in user. Use this action when you need to add a new section to organize OneNote pages within a user's section group hierarchy. The section name must be unique within the same hierarchy level, cannot exceed 50 characters, and cannot contain the characters: ?*/:<>|&#''%~. This action is idempotent — calling it multiple times with the same display name may create duplicate sections depending on the API's handling of unique-name constraints.

Parámetros de entrada

display_namestringObligatorio
The name of the new section. Must be 50 characters or fewer and cannot contain the characters: ?*/:<>|&#''%~
section_group_idstringObligatorio
The unique identifier of the section group within the notebook.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create OneNote page in sectionONENOTE_CREATE_ME_SECTIONS_PAGESAcción

Creates a new OneNote page in a specific section for the signed-in user. Use this action when you need to create a new page within a specific section of the user's OneNote notebook. The page content must be provided as HTML. The action constructs a complete HTML document including the title and optional creation timestamp in the meta tag. To include images or attachments, provide the full HTML with external image URLs, or use a multipart request approach. This action is idempotent - creating multiple pages with the same title creates separate pages.

Parámetros de entrada

page_titlestringObligatorio
The title for the OneNote page.
section_idstringObligatorio
The unique identifier of the OneNote section where the page will be created.
html_contentstringObligatorio
The HTML body content for the OneNote page (an HTML fragment, not a full document). The action wraps this fragment in <html><head><title>{page_title}</title></head><body>...</body></html>, so do not include outer html/head/body tags. Reference images via external URLs.
page_created_datetimestring
The date and time when the page was created in ISO 8601 format (UTC). Example: 2015-07-22T09:00:00-08:00. If not provided, current time is used.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create section group in group notebookONENOTE_CREATE_ONENOTE_GROUP_NOTEBOOKS_SECTION_GROUPSAcción

Creates a new section group within a OneNote notebook that belongs to a Microsoft 365 group. Use this action when you need to organize sections inside a group notebook by creating a new top-level section group to hold related sections together. The displayName must be 50 characters or fewer and cannot contain the characters ? * / : < > | & # ' % ~. Section group names must be unique within the same hierarchy level in the notebook.

Parámetros de entrada

group_idstringObligatorio
The unique identifier of the Microsoft 365 group that owns the notebook.
notebook_idstringObligatorio
The unique identifier of the OneNote notebook in the group.
display_namestringObligatorio
The name of the new section group. Must be 50 characters or fewer. Cannot contain the characters: ? * / : < > | & # ' % ~

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create section in site notebookONENOTE_CREATE_SITE_NOTEBOOKS_SECTIONSAcción

Creates a new OneNote section within a specified notebook in a SharePoint site. Use this action when you need to add a new section to organize OneNote pages within a notebook that belongs to a SharePoint site. The section name must be unique within the same hierarchy level, cannot exceed 50 characters, and cannot contain the characters: ?*/:<>|&#''%~. This action is available in the following national cloud deployments: Global service only. Required permissions: Notes.Create (delegated/personal account), Notes.ReadWrite.All (application).

Parámetros de entrada

site_idstring
The unique identifier of the SharePoint site that contains the notebook. Optional - if not provided, uses the user's personal OneNote.
notebook_idstringObligatorio
The unique identifier of the OneNote notebook within the site.
display_namestringObligatorio
The name of the new section. Must be 50 characters or fewer and cannot contain the characters: ?*/:<>|&#''%~

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create section in user notebookONENOTE_CREATE_USER_NOTEBOOKS_SECTIONSAcción

Creates a new OneNote section within a specified notebook for a specific user. Use this action when you need to add a new section to organize OneNote pages within a notebook that belongs to a specific user. The section name must be unique within the same hierarchy level, cannot exceed 50 characters, and cannot contain the characters: ?*/:<>|&#''%~. Returns the full created section object including the server-assigned ID.

Parámetros de entrada

user_idstringObligatorio
The unique identifier of the user. Use 'me' for the current signed-in user.
notebook_idstringObligatorio
The unique identifier of the OneNote notebook.
display_namestringObligatorio
The name of the new section. Must be 50 characters or fewer and cannot contain the characters: ?*/:<>|&#''%~

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create user OneNote pageONENOTE_CREATE_USER_PAGESAcción

Creates a new OneNote page in the default section of the default notebook for a specific user. Use this action when you need to programmatically create a new page in a user's OneNote notebook. The page content must be provided as HTML. The page will be created in the default section of the default notebook unless a specific section name is provided via the sectionName query parameter.

Parámetros de entrada

user_idstringObligatorio
The unique identifier or user principal name (UPN) of the user who owns the OneNote notebook.
html_contentstringObligatorio
The HTML content for the OneNote page. Must be valid HTML including html, head, and body tags.
section_namestring
Optional section name to create the page in a specific section of the default notebook. If the section doesn't exist, a new section will be created.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create section in user section groupONENOTE_CREATE_USER_SECTION_GROUPS_SECTIONSAcción

Creates a new OneNote section within a specified section group for a specific user. Use this action when you need to add a new section to organize OneNote pages within a section group's hierarchy for a specific user's notebook. The section name must be unique within the same hierarchy level, cannot exceed 50 characters, and cannot contain the characters: ?*/:<>|&#''%~. This action is idempotent — calling it multiple times with the same display name may create duplicate sections depending on the API's handling of unique-name constraints.

Parámetros de entrada

user_idstringObligatorio
The unique identifier of the Microsoft Graph user. Use 'me' for the current authenticated user.
display_namestringObligatorio
The name of the new section. Must be 50 characters or fewer and cannot contain the characters: ?*/:<>|&#''%~
section_group_idstringObligatorio
The unique identifier of the section group.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create user section pageONENOTE_CREATE_USER_SECTIONS_PAGES4Acción

Creates a new OneNote page in a specific section of a user's notebook. Use this action when you need to create a new page directly in a section within a user's OneNote notebook. The page content must be provided as valid HTML with proper structure (html, head, and body tags). This action requires the Content-Type header to be set to text/html for the request body. This action is idempotent — calling it multiple times creates separate pages.

Parámetros de entrada

user_idstringObligatorio
The unique identifier of the Microsoft Graph user. Use 'me' for the current authenticated user.
page_titlestring
The title for the OneNote page. Required when page_created_datetime is provided, because OneNote requires a title in the HTML head section generated by this action.
section_idstringObligatorio
The unique identifier of the OneNote section where the page will be created.
html_contentstringObligatorio
The HTML for the OneNote page. If neither page_title nor page_created_datetime is provided, send a complete HTML document (with html/head/body tags). If either is provided, send only the body fragment — the action wraps it in <html><head><title>{page_title}</title>...</head><body>...</body></html> for you, so do not include outer html/head/body tags in that case.
page_created_datetimestring
The date and time when the page was created in ISO 8601 format (UTC). Example: 2015-07-22T09:00:00-08:00. If not provided, current time is used.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete page content from section group sectionONENOTE_DELETE_ONENOTE_GROUP_SECTION_GROUP_PAGE_CONTENTAcción

Deletes the HTML content of a OneNote page within a section in a section group in a Microsoft 365 group's OneNote workspace. This action is irreversible — the page content will be permanently deleted once removed. Use this action when you need to clear the content of a specific OneNote page within a section group hierarchy in a Microsoft 365 group.

Parámetros de entrada

page_idstringObligatorio
The unique identifier of the OneNote page whose content will be deleted.
group_idstringObligatorio
The unique identifier of the Microsoft 365 group.
section_idstringObligatorio
The unique identifier of the section within the section group.
section_group_idstringObligatorio
The unique identifier of the section group within the group's OneNote workspace.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete OneNote page from sectionONENOTE_DELETE_ONENOTE_GROUP_SECTIONS_PAGES2Acción

Delete a specific OneNote page from a section within a notebook in a group. Use this action when you need to remove a OneNote page permanently from a group's notebook section. This action is irreversible - once deleted, the page cannot be recovered.

Parámetros de entrada

page_idstringObligatorio
The unique identifier of the OneNote page to delete.
group_idstringObligatorio
The unique identifier of the Microsoft 365 group.
section_idstringObligatorio
The unique identifier of the section within the notebook.
notebook_idstringObligatorio
The unique identifier of the OneNote notebook within the group.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete OneNote page from siteONENOTE_DELETE_SITE_PAGESAcción

Deletes a OneNote page from a SharePoint site. Use this action when you need to remove a OneNote page permanently from a SharePoint site's OneNote workspace. This action is irreversible - once deleted, the page and all its content cannot be recovered.

Parámetros de entrada

page_idstringObligatorio
The unique identifier of the OneNote page to delete.
site_idstringObligatorio
The unique identifier of the SharePoint site. Can be the site hostname or server-relative path.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete user OneNote page from sectionONENOTE_DELETE_USER_ONENOTE_SECTIONS_PAGESAcción

Deletes a OneNote page from a section within a section group in a user's notebook. This action is irreversible — the page and all its content will be permanently deleted once removed. Use this action when you need to remove an unwanted page from a section in a user's OneNote notebook.

Parámetros de entrada

page_idstringObligatorio
The unique identifier of the OneNote page to delete.
user_idstringObligatorio
The unique identifier of the Microsoft Graph user. Use 'me' for the current authenticated user.
section_idstringObligatorio
The unique identifier of the section within the section group.
notebook_idstringObligatorio
The unique identifier of the OneNote notebook containing the section group.
section_group_idstringObligatorio
The unique identifier of the section group within the notebook.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete OneNote page for userONENOTE_DELETE_USER_PAGESAcción

Deletes a OneNote page from a user's OneNote workspace. This action is irreversible — the page and all its content will be permanently deleted once removed. Use this action when you need to remove an unwanted OneNote page from a user's notebook that has been shared with the current user.

Parámetros de entrada

page_idstringObligatorio
The unique identifier of the OneNote page to delete.
user_idstringObligatorio
The unique identifier of the Microsoft 365 user.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get a OneNote section from a groupONENOTE_GET_GROUP_SECTIONSAcción

Retrieves a specific OneNote section from a Microsoft 365 group. Use this action when you need to fetch metadata or details for a single OneNote section by specifying the group ID and section ID. This action supports OData query parameters for selecting specific properties and expanding relationships like parentNotebook or parentSectionGroup.

Parámetros de entrada

expandstring[]
Comma-separated list of relationships to expand inline in the response. Valid values: parentNotebook, parentSectionGroup.
selectstring[]
Comma-separated list of section properties to include in the response. Valid values include: id, self, createdDateTime, displayName, createdBy, lastModifiedBy, lastModifiedDateTime, isDefault, links, pagesUrl, parentNotebook, parentSectionGroup.
group_idstringObligatorio
The unique identifier of the Microsoft 365 group.
section_idstringObligatorio
The unique identifier of the OneNote section to retrieve.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get OneNote resource content by IDONENOTE_GET_ME_ONENOTE_RESOURCES_VALUEAcción

Retrieves the binary content of a specific OneNote resource using its ID. Use this action when you need to fetch the raw binary content of an image, file attachment, or other embedded resource from a OneNote page in the signed-in user's notebooks. The resource is identified by its unique resource_id, which can be obtained from page content URLs. Note: Binary content is returned as-is; images and files may need additional processing (e.g., base64 decoding or writing to a file) depending on your use case.

Parámetros de entrada

resource_idstringObligatorio
The unique identifier of the OneNote resource (e.g., image, file attachment, or other embedded content).

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get OneNote page content from sectionONENOTE_GET_ME_SECTION_PAGE_CONTENTAcción

Retrieves the HTML content of a specific OneNote page from a section for the signed-in user. Use this action when you need to fetch the full HTML content of a OneNote page within a specific section. This endpoint provides access to page content for processing, rendering, or exporting page data. The returned HTML includes text, images, and other embedded content references. This action is read-only and does not modify any data.

Parámetros de entrada

page_idstringObligatorio
The unique identifier of the OneNote page. This can be the full resource path including the section ID.
include_idsboolean
Optional. When set to true, the returned HTML includes IDs for page elements. Useful when you need to identify elements for updates or modifications.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get notebook from web URLONENOTE_GET_NOTEBOOK_FROM_WEB_URLAcción

Retrieves a OneNote notebook by using its web URL path. Use this action when you have the SharePoint or OneDrive URL of a notebook and need to retrieve its properties and metadata. The webUrl parameter accepts both standard HTTPS URLs and OneNote protocol URLs with the 'onenote:' prefix. This API is available in the following national cloud deployments: Global service only. Required permissions: Notes.Create (delegated) or Notes.Read.All (application).

Parámetros de entrada

user_idstringObligatorio
The unique identifier (ID) or user principal name (UPN) of the user whose notebook to retrieve.
web_urlstringObligatorio
The URL path of the notebook to retrieve. Can also contain an 'onenote:' prefix.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get notebook section groupONENOTE_GET_NOTEBOOK_SECTION_GROUPAcción

Retrieves a specific section group from a OneNote notebook within a Microsoft 365 group. Use this action when you need to get details about a specific section group, including its name, creation/modification timestamps, and links to its sections and nested section groups.

Parámetros de entrada

expandstring
Comma-separated list of relationships to expand (e.g., 'parentNotebook,parentSectionGroup').
selectstring
Comma-separated list of properties to include in the response.
group_idstringObligatorio
The unique identifier of the Microsoft 365 group.
section_group_idstringObligatorio
The unique identifier of the section group within the group's OneNote.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get group OneNote operation statusONENOTE_GET_ONENOTE_GROUP_OPERATIONSAcción

Retrieves the status of a long-running OneNote operation for a group. Use this action when you need to check whether a copy or sync operation (e.g., CopyNotebook, CopyToNotebook, CopyToSectionGroup, CopyToSection) has completed, failed, or is still in progress.

Parámetros de entrada

group_idstringObligatorio
The unique identifier of the Microsoft 365 group that owns the OneNote notebook.
operation_idstringObligatorio
The unique identifier of the long-running OneNote operation to retrieve.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get a OneNote page from a section group sectionONENOTE_GET_ONENOTE_GROUP_SECTIONS_PAGESAcción

Retrieves a specific OneNote page from a section within a section group in a Microsoft 365 group's notebook. Use this action when you need to fetch metadata or details for a single OneNote page by navigating through its parent group, notebook, section group, and section hierarchy.

Parámetros de entrada

expandstring[]
Comma-separated list of relationships to expand inline in the response. Valid values: parentSection, parentNotebook.
selectstring[]
Comma-separated list of page properties to include in the response. Valid values include: id, self, title, createdDateTime, lastModifiedDateTime, content, contentUrl, createdByAppId, level, order, links, parentSection, parentNotebook.
page_idstringObligatorio
The unique identifier of the OneNote page to retrieve.
group_idstringObligatorio
The unique identifier of the Microsoft 365 group.
section_idstringObligatorio
The unique identifier of the section within the section group.
notebook_idstringObligatorio
The unique identifier of the OneNote notebook within the group.
section_group_idstringObligatorio
The unique identifier of the section group within the notebook.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get site OneNote operation statusONENOTE_GET_ONENOTE_SITE_OPERATIONSAcción

Retrieves the status of a long-running OneNote operation for a SharePoint site. Use this action when you need to check whether a copy or sync operation (e.g., CopyNotebook, CopyToNotebook, CopyToSectionGroup, CopyToSection) has completed, failed, or is still in progress for a site.

Parámetros de entrada

site_idstringObligatorio
The unique identifier of the SharePoint site that owns the OneNote notebook. This can be the server-relative path (e.g., contoso.sharepoint.com,3e3b477e-21ed-448b-a7fe-573b718dc5ff,3d7e3c8f-7133-4b2d-ba53-418d9ef48bab).
operation_idstringObligatorio
The unique identifier of the long-running OneNote operation to retrieve.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get OneNote page content for userONENOTE_GET_ONENOTE_USER_PAGE_CONTENTAcción

Gets the HTML content of a specific OneNote page for a user. Use this action when you need to retrieve the actual HTML content of a specific OneNote page for reading, processing, or displaying page content. The action supports the includeIDs query parameter to include element IDs in the HTML, which is useful when preparing content for page updates via the PATCH endpoint.

Parámetros de entrada

page_idstringObligatorio
The unique identifier of the OneNote page to get content from.
user_idstringObligatorio
The unique identifier of the Microsoft Graph user. Use 'me' for the current user, or specify a user ID (GUID) or user principal name (email).
include_idsboolean
When true, the returned HTML includes IDs that can be used to update the page. Use this when preparing content for page updates.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get OneNote page from siteONENOTE_GET_SITE_ONENOTE_PAGESAcción

Retrieves a specific OneNote page from a SharePoint site. Use this action when you need to fetch metadata or details for a single OneNote page by its page identifier within a SharePoint site. This action supports optional OData query parameters to select specific properties or expand related entities like parentSection and parentNotebook. Note: This action is read-only and does not modify any data.

Parámetros de entrada

expandstring[]
List of relationships to expand inline in the response. Valid values: 'parentSection', 'parentNotebook'.
selectstring[]
List of page properties to include in the response. Common values: 'id', 'title', 'createdDateTime', 'lastModifiedDateTime', 'content', 'contentUrl', 'createdByAppId', 'level', 'order', 'links', 'parentSection', 'parentNotebook'.
page_idstringObligatorio
The unique identifier of the OneNote page to retrieve. This is the full page ID including any section path prefix (e.g., '1-abc123!71-7aef1f00-3deb-4ee2-93ab-979eb24a3037').
site_idstringObligatorio
The unique identifier of the SharePoint site. Use 'root' for the root site. For SharePoint sites, this is typically in the format: hostname,site-collection-id,site-id (e.g., 'contoso.sharepoint.com,12345678-1234-1234-1234-123456789012,87654321-4321-4321-4321-210987654321').

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get site notebook page previewONENOTE_GET_SITE_PAGES_PREVIEWAcción

Retrieves a text preview of a specific OneNote page from a section within a section group in a SharePoint site-hosted notebook. Use this action when you need to quickly get the content preview of a OneNote page from a site-hosted notebook without fetching the full page content. The preview returns a text snippet of the page's content. This action is read-only and does not modify any data.

Parámetros de entrada

page_idstringObligatorio
The unique identifier of the OneNote page.
site_idstring
The unique identifier of the SharePoint site. Optional - if not provided, uses the signed-in user's personal OneNote notebook.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get a OneNote section from a siteONENOTE_GET_SITE_SECTIONSAcción

Retrieves a specific OneNote section from a SharePoint site. Use this action when you need to fetch metadata or details for a single OneNote section by specifying the site ID and section ID. This action supports OData query parameters for selecting specific properties and expanding relationships like parentNotebook or parentSectionGroup.

Parámetros de entrada

expandstring[]
Comma-separated list of relationships to expand inline in the response. Valid values: parentNotebook, parentSectionGroup.
selectstring[]
Comma-separated list of section properties to include in the response. Valid values include: id, self, createdDateTime, displayName, createdBy, lastModifiedBy, lastModifiedDateTime, isDefault, links, pagesUrl, parentNotebook, parentSectionGroup.
site_idstringObligatorio
The unique identifier of the SharePoint site. Use 'root' for the root site.
section_idstringObligatorio
The unique identifier of the OneNote section to retrieve.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get OneNote page from site section group sectionONENOTE_GET_SITE_SECTIONS_PAGESAcción

Retrieves a specific OneNote page from a section within a section group in a SharePoint site notebook. Use this action when you need to fetch metadata or details for a single OneNote page by navigating through its parent site, notebook, section group, and section hierarchy. This is useful for retrieving page information from deeply nested notebook structures within SharePoint sites.

Parámetros de entrada

expandstring[]
Comma-separated list of relationships to expand inline in the response. Valid values: parentSection, parentNotebook.
selectstring[]
Comma-separated list of page properties to include in the response. Valid values include: id, self, title, createdDateTime, lastModifiedDateTime, content, contentUrl, createdByAppId, level, order, links, parentSection, parentNotebook.
page_idstringObligatorio
The unique identifier of the OneNote page to retrieve.
site_idstringObligatorio
The unique identifier of the SharePoint site. Use 'root' for the root site.
section_idstringObligatorio
The unique identifier of the section within the section group.
notebook_idstringObligatorio
The unique identifier of the OneNote notebook within the site.
section_group_idstringObligatorio
The unique identifier of the section group within the notebook.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get user notebookONENOTE_GET_USER_NOTEBOOKAcción

Retrieves the properties and relationships of a OneNote notebook by ID for a specific user. Use this action when you need to fetch details about a specific notebook belonging to a user, including its display name, sharing status, section URLs, and the user's role on the notebook. Supports OData $select and $expand query parameters to customize the response.

Parámetros de entrada

expandstring[]
Comma-separated list of relationships to expand (OData $expand). Valid values: sections, sectionGroups.
selectstring[]
Comma-separated list of notebook properties to include in the response (OData $select).
user_idstringObligatorio
The unique identifier of the Microsoft Graph user. Use 'me' for the current authenticated user.
notebook_idstringObligatorio
The unique identifier of the OneNote notebook.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get a OneNote page from userONENOTE_GET_USER_PAGESAcción

Retrieves a specific OneNote page from a user's OneNote notebooks. Use this action when you need to fetch metadata or details for a single OneNote page directly by page ID and user ID. This is useful for retrieving page information without navigating through the full notebook/section hierarchy. The default response expands the parentSection relationship and selects its id, name, and self properties.

Parámetros de entrada

expandstring[]
Comma-separated list of relationships to expand inline in the response. Valid values: parentSection, parentNotebook.
selectstring[]
Comma-separated list of page properties to include in the response. Valid values include: id, self, title, createdDateTime, lastModifiedDateTime, content, contentUrl, createdByAppId, level, order, links, parentSection, parentNotebook.
page_idstringObligatorio
The unique identifier of the OneNote page to retrieve.
user_idstringObligatorio
The unique identifier of the Microsoft Graph user. Use 'me' for the current authenticated user.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get parent section group from user sectionONENOTE_GET_USER_PARENT_SECTION_GROUP2Acción

Retrieves the parent section group of a OneNote section within a user's notebook. Use this action when you need to navigate up the OneNote hierarchy from a section to its parent section group, for example to determine which section group contains a specific section.

Parámetros de entrada

expandstring[]
Comma-separated list of relationships to expand. Valid values: parentNotebook.
selectstring[]
Comma-separated list of properties to select. Valid values: id, displayName, createdDateTime, lastModifiedDateTime, sectionsUrl, sectionGroupsUrl, self, createdBy, lastModifiedBy.
user_idstringObligatorio
The unique identifier of the Microsoft Graph user. Use 'me' for the current authenticated user.
section_idstringObligatorio
The unique identifier of the OneNote section within the notebook.
notebook_idstringObligatorio
The unique identifier of the OneNote notebook.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List notebook section groupsONENOTE_LIST_GROUP_NOTEBOOK_SECTION_GROUPSAcción

Retrieves a list of section groups from the specified notebook within a Microsoft 365 group. Use this action when you need to list all section groups in a group-owned OneNote notebook to understand its structure or to find a specific section group.

Parámetros de entrada

topinteger
The number of items to return in the collection. Default is 25, maximum is 100.
expandstring[]
Comma-separated list of navigation properties to expand (e.g., sections, sectionGroups, parentNotebook, parentSectionGroup).
filterstring
OData filter expression to filter the results.
selectstring[]
Comma-separated list of section group properties to include in the response.
orderbystring[]
Comma-separated list of properties to order results by. Default order is name ascending.
group_idstringObligatorio
The unique identifier of the Microsoft 365 group.
notebook_idstringObligatorio
The unique identifier of the OneNote notebook within the group.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List pages from a group notebook sectionONENOTE_LIST_GROUP_NOTEBOOK_SECTION_PAGESAcción

Lists all OneNote pages from a specific section within a notebook in a Microsoft 365 group. Use this action when you need to retrieve all pages from a known section in a group notebook. This action accesses pages directly through the section path without going through section groups.

Parámetros de entrada

filterstring
OData filter expression to apply to filter results.
selectstring[]
Comma-separated list of page properties to include in the response. Valid properties include: id, self, title, createdDateTime, lastModifiedDateTime, contentUrl, createdByAppId, level, order, links.
orderbystring[]
Comma-separated list of properties to order results by. Default order is lastModifiedDateTime descending.
group_idstringObligatorio
The unique identifier of the Microsoft 365 group.
page_sizeinteger
The number of pages to return per request. Default is 20, maximum is 100.
section_idstringObligatorio
The unique identifier of the section within the notebook.
notebook_idstringObligatorio
The unique identifier of the OneNote notebook within the group.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List section group sectionsONENOTE_LIST_GROUP_SECTION_GROUPS_SECTIONSAcción

Lists all OneNote sections from a specific section group within a Microsoft 365 group's OneNote. Use this action when you need to retrieve the sections contained within a section group in a group-owned OneNote notebook. Supports pagination and filtering via OData query parameters. This is a read-only operation that retrieves existing sections without modifying any data.

Parámetros de entrada

topinteger
The number of sections to return per request. Defaults to 25.
expandstring[]
Comma-separated list of relationships to expand. Valid values: parentNotebook, parentSectionGroup.
filterstring
OData filter expression to apply to filter results. Example: displayName eq 'My Section'.
selectstring[]
Comma-separated list of section properties to include in the response. Valid values: id, displayName, createdDateTime, lastModifiedDateTime, isDefault, pagesUrl, self, createdBy, lastModifiedBy.
orderbystring[]
Comma-separated list of properties to order results by. Example: displayName asc.
group_idstringObligatorio
The unique identifier of the Microsoft 365 group.
section_group_idstringObligatorio
The unique identifier of the section group within the group's OneNote.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List pages in sectionONENOTE_LIST_ME_ONENOTE_SECTIONS_PAGES4Acción

Retrieves a list of OneNote pages from a specific section for the current user. Use this action when you need to retrieve all pages from a specific section in the current user's OneNote notebook. This action supports pagination, filtering, sorting, and relationship expansion via OData query parameters. The default query returns the top 20 pages ordered by lastModifiedTime descending. Note: This action is read-only and does not modify any data.

Parámetros de entrada

expandstring[]
List of relationships to expand. Use 'parentSection' or 'parentNotebook' to include parent details.
filterstring
OData filter expression to apply to filter results.
selectstring[]
List of page properties to include in the response. Common values: 'id', 'title', 'createdDateTime', 'lastModifiedDateTime', 'contentUrl'.
orderbystring[]
List of properties to order results by. Common values: 'createdDateTime', 'lastModifiedDateTime', 'title'.
page_sizeinteger
The number of pages to return per request. Defaults to 25. Maximum is 100.
section_idstringObligatorio
The unique identifier of the OneNote section.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List group OneNote pagesONENOTE_LIST_ONENOTE_GROUP_PAGESAcción

Lists all OneNote pages from a Microsoft 365 group. Use this action when you need to retrieve all OneNote pages within a Microsoft 365 group. Supports pagination via the page_size parameter. The default page size is 25, and the maximum is 100. Results are ordered by lastModifiedDateTime descending by default.

Parámetros de entrada

filterstring
OData filter expression to apply to filter results.
selectstring[]
List of page properties to include in the response. Common values: 'id', 'title', 'createdDateTime', 'lastModifiedDateTime'.
orderbystring[]
List of properties to order results by. Common values: 'createdDateTime', 'lastModifiedDateTime', 'title'.
group_idstringObligatorio
The unique identifier of the Microsoft 365 group.
page_sizeinteger
The number of pages to return per request. Defaults to 25. Maximum is 100.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List group section group section groupsONENOTE_LIST_ONENOTE_GROUP_SECTION_GROUPS_SECTION_GROUPS2Acción

Lists all section groups from a specified parent section group within a Microsoft 365 group's OneNote notebook. Use this action when you need to retrieve the nested section groups within a section group in a group context to navigate the OneNote notebook hierarchy. This action supports OData query parameters for filtering, sorting, pagination, and expanding related entities.

Parámetros de entrada

topinteger
The number of items to return in the collection. Default is 25.
expandstring[]
Comma-separated list of relationships to expand. Valid values: sections, sectionGroups, parentNotebook, parentSectionGroup.
filterstring
OData filter expression to apply. Example: displayName eq 'My Section Group'.
selectstring[]
Comma-separated list of properties to select. Valid values: id, displayName, createdDateTime, lastModifiedDateTime, sectionsUrl, sectionGroupsUrl, self.
orderbystring[]
Comma-separated list of properties to order results by. Example: displayName asc.
group_idstringObligatorio
The unique identifier of the Microsoft 365 group.
section_group_idstringObligatorio
The unique identifier of the parent section group.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List pages from a group sectionONENOTE_LIST_ONENOTE_GROUP_SECTIONS_PAGES4Acción

Lists all OneNote pages from a specific section in a Microsoft 365 group. Use this action when you need to retrieve all pages from a known section in a group notebook without specifying the notebook ID. This action supports pagination, filtering, sorting, and relationship expansion via OData query parameters. Note: This action is read-only and does not modify any data.

Parámetros de entrada

expandstring[]
List of relationships to expand. Use 'parentSection' or 'parentNotebook' to include parent details.
filterstring
OData filter expression to apply to filter results.
selectstring[]
List of page properties to include in the response. Common values: 'id', 'title', 'createdDateTime', 'lastModifiedDateTime', 'contentUrl', 'createdByAppId', 'level', 'order', 'links'.
orderbystring[]
List of properties to order results by. Common values: 'createdDateTime', 'lastModifiedDateTime', 'title'.
group_idstringObligatorio
The unique identifier of the Microsoft 365 group.
page_sizeinteger
The number of pages to return per request. Defaults to 25. Maximum is 100.
section_idstringObligatorio
The unique identifier of the OneNote section.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List site notebook section groupsONENOTE_LIST_SITE_NOTEBOOK_SECTION_GROUPSAcción

Retrieves a list of section groups from the specified notebook within a SharePoint site. Use this action when you need to list all section groups in a SharePoint site-owned OneNote notebook to understand its structure or to find a specific section group. The default sort order is name ascending. The default query expands parentNotebook and selects its id, displayName, and self properties.

Parámetros de entrada

topinteger
The number of items to return in the collection. Default is 25, maximum is 100.
expandstring[]
Comma-separated list of navigation properties to expand. Valid values: sections, sectionGroups, parentNotebook, parentSectionGroup.
filterstring
OData filter expression to filter the results. Example: displayName eq 'My Section Group'.
selectstring[]
Comma-separated list of section group properties to include in the response. Valid values: id, displayName, createdDateTime, lastModifiedDateTime, sectionsUrl, sectionGroupsUrl, self, createdBy, lastModifiedBy.
orderbystring[]
Comma-separated list of properties to order results by. Default order is name ascending. Example: displayName asc.
site_idstringObligatorio
The unique identifier of the SharePoint site.
notebook_idstringObligatorio
The unique identifier of the OneNote notebook.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get OneNote page content from SharePoint siteONENOTE_LIST_SITE_PAGES_CONTENTAcción

Retrieves the HTML content of a specific OneNote page within a SharePoint site. Use this action when you need to fetch the full HTML content of a OneNote page from a SharePoint site for processing, rendering, or exporting page data. This endpoint provides direct access to page content without requiring notebook or section context. Returns the raw HTML content of the page, including text, images, and other embedded content references. Note: This action is read-only and does not modify any data.

Parámetros de entrada

page_idstringObligatorio
The unique identifier of the OneNote page. Format is typically 'pageId!sectionId' (e.g., '1-c82b4070fd284fd89902a39ce5937394!71-7aef1f00-3deb-4ee2-93ab-979eb24a3037').
site_idstringObligatorio
The unique identifier of the SharePoint site. Can be the site hostname and relative path (e.g., 'contoso.sharepoint.com,123abc,456def') or a server-relative path.
include_idsboolean
Optional. When set to true, the returned HTML includes IDs for page elements. Useful when you need to identify elements for updates or modifications.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List site sectionsONENOTE_LIST_SITE_SECTIONSAcción

Retrieves a list of OneNote sections from a SharePoint site. Use this action when you need to list all OneNote sections within a SharePoint site's OneNote notebook to understand its structure or to find a specific section. This is a read-only operation that retrieves existing sections without modifying any data. Supports OData query parameters for filtering, sorting, pagination, and property expansion. The default sort order is name ascending. The default query expands parentNotebook and selects its id, displayName, and self properties.

Parámetros de entrada

topinteger
The number of sections to return per request. Default is 25, maximum is 100.
expandstring[]
Comma-separated list of navigation properties to expand. Valid values: parentNotebook, parentSectionGroup.
filterstring
OData filter expression to apply to filter results. Example: displayName eq 'My Section'.
selectstring[]
Comma-separated list of section properties to include in the response. Common values: id, displayName, createdDateTime, lastModifiedDateTime, isDefault, pagesUrl.
orderbystring[]
Comma-separated list of properties to order results by. The default sort order is name ascending. Example: displayName asc.
site_idstringObligatorio
The unique identifier of the SharePoint site. Can be 'root' for the root site, or a site path in the format 'hostname,site-id,web-id'.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List user notebooksONENOTE_LIST_USER_NOTEBOOKSAcción

Lists all OneNote notebooks accessible by a specific user. Use this action when you need to retrieve the available notebooks for a user, display notebook listings, or browse notebooks that are owned by or shared with a specific user. Supports OData query parameters for filtering, sorting, and pagination. Note: The user_id can be a GUID or a user principal name (UPN). Use 'me' to reference the signed-in user.

Parámetros de entrada

filterstring
OData filter expression to apply to filter results.
selectstring[]
Comma-separated list of notebook properties to include in the response (OData $select).
orderbystring[]
Comma-separated list of properties to order results by (OData $orderby). Default order is 'displayName asc'.
user_idstringObligatorio
The unique identifier (GUID) or user principal name (UPN) of the user whose notebooks to retrieve. Use 'me' to reference the signed-in user.
page_sizeinteger
The number of notebooks to return per request. Default is 25. Maximum is 100.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List user notebook sectionsONENOTE_LIST_USER_NOTEBOOK_SECTIONSAcción

Lists all OneNote sections from a specified notebook belonging to a user. Use this action when you need to retrieve all sections within a notebook that is owned by or accessible to a specific user. Supports OData query parameters for filtering, sorting, and pagination. Note: The user_id can be a GUID or user principal name (UPN). Use 'me' to reference the signed-in user. The default sort order is by display name ascending. This is a read-only operation.

Parámetros de entrada

topinteger
The number of sections to return per request. Defaults to 25. Maximum is 100.
expandstring[]
Comma-separated list of relationships to expand. Valid values: parentNotebook, parentSectionGroup.
filterstring
OData filter expression to apply to filter results.
selectstring[]
Comma-separated list of section properties to include in the response. Valid values include: id, self, displayName, createdDateTime, lastModifiedDateTime, isDefault, pagesUrl, links, createdBy, lastModifiedBy.
orderbystring[]
Comma-separated list of properties to order results by. Default order is 'displayName asc'.
user_idstringObligatorio
The unique identifier (GUID) or user principal name (UPN) of the user. Use 'me' to reference the signed-in user.
notebook_idstringObligatorio
The unique identifier of the OneNote notebook.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update my OneNote page contentONENOTE_UPDATE_ME_PAGE_CONTENTAcción

Update the content of a OneNote page for the signed-in user. Sends a PATCH request with patch content commands to modify the HTML structure of a OneNote page. Supports appending children, inserting siblings, replacing elements, prepending content, and deleting elements. Use this action when you need to update or modify the content of an existing OneNote page owned by the signed-in user, such as adding new paragraphs, inserting images, modifying lists, or replacing/removing existing elements. This action is idempotent for replace, append, prepend, and insert operations, but delete operations are irreversible — deleted elements cannot be recovered once removed.

Parámetros de entrada

page_idstringObligatorio
The unique identifier of the OneNote page to update.
commandsobject[]Obligatorio
Array of patch commands to apply to the page. Each command specifies a target element, action, and optional content and position.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update my OneNote sectionONENOTE_UPDATE_ME_SECTIONSAcción

Updates the navigation property sections in me. Use when you need to modify properties of an existing OneNote section, such as renaming it, within the current user's notebooks. This action uses a PATCH request to update the section entity at the specified path. Use this action when you need to update a specific OneNote section owned by the authenticated user, such as changing its display name. This is an idempotent operation that modifies the specified properties while preserving all other existing values. Note: Only the displayName property can be updated via this endpoint. Other properties like isDefault, createdDateTime, etc. are read-only.

Parámetros de entrada

section_idstringObligatorio
The unique identifier of the OneNote section to update.
display_namestring
The new name for the section. Must be 50 characters or fewer and cannot contain: ?*/:<>|&#''%~. If not provided, the current name is preserved.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update OneNote page contentONENOTE_UPDATE_ONENOTE_PAGE_CONTENTAcción

Update the content of a OneNote page within a Microsoft 365 group using HTML patch commands. Use this action when you need to modify the content of an existing OneNote page, such as replacing text, inserting new content, or appending elements. The action supports multiple patch commands in a single request. The API returns 204 No Content on success, meaning no JSON response body is returned.

Parámetros de entrada

page_idstringObligatorio
The unique identifier of the OneNote page to update.
commandsobject[]Obligatorio
Array of patch commands to apply to the page. Each command specifies a target element, action, and content.
group_idstringObligatorio
The unique identifier of the Microsoft 365 group that owns the notebook.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update section in site notebookONENOTE_UPDATE_SITE_NOTEBOOKS_SECTIONSAcción

Updates a OneNote section within a notebook in a SharePoint site. Use this action when you need to modify properties of an existing section, such as renaming it. This action uses a PATCH request to update the section entity at the specified path within the site's notebook hierarchy. Note: Only the displayName property of a section can be updated via this endpoint. Other properties like createdDateTime, isDefault, etc. are read-only.

Parámetros de entrada

site_idstringObligatorio
The unique identifier of the Microsoft Graph user who owns the section. Use 'me' for the signed-in user.
section_idstringObligatorio
The unique identifier of the section to update within the notebook.
notebook_idstring
The unique identifier of the OneNote notebook containing the section. Optional - kept for backwards compatibility.
display_namestring
The new name to assign to the section. Must be 50 characters or fewer and cannot contain: ? * / : < > | & # ' % ~. If not provided, the current name is preserved.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update site OneNote page contentONENOTE_UPDATE_SITE_PAGES_CONTENTAcción

Update the content of a OneNote page within a SharePoint site. Sends a PATCH request with patch content commands to modify the HTML structure of a OneNote page. Supports appending children, inserting siblings, replacing elements, prepending content, and deleting elements. Use this action when you need to update or modify the content of an existing OneNote page within a SharePoint site, such as adding new paragraphs, inserting images, modifying lists, or replacing/removing existing elements. This action is idempotent for replace, append, prepend, and insert operations, but delete operations are irreversible — deleted elements cannot be recovered once removed.

Parámetros de entrada

page_idstringObligatorio
The unique identifier of the OneNote page to update.
site_idstringObligatorio
The unique identifier of the SharePoint site that owns the notebook.
commandsobject[]Obligatorio
Array of patch commands to apply to the page. Each command specifies a target element, action, and optional content and position.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update site section group sectionONENOTE_UPDATE_SITE_SECTION_GROUPS_SECTIONSAcción

Updates a OneNote section within a section group in a SharePoint site notebook. Use this action when you need to modify properties of an existing OneNote section, such as updating its display name. This action uses a PATCH request to update the section entity at the specified path within the SharePoint site's notebook hierarchy. Note: Only the displayName property can be updated via this endpoint. Other properties are read-only.

Parámetros de entrada

site_idstringObligatorio
The unique identifier of the SharePoint site. Can be the server-relative path (e.g., 'sites/contoso') or a SharePoint site ID in the format 'hostname,tenant-id,site-id'.
section_idstringObligatorio
The unique identifier of the OneNote section to update.
notebook_idstringObligatorio
The unique identifier of the OneNote notebook within the SharePoint site.
display_namestring
The new name for the section. Must be 50 characters or fewer and cannot contain: ?*/:<>|&#''%~
section_group_idstringObligatorio
The unique identifier of the section group within the notebook.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update section in user notebookONENOTE_UPDATE_USER_NOTEBOOKS_SECTIONSAcción

Updates a OneNote section within a user's notebook. Use this action when you need to modify properties of an existing OneNote section, such as renaming it, for a specific user identified by their Microsoft Graph user ID. This action uses a PATCH request to update the section entity at the specified path within the user's notebook hierarchy. Note: Only the displayName property can be updated via this endpoint. Other properties like isDefault, createdDateTime, etc. are read-only.

Parámetros de entrada

user_idstringObligatorio
The unique identifier of the Microsoft Graph user who owns the notebook.
section_idstringObligatorio
The unique identifier of the OneNote section to update.
display_namestring
The new name for the section. Must be 50 characters or fewer and cannot contain: ? * / : < > | & # ' % ~. If not provided, the current name is preserved.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not