API

I am trying to test the Box API endpoint /2.0/notes/convert in Postman, which is used to convert Markdown content into a native .boxnote file in a target Box folder.However, I am not receiving the expected output when making the API request. I would like assistance in understanding the correct request format, required parameters, headers, and any specific requirements for successfully creating a .boxnote file from Markdown content.API Endpoint:https://api.box.com/2.0/notes/convertEnvironment: PostmanExpected Result:The Markdown content should be converted into a native Box Note (.boxnote) and created in the specified target folder.Actual Result:The API request giving the below error (Screenshot attached)Please provide guidance on the correct API request and any required configuration or permissions needed for this operation.Are this APIs only available for higher tier subscriptions? If yes the description in the “Plan comparison” is misleading because it does not state which APIs are a

Hello, I created an App to help generate an API Key for use in some automation I need to complete. It has been in “Pending Enablement” for a while and I want to ask for support to get this approved. Can someone please help with getting this approved?

Is there an integration with Hazel/Altruist in the works?

when I try to click "fetch secret" button within an app, it shows an info message: "this action requires 2-step verification. please wait while you are redirected."    And after that an empty page shows up.  The thing is the 2-step verification is already set up in my account.  Could you please help with this? What am I missing? 

Hi,I have a service account that was invited into a few client’s folders. It was probably renamed and it is under developers console → Platform Apps → Name of app now. I got everything here as Authorized and enabled since Jan 2023. Client changed security and enforces 2FA now, which I do have for my account. If I go to to the Content Manager, I see nothing here. All folders I had access to are gone. From the folder’s perspective I see the automation user as Pending I’m also Co-owner in another folder and I have rights to resend the invitationit says it does sent the email but that email is automatically generated so I assumed it comes to me or ideally all owners of the app as listed here but nope, I didn’t receive anything nor other Admins. How am I supposed to accept the invitation to virtual email that doesn’t exist? My use case is that I want to upload files or create sub-folders in a given folder from our integration application. It is our client’s Box probably as Enterprise and th

I have the exact problem that is discussed here - Transfer owned folders | CommunityThe account that is using OAUTH has all Co-Admin management for user and file access based on what is seen in the Manage Users. And the application appears to have the needed rights. However, when attempting to move the content to an Admin account (which we do within the web portal) a 403 forbidden is received. The process seems to allow the transfer to the OAuth user so member to Co-Admin which doesn’t correlate with the error that is received.  I have not tried transferring ownership of the folder to the admin account that we are using for all the other folder storage but really feel like that is not going to work.  I really wish there was an easier way to do this but if anyone has done this and can validate that it will work, I would appreciate the response.

Hi there, we submitted our app mid July for review and haven't heard back from you. We haven’t heard back from the team after 10 days and reached out to [removed by moderator] but also don’t get a response. Do you have a rough ETA on the review? The app can be previewed here: https://app.box.com/integrations/NepcCkAiWm/i Best,Erhard.

I am unable to view option to submit my app for authorization. I am not sure why, please help. I have none of the tabs or options where I am able to submit the app for request.

Subject: Custom App (Client Credentials Grant) blocked from downloading file content despite correct scopes, collaboration, and verified impersonationEnterprise ID: 290084Enterprise name: Simplexity ServicesApp name: WebDataApp ID: 2633167Client ID: 81jcl8rh4t3pc2b22z05n5rcumo5x4lkAuthentication type: Client Credentials Grant (Server Authentication)Service Account: [removed by moderator] (user id [removed by moderator] )SUMMARYMy Custom App's service account can successfully authenticate, list foldercontents, and read file metadata, but every attempt to download actual filecontent via GET /2.0/files/{id}/content returns: HTTP 403 {"type":"error","status":403,"code":"access_denied_insufficient_permissions", "message":"Access denied - insufficient permission"}This happens even when the request impersonates a full co-owner of theenterprise via the As-User header, so it does not appear to be apermissions/ownership/collaboration issue on any specific file or folder.I believe this is an ente

