First things first, what is an API?
API stands for Application Programming Interface, which is a set of definitions for building and integrating applications. API uses the standardized method of transferring data that lets you connect and facilitate data transfers between two platforms even though they are built on completely different platforms / tech-stack / architecture. APIs essentially serve as a layer of abstraction for the programmatic access of the data present on the back-end.
Marketo REST API
Marketo’s REST endpoints conform to the constraints of the REST architectural style and allow for interaction with the RESTful web services. Wherever possible, it is advised to use the REST APIs instead of SOAP APIs as they are more secure, more efficient and support more data formats than the latter. Marketo is actively enhancing the existing and adding more REST API endpoints. Following are the major categories of the REST APIs exposed by Marketo -
Marketo SOAP API
The Marketo SOAP API allows for the creation, retrieval and removal of entities and data stored within Marketo using the SOAP methods. Marketo has already phased out the SOAP API, though existing SOAP API endpoints are still working. All the future development/enhancement would be centered on the REST APIs, and hence it is advised to use the REST APIs over the SOAP APIs. The key SOAP API categories are listed below.
Marketo API Limits
Marketo has reinforced below mentioned limits to its API usage -
The following table discusses the error codes for each of the limits enforced by Marketo when the respective limit is reached -
Error Code when limit reached
Bulk API Limit – Too many jobs in queue/ Export daily quota exceeded
Besides this, refer this page for all the REST API error codes and description.
All the API limits are enforced for all the API accesses to Marketo by the launchpoint API services. Hence, the number of API users and third-party integration services should always be monitored, and only necessary API integrations should be implemented. Once the allotted limitations are reached, any additional API calls to Marketo will be throttled until the limits get reset at mid-night CT.
Below are some of the recommended best practices to keep in mind while working with the Marketo APIs:
While this is not an exhaustive list of the Marketo API best practices, but it sure does cover items to help you make the better use of Marketo APIs. Also, if you're just getting started with the APIs, I would recommend going through this Marketo documentation page that'll walk you through creating an API user, a custom launchpoint service, get the access token, and make your first API call.
I hope you found this blog post helpful.
Thank you so much for reading!
- Darshil Shah
Adobe Marketo Engage Champion and Community Advisor
You must be a registered user to add a comment. If you've already registered, sign in. Otherwise, register and sign in.