diff --git a/src/connections/sources/catalog/cloud-apps/marketo/index.md b/src/connections/sources/catalog/cloud-apps/marketo/index.md index 96abf99840..a3d63bbc65 100644 --- a/src/connections/sources/catalog/cloud-apps/marketo/index.md +++ b/src/connections/sources/catalog/cloud-apps/marketo/index.md @@ -278,36 +278,32 @@ Currently, Warehouses are the only supported destination for object-cloud source ## FAQs -### How many API calls will the Segment source use? +### How many API calls will the Segment source use to sync all my data? -The Marketo API has different limits for the number of objects returned by different endpoints, but usually 100-300 objects per call. +Segment doesn't provide statistics for these consumed API calls, since Segment systems only log the number of objects pulled from Marketo as throughput. -At set up time, you have the option to specify a cap to the API calls that a source can consume. If no cap is specified, Segment consumes as many API calls that are available to sync the entire source. +### Can I limit API usage on the source? -Segment uses the Lead Activities bulk API to reduce the number of requests needed to sync the data; this however, also has a limit of 500MB worth of files downloaded per day. +Yes. You can specific a daily limit to the API calls the source will consume. If you don't set a limit, Segment will, by default, consume as many API calls as are available in the limit you agreed to with Marketo to sync the entire source. -If your source requires more than 10k calls or over 500MB from the bulk API to sync, Segment continues the sync the following day when a new batch of API calls are available. +Segment also uses the `Lead` and `Activity` [Bulk Extract APIs](https://developers.marketo.com/rest-api/bulk-extract/){:target="_blank"} to reduce the number of requests needed to sync the data. For these syncs, Segment has a limit of 500 MB worth of files downloaded per day. -If you have other applications that use the Marketo API, this can interfere with their ability to make requests. +### What if my daily Marketo API quota isn't enough? -### What Marketo API are you using? +If your source needs more than 10,000 REST API calls or more than 500 MB of data to sync, Segment will continue the sync when a new batch of API calls is available. -Segment uses the REST API in most situations, but also uses the Lead Activity Bulk API to reduce the number of requests needed to sync. +Marketo's API quota applies across your subscription. If other applications share the quota, it could interfere with Segment's ability to sync the source. -### Can I get other collections not default synced by the source? +### Why can't I find the `lead_activities` table in my data warehouse? does Segment not ingest it? -[Contact Support](https://segment.com/help/contact/) to request additional collections. +You first need to enable the **Activity Type IDs (optional)** setting in the Marketo source, which must be enabled for Segment to pull the `lead_activities` collection source. Once Segment pulls the data, it will be available in your data warehouses. -### Can I get other columns not default synced by the source? -For leads and activities, Segment added a custom fields setting where you can enter comma-separated custom fields to sync by their REST API name. +### Can I get other collections synced by the source? -By default, Segment syncs the following fields on the leads collection: +[Contact Support](https://segment.com/help/contact/){:target="_blank"} to get additional collections added to your source. -- `id` -- `email` -- `firstName` -- `lastName` -- `createdAt` -- `updatedAt` +### Can I get other columns synced by the source? -You can find a full list of standard fields and their REST API names [here](http://developers.marketo.com/rest-api/lead-database/fields/list-of-standard-fields/). If there are other fields you're interested in, [contact support](https://segment.com/help/contact/) for assistance. +Yes. For `leads` and `activities`, choose **Custom Lead Fields (optional)**, which lets you enter comma-separated custom files that will be synced by Marketo's REST API name. + +View [Marketo's List of Standard Fields documentation](http://developers.marketo.com/rest-api/lead-database/fields/list-of-standard-fields/){:target="_blank"} for a complete list of standard fields and Marketo's REST API names. [Reach out to Segment support](https://segment.com/help/contact/){:target="_blank"} if you're interested in other fields. \ No newline at end of file