Hi Box Developer Team,We are developing a Node.js-based Box connector and are facing an issue while working with HTML files.We have uploaded an HTML file (for example, myhtml.html) to our Box account. However, we are unable to retrieve its metadata or upload a new version of the file using the Box API. What we have triedRetrieved the File ID from the Box web interface. Generated a valid OAuth 2.0 access token. Called the Get File Metadata endpoint using the official Box API. Tested the same request using the official Box API Swagger / API Explorer. Verified that the File ID and Access Token belong to the same Box account.   Issue The API consistently returns: HTTP 404 Not Found As a result, we are unable to: Retrieve the metadata of the HTML file. Upload a new version of the HTML file. Continue implementing our Box connector.QuestionsDoes Box support HTML (.html) files as regular files for metadata retrieval and version upload? Are there any limitations or special requirements for HTM

Hello. I’m hoping someone can help with this…I am trying to set up an app, to support the migration of some files from Box to a different storage system.I’ve set up the app on the developer console and it is showing as ‘Pending authorisation’, waiting for our admin to approve.But I am the admin and I’ve not received any emails or contact about it.Any advice on how I can get authorised?Thank you!

Our automation has been successfully uploading files to the folder shared by client for several years.Recently, the integration lost access to the folder.When authenticating as the App User, the following request returns Not Found:GET /2.0/folders/ [removed by moderator] When authenticated as my Box user account (using developer token), I can access the folder without issueThe folder still contains a collaboration for the App User:{ "accessible_by": { "login": " [removed by moderator] " }, "status": "pending", "created_at": "2023-06-26T06:50:34-07:00", "modified_at": "2026-06-25T11:56:27-07:00"}Notably:The collaboration has been in pending status since 2023. The integration worked while the collaboration was pending. Recreating the collaboration did not resolve the issue. Creating new application and sharing the folder did not resolve the issue. Not able to accept this collaboration thru API call: PUT /2.0/collaborations/{collaboration_id}23{4"status": "accepted"5}Returns:needs_two_fac

I want to create a python script that grabs data from SQL Server, creates a csv, and drops it into my box.com folder automatically. I can do this with a developer token, but that expires after 60 minutes.The issue is that I have a enterprise_id of 0. Company A uses box.com and they are getting data from a bunch of Companies like mine. So they instructed me (Company B) to create a free personal account and they shared a folder with me that I can dump my data into.I have to drop data in weekly, and setting up an automated process would be best. I created a developer account and got a developer token and was successful in a test. But I need a token that lasts longer, and I am reading that JWT does not work with enterprise_ids of 0. OAuth doesn’t really apply to my situation.Is there anything I can do to automate this process? 

Will keep it short and sweet. I am looking to build a folder structure traversal UX that includes search/sort/filtering capabilities. e.g.Find me files with metadata attribute == X in folder YIt doesn’t seem like this is possible today. There are three APIs in questionGet Folder ItemsSearchMetadata Query Search and Metadata Query do not have the ability to only search within a single folder. Get Folder Items is limited in it’s filtering capabilities. It seems like an attribute I would expect in the metadata query filter options. ancestor_folder_id does not look at just a single folder, it looks at all folders below, which means we cannot recreate the folder structure navigation experience without serious server interception (prohibitively expensive). Has anyone solved this? Is this a known issue in the API offering? 

We created a Box Platform App using JWT server authentication. The app is configured as App Access Only, not App + Enterprise Access, and the authorized scope currently shown is “Read all files and folders stored in Box.”The JWT token authenticates as the app’s Service Account / Automation User. In our case, the token identifies as:Name of automation serviceE-mail of automation serviceWhat is confusing is that we have not intentionally collaborated that Service Account onto the target folder or any parent folder. The folder and test Excel files were created by my sandbox admin user, not by the Service Account. Despite that, when we call the Box API with the JWT Service Account token and provide the folder ID, the app can list the folder contents and read file/folder metadata.For example, it can see the folder and files and read metadata such as owner, creator, file name, file ID, permissions, etag, etc. The metadata shows the folder/file is owned and created by my sandbox user, not the

Hi everyone,I have used Box Microsoft Sentinel Codeless Connector (CCP) connector which uses the REST API Poller to ingest Box Enterprise Events.The connector authenticates using the Client Credentials Grant against the Box OAuth endpoint.OAuth EndpointPOST https://api.box.com/oauth2/tokenGrant Typeclient_credentialsAdditional Parametersbox_subject_type=enterprisebox_subject_id=<Enterprise ID>The connector configuration is similar to:"auth": { "type": "OAuth2", "grantType": "client_credentials", "TokenEndpoint": "https://api.box.com/oauth2/token"}However, the connector consistently fails.Microsoft Sentinel reports the following error:RES40001Invalid Credential or cannot get credential for example OAuth2 access token.Call failed with status code 429 (Too Many Requests):POST https://api.box.com/oauth2/tokenNote that the credentials used are valid, Microsoft Sentinel Data Connector shows the following:  

