Web Services
Overview
Web Services allow for communication between different applications and platforms. Sugar currently supports REST and SOAP APIs. The following sections will outline how to interact with the APIs and what versions of the API we recommend for use.
Versioning
API versioning is the process of creating a new set of API endpoints for new functionality while leaving pre-existing endpoints available for third-party applications and integrations to continue using. This helps to extend the application in an upgrade-safe manner.
Quick Reference
When working with the Web Service API, you should be using the latest REST API specific to your release. A quick reference of this can be found below:
| Release1 | REST Version | REST URL | SOAP Version2 | SOAP URL |
| 12.0.x | v11.16 | /rest/v11_16/ | v4.1 | /service/v4_1/soap.php |
| 11.3.x | v11.15 | /rest/v11_15/ | v4.1 | /service/v4_1/soap.php |
| 11.2.x | v11.14 | /rest/v11_14/ | v4.1 | /service/v4_1/soap.php |
| 11.1.x | v11.13 | /rest/v11_13/ | v4.1 | /service/v4_1/soap.php |
| 11.0.x | v11.12 | /rest/v11_12/ | v4.1 | /service/v4_1/soap.php |
| 10.3.x | v11.11 | /rest/v11_11/ | v4.1 | /service/v4_1/soap.php |
| 10.2.x | v11.10 | /rest/v11_10/ | v4.1 | /service/v4_1/soap.php |
| 10.1.x | v11.9 | /rest/v11_9/ | v4.1 | /service/v4_1/soap.php |
| 10.0.x | v11.8 | /rest/v11_8/ | v4.1 | /service/v4_1/soap.php |
| 9.3.x | v11.7 | /rest/v11_7/ | v4.1 | /service/v4_1/soap.php |
| 9.2.x | v11.6 | /rest/v11_6/ | v4.1 | /service/v4_1/soap.php |
| 9.1.x | v11.5 | /rest/v11_5/ | v4.1 | /service/v4_1/soap.php |
| 9.0.x | v11.4 | /rest/v11_4/ | v4.1 | /service/v4_1/soap.php |
| 8.3.x | v11.4 | /rest/v11_4/ | v4.1 | /service/v4_1/soap.php |
| 8.2.x | v11.3 | /rest/v11_3/ | v4.1 | /service/v4_1/soap.php |
| 8.1.x | v11.2 | /rest/v11_2/ | v4.1 | /service/v4_1/soap.php |
| 8.0.x | v11.1 | /rest/v11_1/ | v4.1 | /service/v4_1/soap.php |
| 7.11.x | v11 | /rest/v11/ | v4.1 | /service/v4_1/soap.php |
| 7.10.x | v11 | /rest/v11/ | v4.1 | /service/v4_1/soap.php |
| 7.9.x | v10 | /rest/v10/ | v4.1 | /service/v4_1/soap.php |
| 7.8.x | v10 | /rest/v10/ | v4.1 | /service/v4_1/soap.php |
| 7.7.x | v10 | /rest/v10/ | v4.1 | /service/v4_1/soap.php |
| 6.5.x | v4.1 | /service/v4_1/rest.php | v4.1 | /service/v4_1/soap.php |
1 Some of the releases in this table may no longer be officially-supported Sugar versions, but we have included them for archival purposes. For more information, please refer to the Supported Versions resource page.
2 As of Sugar 7.0, SOAP support is no longer offered with the new APIs. The legacy APIs will remain accessible in the product, however, any existing integrations should be updated to use the latest REST endpoints.