API Reference - Microsoft Dynamics 365

Quick Start

Base URL

All API requests must be made to the following endpoint base URL:

https://api.dynamics365.microsoft.com/v2.0

Supported Methods

GET - Retrieve resources

POST - Create resources

PUT - Update resources

DELETE - Delete resources

Authentication

OAuth 2.0 Bearer Flow

All API requests must be authenticated using OAuth 2.0. After obtaining an access token from Microsoft Identity Platform, include it in the Authorization header as a Bearer token.

GET https://login.microsoftonline.com/common/oauth2/v2.0/authorize? client_id={client_id}& response_type=code&redirect_uri={redirect_uri}& response_mode=query&scope=https%3A%2F%2Fapi.dynamics365.com%2F.default

Request Authorization Code

Redirect user to Microsoft IDP
User authenticates and consents

Obtain Access Token

Exchange code for token via POST
Specify necessary API permissions

Authorization Header

GET /api/v2.0/organizations Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

Include in every API request

Scopes Required

https://api.dynamics365.com/.default

This scope grants access to all Dynamics 365 resources

Resource Endpoints

GET /organizations

List Organizations

Retrieve a list of organization units within your Dynamics 365 account

Parameters

top

Maximum number of records to return

filter

OData filter for conditional queries

Example Response

[{"id":"ORG-12345","name":"Northwind Traders"},{"id":"ORG-67890","name":"Adventure Works"}]

POST /users

Create User

Create a new user account with specified permissions and access level

Body Parameters

email

User's email address

role

Assigned permissions

Example Request

{"email":"user@example.com","role":"Admin"}

Response

{"user_id":"USER-45678","status":"Activated"}

Error Response Format

Error 400-599

All API errors return a JSON object with the following structure:

{ "error": { "code": "ORG-404", "message": "Organization not found", "details": "The requested organization ID does not exist in our system.", "inner_error": { "request_id": "123e4567-e89b-12d3-a456-426614174043", "timestamp": "2025-08-19T10:58:23Z" } } }

Common Error Codes

• 401 - Unauthorized request
• 404 - Resource not found
• 429 - Too many requests
• 500 - Internal server error

Support

For urgent issues or questions about error codes not resolved by documentation, contact our support team with the request ID from error responses.