I just created a webhook v1 and it says that I need to contact support in order to enable it, but it seems I need to have an Enterprise account in order to contact support in order to enable my webhook v1 for other users?

I’m trying to download a file that I created via the API, but keep getting an SSL error. Note that I can download the same file successfully using the API Developer playground, providing just the file ID and my developer token. See curl output below:$ curl -i -L "https://api.box.com/2.0/files/ [removed by moderator] /content" -H "authorization: Bearer <REDACTED_TOKEN>"HTTP/2 302 date: Wed, 11 Mar 2026 12:55:49 GMTx-envoy-upstream-service-time: 259location: <REDACTED_LINK>box-request-id: 07a3f1d1a260e4d0957df37044c38d148cache-control: no-cache, no-storestrict-transport-security: max-age=31536000via: 1.1 googlecontent-length: 0alt-svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000curl: (35) error:0A000126:SSL routines::unexpected eof while reading

現在ServiceNowとAPI連携を行い、ServiceNow側からAPIを叩いてBOX内にフォルダを作成する仕組みを作成しています。要件の一部に、フォルダに対して２２日後に自動削除されるよう設定するという要件があるのですが、調べてみたところ、BOX APIにフォルダ削除日の設定は存在しないという結論に至りました。ただ、私自身BOXの利用経験が浅く情報が最新かどうか判断しかねている次第です。また、存在しない場合どのような代替方法があるかなど、過去に実装経験がある方や知見がございましたらご教示いただきたいです。 よろしくお願いいたします。

I am getting {"type":"error","status":404,"code":"not_found","help_url":"http://developers.box.com/docs/#errors","message":"Authorization Failed","request_id":"redacted"} when I call https://api.box.com/2.0/tasks/{task_id} though I have no issue listing all tasks using the same token with https://api.box.com/2.0/files/{file_id}/tasks

Hi All,Got a client that wants their files on box (previously sftp) and I've gotten the Box CLI to upload files to a folder and will be looking to schedule it on a weekly basis for the client.  I'm targeting the folder purely by folder ID using "box files:upload <filename> --parent-id <folder id>” in PowerShell (I know, gross!).The client has their box url branded but not sure how to handle it in the future if we have more clients wanting to use Box.  If the clients I need to post to each have their own branded Box URLs (e.g. cmpa.app.box.com/folder/111111, compb.app.box.com/folder/22222 etc).My question is: are folder IDs globally unique across all Box tenants (cmpa, cmpb, cmpc)? In other words, if I upload to folder ID 111111, is it guaranteed to land in that exact folder for client A regardless of whether I previously posted to Client B's 22222 folder with the same box account and token (via CLI)?Are the branded URLs purely cosmetic, with only the folder ID being conside

Calling all developers! The Box Developer Platform is evolving rapidly to support the next generation of custom integrations and AI-powered applications.In our latest product roadmap session, we deep-dived into emerging headless interfaces, including connecting AI agents (like ChatGPT and Claude) to your Box instance via the Box MCP Server.We also discussed simplifying the developer experience with the upcoming npm install box command, providing AI unit entitlements for free developer accounts, and making the Box AI agent accessible via Slack and MCP. 📌 Read the full developer breakout summary and watch the session here!  

I created a box developer account to investigate how to integrate our customer's Box repository with our tool. Everything went create with Oauth and the developer token, but when I started experimenting with Client Credentials Grant, I simply can't get it to work.When I try to make a request with the client id, client secret and my own user ID, I get:"App is not yet authorized for use"In my console I can see messages like:"Log in or sign up for a Box Developer account to access all of the Developer Console features."Which is something that also pops up at the top of my Developer Console page. Not sure how I can create a Box Developer account since, as far as I can tell, I already have one.

Would the custom agent’s activity be tracked with “BOX_AI_USER_REQUEST”, the same event type as the Box AI chat? Or is it different for custom agents?

Hi Team,I created an Oauth application in box developer console, it is showing status as pending enablement. How can I get it enabled. I need this application as part of automating our workflow. please suggest