Can an agent create a page with Notion API?
A
Who does each step
Whether the agent handles it alone or a person has to step in.
- 01
Discover
MachineThe vendor's machine-readable docs show the agent where and how to call this job.
- 02
Access
Approval · setupYou consent once to the agent's own client.
- 03
Onboard
MachineThe agent can register itself with no person.
- 04
Pay
Not applicableNothing to pay for the job.
- 05
Confirm
MachineThe response or specification defines errors the agent can distinguish from success.
- 06
Sustain
MachineThe agent can renew and revoke its own access.
- A person steps in
- You, once, at Access: consenting to the agent's access.
Agent surfaces
3 kinds · 6 entries
The probe
12 Oct 2026 · 00:13 UTC · 79.12 s
Each request it sent and what came back; the descriptors it read, counted, with what they named.
Discover69 descriptor reads9 facts
- Found
- For agentswww.notion.com/llms.txtOtherwww.notion.so/llms.txtOAuthmcp.notion.com/mcpOAuthmcp.notion.comOAuthmcp.notion.comOAuthmcp.notion.comOAuthmcp.notion.comFor agentsdevelopers.notion.com/llms.txtFor agentsapi.notion.com
- From
- www.notion.com/llms.txt · www.notion.so/llms.txt · mcp.notion.com/.well-known/oauth-protected-resource/mcp · mcp.notion.com/.well-known/oauth-authorization-server · mcp.notion.com/.well-known/oauth-protected-resource · developers.notion.com/llms.txt · developers.notion.com/guides/get-started/quick-start
- This endpoint
- mcp.notion.com/mcp is named by a descriptor it read
Job requestPOST api.notion.com/v1/pages401101 ms
- Request
- POST https://api.notion.com/v1/pages
- Response
- 401 · application/json · 178 bytes
- Body
- sha256:126ee7ab0d46e32670a48ddb6e4bc0663caa3fab1cd904c5d73e103801bbe81d
- Exchange
- sha256:4f635c46233bf178513151dc2d48acb919588819b219071c5c11a8934de06129
Resource metadataGET api.notion.com/.well-known/oauth-protected-resource/v1/pages400111 ms
- Request
- GET https://api.notion.com/.well-known/oauth-protected-resource/v1/pages
- Response
- 400 · application/json · 145 bytes
- Body
- sha256:2c73291614b7e652a79b96146e041678979d14e654026b46d4bcb211b4bdb8e2
- Exchange
- sha256:4798c170eb683a098d65e36ad99da323e7d1f28ac8cd491d5c1048380683d897
Resource metadataGET api.notion.com/.well-known/oauth-protected-resource400290 ms
- Request
- GET https://api.notion.com/.well-known/oauth-protected-resource
- Response
- 400 · application/json · 145 bytes
- Body
- sha256:72040dba0fe7d6dfd0d72b1a2bf53261e69b423890c7172f6681b4cc24481288
- Exchange
- sha256:f8ee62e399b289bfb4cbeec380d3c3192d130420d80f24e8c7908540e3cb2164
Job requestsession openedPOST mcp.notion.com/mcp40136 ms
- Request
- POST https://mcp.notion.com/mcp
- Response
- 401 · application/octet-stream · 0 bytes
- Body
- sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
- Exchange
- sha256:4d3d7fe70c91b19b85a0c8d67cf18905b7354be3fe5c4c572c244df4986a2b44
Resource metadataGET mcp.notion.com/.well-known/oauth-protected-resource/mcp20076 ms
- Request
- GET https://mcp.notion.com/.well-known/oauth-protected-resource/mcp
- Response
- 200 · application/json · 197 bytes
- Body
- sha256:e5999dd6b0431676a0f4a9fc688ee8da7526cb9a26d3c2dbe20f6803ca7500d2
- Exchange
- sha256:eecd7809cf7cf8032cbcd10ddd32bd9e1e0cfe4c9662711cfb3129d0680d5229
Authorization serverGET mcp.notion.com/.well-known/oauth-authorization-server20046 ms
- Request
- GET https://mcp.notion.com/.well-known/oauth-authorization-server
- Response
- 200 · application/json · 1058 bytes
- Body
- sha256:8bf75c712a9db5b0dc243becd84bcfb5e489dbf954c76dcca9919136708d8d9e
- Exchange
- sha256:02cc9f54bc09537d6cbf6c05b328e4adb2db7e4ef4ce2ad065cc2444436a48a5
AuthorizationGET mcp.notion.com/authorize?response_type=code&client_id=https%3A%2F%2Fapi.sourcey.com%2F.well-known%2Fagent-readiness%2Fclient.json&redirect_uri=https%3A%2F%2Fapi.sourcey.com%2F.well-known%2Fagent-readiness%2Fcallback&state=b9e398719c703528f4f1d22fe1db4a87&code_challenge=dPUxozMsNSzCeM64TwGGiu6pBiHz3ZxEFRnGsjqKIIg&code_challenge_method=S256&resource=https%3A%2F%2Fmcp.notion.com%2Fmcp&scope=default302154 ms
- Request
- GET https://mcp.notion.com/authorize?response_type=code&client_id=https%3A%2F%2Fapi.sourcey.com%2F.well-known%2Fagent-readiness%2Fclient.json&redirect_uri=https%3A%2F%2Fapi.sourcey.com%2F.well-known%2Fagent-readiness%2Fcallback&state=b9e398719c703528f4f1d22fe1db4a87&code_challenge=dPUxozMsNSzCeM64TwGGiu6pBiHz3ZxEFRnGsjqKIIg&code_challenge_method=S256&resource=https%3A%2F%2Fmcp.notion.com%2Fmcp&scope=default
- Response
- 302 · application/octet-stream · 0 bytes
- Body
- sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
- Exchange
- sha256:4019f4174d5e7abb5b3991b9b2525066ccbb73e915201f2683c634f26a383de3
Declared pageGET app.notion.com/signup20058 ms
- Request
- GET https://app.notion.com/signup
- Response
- 200 · text/html · 20056 bytes
- Body
- sha256:6d32bf72b08f814eb15f56b8b5157bbcafaa8c7a88e00fb9271c79743db1f0d3
- Exchange
- sha256:fa8a8211c02a994bbe2032acbdbf58f7fe236d5b4cafd0a9dcf25372e5836d50
Notion on the startup-offers board
- Notion Business plan with Notion AI, up to 6 months freeUp to 6 months of Notion Business free with Notion AI
The grade’s badge
One image that keeps itself current, linking here.
[](https://sourcey.com/c/notion/agent-readiness/notion-api/workspace-page-create)Improve the report
Report a step or result that no longer matches the service, request a fresh assessment, or verify the job with your own account.
Record details
- Profile
- arp_01m4pm6wey6beawb934xmjez8n
- Projection
- sha256:3d4613c0dee2713646f7ac12f3f01546dee5964d04082b366a6b9ceb65a171ca
- Policy
- kind-2026-10-12 · sha256:0a4e4996176ce674b4f3ce910c5fca4f37c9b53bcdf51656d53a1a92fcf2c879