R365 exposes three integration surfaces for building against the R365 platform. This introduction covers each: the R365 Public API (our modern, recommended integration surface), Secure Data Share (direct data access via Snowflake), and the R365 API Connector (our legacy API, maintained for existing integrations).
Recommendation
If you are starting a new data integration or updating an existing one, use the R365 Public API. It supports both reads and writes, covers nearly 4× more of the platform than the legacy API Connector, and is the integration surface R365 will continue to invest in and expand going forward.
R365 Public API
The R365 Public API is our next-generation, recommended integration surface. It supports both reads and writes, covers all major product areas (with nearly 4× more endpoints than the legacy API Connector), and is built on a standardized URL convention. All endpoints follow the /public/v1/{domain}/{resource} pattern with consistent naming and structure across every domain.
Documentation includes:
All endpoints following the standardized
/public/v1/{domain}/{resource}conventionFull request and response schemas with property-level descriptions
Parameter documentation with valid values and defaults
Error response documentation
Use this reference if you are building a new R365 integration or migrating an existing one.
Request Public API Access
Contact your CSM to complete the API Credentials Request form (internal-access only) for access to the R365 Public API.
Secure Data Share
Secure Data Share provides direct, read-only access to R365 data via Snowflake. Rather than pulling data through API requests, you can query R365 data directly from your own Snowflake environment.
Documentation includes:
Setup instructions for connecting to the R365 Snowflake data share
Data dictionary reference for all available views, organized by domain
Use this reference if you need bulk or analytical access to R365 data without making individual API requests.
R365 API Connector
Legacy — Planned for Deprecation
The R365 API Connector is our legacy REST API. It is read-only and will be deprecated in the future as we fully transition to the R365 Public API. If you have an existing integration built on this surface, it will continue to work — but we recommend migrating to the Public API, which offers broader coverage, read/write support, and is the integration surface R365 will continue to build on.
Documentation includes:
All available endpoints, exactly as they exist in production
Full request and response schemas with property-level descriptions
Parameter documentation with valid values and defaults
Error response documentation
Use this reference only if you are maintaining an existing integration that has not yet migrated to the Public API.
Not sure which to use?
If you need to… | Use |
|---|---|
Build a new REST integration | R365 Public API |
Migrate an existing integration to the modern API surface | R365 Public API |
Maintain an existing integration not yet migrated | R365 API Connector (legacy) |
Query R365 data directly from Snowflake | Secure Data Share |