Use DocuSign Rooms API when your workflow involves real estate transactions — Rooms is a deal-room product specific to real estate closings, with forms libraries (MISMO, state-specific), task management, and multi-party transaction coordination.
Use the DocuSign eSignature API (the standard product) for general-purpose document signing workflows across any industry — contracts, HR onboarding, NDAs, sales agreements, and any non-real-estate use case.
Authenticate to both APIs using the same DocuSign OAuth 2.0 infrastructure at account.docusign.com; however, the Rooms API requires separate JWT or OAuth scopes that include 'dtr.rooms.read' and 'dtr.rooms.write'.
The Rooms API base URL follows https://www.docusign.net/restapi/rooms/v2 (production) — note it is a different path than the eSignature API base URL; sandbox uses demo.docusign.net.
For hybrid workflows (create a room AND send a document for signature), you can link a Rooms transaction to an eSignature envelope — use the Rooms API to create the room and the eSignature API to create the envelope, then associate them via the Rooms document endpoint.
Check that your DocuSign plan includes the Rooms product — it is not included in all DocuSign tiers and requires a separate entitlement; calling Rooms endpoints with a non-entitled account returns authorization errors.
Known gotchas
DocuSign Rooms is only available in certain countries and states where DocuSign has established real estate forms partnerships; attempting to use region-locked forms in unsupported jurisdictions returns permission errors — verify your target markets against DocuSign's forms availability matrix.
The JWT authentication grant for Rooms requires the user to grant consent the first time; automated service accounts must complete the consent flow once before JWT grants can be used non-interactively — skipping this step causes token exchange failures.
Rooms API pagination uses a 'startPosition' and 'count' pattern, not cursor-based; for large transaction volumes, page sizes are capped and total counts can be expensive to compute — plan pagination logic upfront for reporting use cases.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp