ÃÛ¶¹ÊÓƵ

Marketo Integration Best Practices

API Limits

²Ï³Ü¾±³¦°ìÌý°Õ¾±±è²õ

Batching

To ensure the best performance for your integrations, when performing inserts or updates, records should be grouped into as few transactions as possible. When retrieving records from a data store for submission, the records should always be aggregated before submission, rather than submitting a request for each individual change.

Acceptable Latency

Determining your latency tolerances, or the maximum amount of time that may pass before submitting an API call, will inform many, if not most, of the decisions that you make when designing your integration to Marketo. Marketo provides many different methods and configuration options which are suitable for different use cases, and different latency classes. For example, a real-time integration to notify a salesperson of a user signing up for a trial might only submit batches of one if immediate follow-up is required. However, most cases don’t require this and can tolerate additional latency and can be managed more efficiently through queuing and batching calls.

Daily Limits

Each API-enabled instance of Marketo has a daily allocation of at least 10,000 REST API calls per day, but more commonly 50,000 or more, and 500MB or more of Bulk Extract capacity. While additional daily capacity may be purchased as part of a Marketo subscription, your application design should consider the common limits of Marketo subscriptions.

As capacity is shared among all API services and users in an instance, best practice is to eliminate redundant calls, and to batch records into as few calls as possible. The most call efficient way to import records is using Marketo’s bulk import APIs, which are available for and . Marketo also provides Bulk Extract for Leads and Activities.

Caching

Results from the following operations can typically be cached on the client side for a day or more, as they change infrequently:

Caching certain asset types, like programs, emails and folders, is also appropriate for certain use cases, such as data enrichment for lead or activity records.

Rate Limit

Each Marketo instance has a rate limit of 100 calls per 20 seconds, which is shared among all third-party API services. If this limit is exceeded the API responds with a 606 error code indicating that the rate limit has been exceeded. In general, third-party integrations should limit their utilization to 50 calls per 20 seconds or fewer to allow for fair usage of the rate limits by multiple API integrations and users. Though it may be appropriate to saturate this limit in certain cases, in general, applications which use batching and target their throughput to less than this limit are more responsive and consistent in their operation, at a small cost of increased latency.

Concurrency Limit

Each Marketo instance has a shared limit of ten concurrently executing REST API calls. Like the daily quota and rate limits it is shared, so you should not assume that your application will be the exclusive consumer of this limit. Marketo counts the number of concurrent calls as those which are processing and have not yet returned, so when a call returns, it is no longer counted against the concurrent calls limit.

Most integration use cases do not benefit from making concurrent calls, so consider whether your application benefits before deciding to submit concurrent requests to Marketo. If you do wish to implement concurrency, you should cap the number of concurrent requests at five or fewer in your initial design, and only increase this after determining that your application requires more.

Errors

Except for a few rare cases, API requests return an HTTP status code of 200. Business logic errors also return a 200, but contain detailed information in the body of the response. See Error Codes for a detailed explanation. The HTTP reason phrase should not be evaluated as it is optional and subject to change.