CData Sync App は、Marketo データをデータベース、データレイク、またはデータウェアハウスに継続的にパイプライン化する簡単な方法を提供し、分析、レポート、AI、および機械学習で簡単に利用できるようにします。
Marketo コネクタはCData Sync アプリケーションから使用可能で、Marketo からデータを取得して、サポートされている任意の同期先に移動できます。
Sync App は、REST API バージョン1経由で利用可能なエンティティへのSQL92 アクセスを可能にします。
必須プロパティについては、設定タブを参照してください。
通常必須ではない接続プロパティについては、高度な設定タブを参照してください。
OAuth 資格情報を取得する前に、まだカスタムサービスを持っていない場合は、作成する必要があります。そのためには、カスタムサービスの作成 の手順に従います。
カスタムサービスのOAuth資格情報を取得するには:
このセクションでは、Marketo Sync App の高度な機能を厳選して説明します。
Sync App はユーザー定義ビューの使用をサポートします。これは事前設定されたユーザー定義クエリによって内容が決定される仮想テーブルです。 このビューは、ドライバーに発行されるクエリを直接制御できない場合に有効です。 カスタムビューの作成と設定の概要については、ユーザー定義ビュー を参照してください。
SSL の設定 を使用して、Sync App が証明書のネゴシエーションをどのように扱うかを調整します。さまざまな証明書形式を選択できます。詳しくは、「接続文字列オプション」にあるSSLServerCert プロパティを参照してください。
Windows プロキシとHTTP プロキシを含むファイアウォールとプロキシ に合致するようSync App を設定します。トンネル接続を設定することもできます。
詳しくは、クエリ処理 を参照してください。
デフォルトでは、Sync App はサーバーとのTLS のネゴシエーションを試みます。サーバー証明書は、デフォルトのシステム信頼済み証明書ストアで検証されます。SSLServerCert 接続プロパティを使用して、証明書の検証方法をオーバーライドできます。
別の証明書を指定するには、SSLServerCert 接続プロパティを参照してください。
HTTP プロキシへの認証には、以下のように設定します。
次のプロパティを設定します。
CData Sync App は、Marketo エンティティをリレーショナルテーブル、ビュー、およびストアドプロシージャにモデル化します。
Note: バルクAPI を使用する場合、データモデルが異なる可能性があります。
ストアドプロシージャ は、Marketo のファンクションライクなインターフェースです。これらは、テーブルやビューとしてモデル化できない情報の作成、更新、変更、取得に使用できます。一部のプロシージャは、ファイルのダウンロード / アップロードやBulk API とのやりとりに使用されます。
Sync App はMarketo のデータを、標準のSQL ステートメントを使用してクエリできるリレーショナルデータベースのテーブルのリストとしてモデル化します。
| Name | Description |
| Activities_Custom | Sample custom activity. |
| Companies | Query Companies in Marketo. |
| CustomObjects | Query custom objects for a Marketo organization. |
| Emails | Query emails for a Marketo organization. |
| EmailTemplates | Query email templates for a Marketo organization. |
| Folders | Create, update, delete, and query Folders for a Marketo organization. |
| Forms | Create, update, delete and query Forms for a Marketo organization. |
| LandingPageContentSection | Create, update, delete and query Content Sections of Landing Pages for a Marketo organization. |
| LandingPages | Create, update, delete and query Landing Pages for a Marketo organization. |
| LandingPageTemplates | Create, update, delete and query Landing Page Templates for a Marketo organization. |
| Leads | Query Leads of a Marketo organization. |
| NamedAccounts | Query Named Accounts for a Marketo organization. |
| Opportunities | Query Opportunities in Marketo. |
| OpportunityRoles | Query Opportunity Roles in Marketo. |
| ProgramMembers | Query Program Members in Marketo. |
| Programs | Create, update, delete, and query Programs for a Marketo organization. |
| SalesPersons | Query Sales Persons in Marketo. |
| SmartCampaigns | Query Smart Campaigns for a Marketo organization. |
| SmartLists | Query Smart Lists for a Marketo organization. |
| Snippets | Create, update, delete and query snippets for a Marketo organization. |
| StaticListMembership | Query relations of static lists and leads in Marketo. |
| StaticLists | Query Static Lists for a Marketo organization. |
| Tokens | Create, delete, and query Tokens for a Marketo organization. |
| Users | Query users for a Marketo organization. |
| UserWorkspaceRoles | Query user roles for each workspace in Marketo. |
Sample custom activity.
Each custom activity in your Marketo organization is returned as a separate table, appart from the main "Activities" table. Each table name is prefixed with 'Activity_' followed by the name of your custom activity.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
The following queries are related to a sample custom activity 'Activities_AttendConference'. This table may not exist in your Marketo instance.
SELECT * FROM Activities_AttendConference WHERE ActivityDate > '2024-01-01T00:00:00Z'
SELECT * FROM Activities_AttendConference WHERE ActivityDate >= '2024-01-01T00:00:00Z' AND ActivityDate <= '2024-03-01T00:00:00Z'
SELECT * FROM Activities_AttendConference WHERE ListId = '1014' AND ActivityDate > '2024-01-01T00:00:00Z'
SELECT * FROM Activities_AttendConference WHERE ListId = '1014'
SELECT * FROM Activities_AttendConference WHERE ListId = '1014' AND ActivityDate >' 2024-01-01T00:00:00Z'
INSERT INTO Activities_AttendConference (ActivityDate, LeadId, PrimaryAttributeValue, ConferenceDate, NumberOfAttendees) VALUES ('2024-01-01T00:01:00Z', 4, 'asd', '2024-01-10', 4)
| Name | Type | ReadOnly | Operators | Description |
| MarketoGUID [KEY] | String | False |
Unique id of the activity. | |
| Id | String | False |
Integer id of the activity. This value could exceed Int.MAX. For instances which have been migrated to Activity Service, this field may not be present, and should not be treated as unique. | |
| ActivityDateTime | Datetime | False | >,>=,=,<,<= |
Datetime of the activity. |
| LeadId | Int | False | =,IN |
Id of the lead associated to the activity. |
| CampaignId | Int | False |
Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | False | = |
Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| ConferenceName_Id | String | False | ||
| ConferenceName_Value | String | False | ||
| ConferenceDate | Datetime | False | ||
| NumberOfAttendees | Int | False |
Query Companies in Marketo.
Note: This table is only available for Marketo subscriptions which do not have a native CRM sync enabled.
Note: A server-side filter must be specified to query this table. Queries with the 'OR' operator are not supported.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
Tip: This table uses server-side projection. Performance can be improved by minimizing the number of columns in projection.
SELECT * FROM Companies WHERE [Id]=10
SELECT * FROM Companies WHERE [Id] IN (10, 11, 22)
SELECT * FROM Companies WHERE [ExternalCompanyId]='CData'
SELECT * FROM Companies WHERE [ExternalCompanyId] IN ('CData', 'Marketo')
SELECT * FROM Companies WHERE [Company]='CData'
SELECT * FROM Companies WHERE [Company] IN ('CData', 'Marketo')
SELECT * FROM Companies WHERE [ExternalSalesPersonId]='CDataSales'
SELECT * FROM Companies WHERE [ExternalSalesPersonId] IN ('CDataSales', 'MarketoSales')
This table supports BATCH INSERT when UseBulkAPI is set to false.
INSERT INTO Companies (ExternalCompanyId, Company, Industry, Website) VALUES ('cdata', 'CData', 'Tech', 'cdata.com'), ('marketo', 'Marketo', 'Tech', 'marketo.com')
This table supports BATCH UPDATE when UseBulkAPI is set to false.
UPDATE Companies SET Company='test_UPDATE_Companies', MainPhone='800-555-1234', AnnualRevenue='10000000.00' WHERE ExternalCompanyId='cdata'
UPDATE Companies SET Company='CData', MainPhone='800-555-1234', AnnualRevenue='10000000.00' WHERE WHERE Id IN (2523781, 2523782, 2523783, 2523784)
This table supports BATCH UPSERT when UseBulkAPI is set to false.
UPSERT INTO Companies (ExternalCompanyId, Company, Industry, Website) VALUES ('testUpsert', 'Google', 'Tech', 'google.com')
This table supports BATCH DELETE when UseBulkAPI is set to false.
DELETE FROM Companies WHERE externalCompanyId='cdata'
DELETE FROM Companies WHERE Id IN (2521059, 2521060, 123, 2521058)
DELETE FROM Companies WHERE Company='testName'
| Name | Type | ReadOnly | Operators | Description |
| Id [KEY] | Int | True | =,IN | |
| ExternalCompanyId | String | True | =,IN | |
| AnnualRevenue | Decimal | False | ||
| BillingCity | String | False | ||
| BillingCountry | String | False | ||
| BillingPostalCode | String | False | ||
| BillingState | String | False | ||
| BillingStreet | String | False | ||
| Company | String | False | =,IN | |
| CompanyNotes | String | False | ||
| ExternalSalesPersonId | String | False | =,IN | |
| Industry | String | False | ||
| MainPhone | String | False | ||
| NumberOfEmployees | Int | False | ||
| SicCode | String | False | ||
| Site | String | False | ||
| Website | String | False | ||
| CreatedAt | Datetime | True | ||
| UpdatedAt | Datetime | True |
Query custom objects for a Marketo organization.
Each custom object in your Marketo organization is returned as a separate table. Each table name is prefixed with 'CustomObject_' followed by the name of your custom object.
Note: A server-side filter must be specified to query this table. Queries with the 'OR' operator are not supported.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
The following queries are related to a sample custom object. This table may not exist in your Marketo instance.
SELECT * FROM CustomObject_cdata WHERE MarketoGUID IN ('8207b49b-933c-40a0-995d-d12c90572a65', '71cce7c8-e7d1-4a00-8ea7-89806fee56be')
SELECT * FROM CustomObject_cdata WHERE Mailaddress IN ('[email protected]', '[email protected]')
This table supports BATCH INSERT when UseBulkAPI is set to false.
INSERT INTO CustomObject_cdata (Names) VALUES ('tes123')
This table supports BATCH UPDATE when UseBulkAPI is set to false.
UPDATE CustomObject_cdata SET Value1='testupdate' WHERE Mailaddress='[email protected]'
UPDATE CustomObject_cdata SET Value1='testupdateMultipleValues' WHERE Mailaddress IN ('[email protected]', '[email protected]')
This table supports BATCH UPSERT when UseBulkAPI is set to false.
This table supports BULK UPSERT when UseBulkAPI is set to true.
UPSERT INTO CustomObject_cdata (Mailaddress, Value1) VALUES ('[email protected]', 'test01')
This table supports BATCH DELETE when UseBulkAPI is set to false.
DELETE FROM [CustomObject_cdata] WHERE MarketoGUID='8207b49b-933c-40a0-995d-d12c90572a65'
DELETE FROM [CustomObject_cdata] WHERE MarketoGUID IN ('980415e9-3cf0-4168-ae99-8cf3c613c83b', '71cce7c8-e7d1-4a00-8ea7-89806fee56be')
DELETE FROM [CustomObject_cdata] WHERE Mailaddress='[email protected]'
DELETE FROM [CustomObject_cdata] WHERE Mailaddress IN ('[email protected]', '[email protected]')
| Name | Type | ReadOnly | Operators | Description |
| ListId | Int | True | = |
Mirror column that can be used only as a filter. Will retrieve custom objects related to the provided static list Id. |
| ListName | String | True | = |
Mirror column that can be used only as a filter. Will retrieve custom objects related to the provided static list name. |
| SmartListId | Int | True | = |
Mirror column that can be used only as a filter. Will retrieve custom objects related to the provided smart list Id. |
| SmartListName | String | True | = |
Mirror column that can be used only as a filter. Will retrieve custom objects related to the provided smart list name. |
SELECT * FROM CustomObject_cdata WHERE UpdatedAt>'2024-04-01T00:00:00Z'
SELECT * FROM CustomObject_cdata WHERE UpdatedAt>'2024-04-01T00:00:00Z' AND UpdatedAt<'2024-09-01T00:00:00Z'
SELECT * FROM CustomObject_cdata WHERE ListId=2
| Name | Type | ReadOnly | Operators | Description |
| MarketoGUID [KEY] | String | True | =,IN | |
| UpdatedAt | Datetime | True |
The datetime when the custom object was last updated. | |
| CreatedAt | Datetime | True | ||
| Mailaddress | String | False | =,IN | |
| Value1 | String | False |
Query emails for a Marketo organization.
Note: This table uses the draft/approved versioning API. By default both versions are retrieved/modified. To interact with a specific version use the filter Status='draft' or Status='approved'.
GetEmailFullContent can be used to retrieve the full content of an email.
UpdateEmailContent can be used to update the content content of an email.
UpdateEmailFullContent can be used to update the full content of an email.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
For example, the following queries are processed server-side:
SELECT * FROM Emails WHERE Id=15457
SELECT * FROM Emails WHERE Name='[email protected]'
SELECT * FROM Emails WHERE FolderId=26
SELECT * FROM Emails WHERE UpdatedAt >= '2023-03-22 00:09:14.0' AND UpdatedAt <= '2023-03-22 01:49:03.0'
INSERT INTO Emails (Name, TemplateId, FolderId, FolderType) VALUES ('My Email', 1037, 5111, 'Program')
UPDATE Emails SET Name='CRUD Test', Description='Testing CRUD' WHERE Id=23852
DELETE FROM Emails WHERE Id=23838
DELETE FROM Emails WHERE Id=23759 AND Status='approved'
DELETE FROM Emails WHERE Id IN (17008, 23764) AND Status='draft'
| Name | Type | ReadOnly | Operators | Description |
| Id [KEY] | Int | True | = |
The unique, Marketo-assigned identifier of the email. |
| Status [KEY] | String | True | = |
The status of the email, draft or approved version. |
| Name | String | False | = |
The name of the email. |
| Description | String | False |
The description of the email. | |
| Subject | String | False |
The email subject. | |
| FromName | String | False |
The from name. | |
| FromEmail | String | False |
The from email address. | |
| ReplyEmail | String | False |
The reply email address. | |
| PreHeader | String | False |
The pre-header text for the email. | |
| URL | String | True |
The URL of the asset in the Marketo UI. | |
| TemplateId | Int | False |
The template associated with the email. | |
| PublishToMSI | Bool | True |
Identifies whether the email is published. | |
| Version | Int | True |
The Template version type. | |
| Operational | Bool | False |
Identifies whether the email is operational. | |
| TextOnly | Bool | False |
Identifies whether the email is text only. | |
| WebView | Bool | False |
Identifies whether the email is web view. | |
| AutoCopyToText | Bool | False |
Identifies whether the email is auto copied to text. | |
| FolderId | Int | False | = |
The unique, Marketo-assigned identifier of the parent folder/program. |
| FolderName | String | True |
The name of the folder | |
| FolderType | String | False | = |
The type of folder (Folder,Program) |
| WorkspaceName | String | True |
Name of the workspace the email is part of. | |
| CreatedAt | Datetime | True |
Datetime the email was created. | |
| UpdatedAt | Datetime | True | =,>,<,>=,<= |
Datetime the email was most recently updated. |
Query email templates for a Marketo organization.
Note: This table uses the draft/approved versioning API. By default both versions are retrieved/modified. To interact with a specific version use the filter Status='draft' or Status='approved'.
CreateEmailTemplate can be used to create email templates.
GetEmailTemplateContent can be used to retrieve the email template content.
UpdateEmailTemplateContent can be used to update the email template content.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
For example, the following queries are processed server-side:
SELECT * FROM EmailTemplates WHERE ID=1038
SELECT * FROM EmailTemplates WHERE Name='Test Template 3'
SELECT * FROM EmailTemplates WHERE Status='approved'
SELECT * FROM EmailTemplates WHERE ID=1038 AND Status='approved'
UPDATE EmailTemplates SET Description='test update' WHERE Id=1039
DELETE FROM EmailTemplates WHERE Id=1014
DELETE FROM EmailTemplates WHERE Id=1034 AND Status='draft'
DELETE FROM EmailTemplates WHERE Name='Serenity (Marketo Starter Template)
| Name | Type | ReadOnly | Operators | Description |
| Id [KEY] | Int | True | = |
The id of the asset. |
| Status [KEY] | String | True | = |
Status of the email template, draft or approved versions. |
| Name | String | False | = |
The name of the asset. |
| Description | String | False |
The description of the asset. | |
| URL | String | True |
The URL of the asset in the Marketo UI. | |
| Version | Int | True |
The Template version type. | |
| WorkspaceName | String | True |
Name of the workspace the email template is part of. | |
| FolderId | Int | True |
The unique, Marketo-assigned identifier of the parent folder/program. | |
| FolderName | String | True |
The name of the folder | |
| FolderType | String | True |
The type of folder (Folder,Program) | |
| CreatedAt | Datetime | True |
The date and time the asset was created. | |
| UpdatedAt | Datetime | True |
The date and time the asset was last updated. |
Create, update, delete, and query Folders for a Marketo organization.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
For example, the following queries are processed server-side:
SELECT * FROM Folders WHERE Name='Marketo8'
SELECT * FROM Folders WHERE Name='Default'
SELECT * FROM Folders WHERE Name='Default' AND WorkspaceName='Default'
SELECT * FROM Folders WHERE MaxDepth=1;
SELECT * FROM Folders WHERE ParentId=12 AND ParentType='Folder'
SELECT * FROM Folders WHERE ParentId=12
INSERT INTO Folders (Name, ParentId, ParentType, Description) VALUES ('newFolder1234567', 38, 'Folder', 'test insert description')
UPDATE Folders SET Description='test update folders2', IsArchive='true' WHERE Id IN (5910, 5911) AND Type='Folder'
Note: Folders of Type='Program' and folders with IsSystem=true can not be deleted.
DELETE FROM Folders WHERE Id=5363 AND Type='Folder'
| Name | Type | ReadOnly | Operators | Description |
| Id [KEY] | Int | True | = |
The unique, Marketo-assigned identifier of the folder. |
| Type [KEY] | String | False | = |
The type of the folder (Folder or Program). |
| Name | String | False | = |
The name of the folder. |
| Description | String | False |
The description of the folder. | |
| FolderType | String | True |
The type of the folder (Revenue Cycle Model, Marketing Folder, List, Smart List). | |
| ParentId | Int | False | = |
The Id of the parent folder. |
| ParentType | String | False | = |
The type of the parent folder. |
| Path | String | True |
The path of a folder shows its hierarchy in the folder tree, similar to a Unix-style path. | |
| WorkspaceName | String | True | = |
The name of the smart campaign workspace. |
| URL | String | True |
The explicit URL of the asset in the designated instance. | |
| IsSystem | Bool | True |
Whether or not the folder is a system folder. | |
| IsArchive | Bool | False |
Whether or not the folder is archived. | |
| AccessZoneId | Int | True |
The access zone id | |
| CreatedAt | Datetime | True |
The date and time the folder was created. | |
| UpdatedAt | Datetime | True |
The date and time the folder was last updated. | |
| MaxDepth | Int | True | = |
Mirror column used to specify the maximum folder depth to traverse. Will be ignored when filtering by Id or Name. |
Create, update, delete and query Forms for a Marketo organization.
Note: This table uses the draft/approved versioning API. By default both versions are retrieved/modified. To interact with a specific version use the filter Status='draft' or Status='approved'.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
For example, the following queries are processed server-side:
SELECT * FROM FORMS WHERE status='draft'
SELECT * FROM FORMS WHERE Id=1001
SELECT * FROM FORMS WHERE Name='Form1'
SELECT * FROM FORMS WHERE Id=1001 AND Status='draft'
SELECT * FROM FORMS WHERE FolderId=1089 AND FolderType='Program'
SELECT * FROM FORMS WHERE FolderId=1002
INSERT INTO Forms (Name, Description, FolderId, FolderType, FontFamily, FontSize, LabelPosition, Language, Locale, ProgressiveProfiling)
VALUES ('test insert form', 'test form description', 1089, 'Program', 'Arial', '12px', 'left', 'English', 'en_US', true)
UPDATE Forms SET Name='test update form', Description='Testing Update', FontSize='13px' WHERE Id=1016
DELETE FROM Forms WHERE Id=1004
DELETE FROM Forms WHERE Id=1004 AND Status='draft'
DELETE FROM Forms WHERE Name IN ('test', 'My Snippet')
| Name | Type | ReadOnly | Operators | Description |
| Id [KEY] | Int | True | = |
The unique, Marketo-assigned identifier of the form. |
| Status [KEY] | String | True | = |
Status of the form, draft or approved versions. |
| Name | String | False | = |
The name of the form. |
| Description | String | False |
The description of the form. | |
| URL | String | True |
The URL of the form in the Marketo UI. | |
| KnownVisitorTemplate | String | False |
Template of the known visitor behavior for the form. | |
| KnownVisitorType | String | False |
Type of the known visitor behavior for the form. | |
| Theme | String | False |
CSS theme for the form to use. | |
| Language | String | False |
Language of the form. | |
| Locale | String | False |
Locale of the form. | |
| ProgressiveProfiling | Bool | False |
Whether progressive profiling is enabled for the form. | |
| LabelPosition | String | False |
Default positioning of labels. | |
| ButtonLabel | String | False |
Label text of the button. | |
| ButtonWaitingLabel | String | False |
Waiting text of the button. | |
| ButtonLocation | Int | False |
Location in pixels of the button relative to the left of the form. | |
| FontFamily | String | False |
font-family property for the form. | |
| FontSize | String | False |
font-size property of the form. | |
| FolderId | Int | False | = |
The unique, Marketo-assigned identifier of the parent folder/program. |
| FolderName | String | True |
The name of the folder | |
| FolderType | String | False | = |
The type of folder (Folder,Program) |
| WorkspaceId | Int | True |
Workspace Id of the asset. | |
| CreatedAt | Datetime | True |
Datetime the form was created. | |
| UpdatedAt | Datetime | True |
Datetime the form was most recently updated. | |
| ThankYouList | String | True |
JSON array of ThankYouPage JSON objects. |
Create, update, delete and query Content Sections of Landing Pages for a Marketo organization.
Note: This table uses the draft/approved versioning API. By default both versions are retrieved/modified. To interact with a specific version use the filter Status='draft' or Status='approved'.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
For example, the following queries are processed server-side:
SELECT * FROM LandingPageContentSection WHERE LandingPageId='2'
SELECT * FROM LandingPageContentSection WHERE LandingPageId='2' AND status='draft'
INSERT INTO LandingPageContentSection (LandingPageId, Content, Type, Height, Width, FormattingOptionsTop, FormattingOptionsLeft, Opacity, BorderColor, BackgroundColor, HideDesktop, HideMobile, ImageOpenNewWindow, FormattingOptionsZIndex)
VALUES (1009, '<html><body>Hello World!</body></html>', 'HTML', '100', '101', '1', '2', '0.8', '#ff00ff', '#00ffff', false, true, true, 1)
UPDATE LandingPageContentSection BorderColor='#ff0000', BackgroundColor='#0000ff', HideMobile='true', ImageOpenNewWindow='true', Type='HTML', FormattingOptionsTop='1', FormattingOptionsLeft='2', Width='101', HideDesktop='false', Opacity='0.8', Content='<html><body>Hello World!</body></html>', Height='100', FormattingOptionsZIndex='1'
WHERE LandingPageId=1009 AND Id=1049
DELETE FROM LandingPageContentSection WHERE LandingPageId=1009
| Name | Type | ReadOnly | Operators | Description |
| Id [KEY] | String | True |
Id of the content section. | |
| LandingPageId [KEY] | String | False | = |
Id of the landing page to which the content section belongs to. |
| Status [KEY] | String | True | = |
Status filter for draft or approved versions. |
| Index | Int | True |
Index of the content section. Index orients the elements from lowest to highest. | |
| Type | String | False |
Type of content section. | |
| Content | String | False |
Content of the section. Expected values vary based on type. Image: An image URL. RichText: HTML Content. | |
| RawContent | String | True |
Raw content of the section. Expected values vary based on type. Image: An image URL. RichText: HTML Content. | |
| ContentType | String | True |
Content of the section. Expected values vary based on type. Image: An image URL. RichText: HTML Content. | |
| ContentURL | String | True |
Content of the section. Expected values vary based on type. Image: An image URL. RichText: HTML Content. | |
| LinkURL | String | False |
RL parameter of a link type section. | |
| FollowupType | String | False |
Follow-up behavior of a form. Only available for form-type content sections. Defaults to form defined behavior. | |
| FollowupValue | String | False |
Where to follow-up on form submission. When followupType is lp, accepts the integer id of a landing page. For url, it accepts a url string. | |
| Height | String | False |
The height of the content. | |
| MinHeight | String | True |
The min height of the content. | |
| Width | String | False |
The width of the content. | |
| MinWidth | String | True |
The min width of the content. | |
| FormattingOptionsTop | String | False |
The top margin of the content. | |
| FormattingOptionsLeft | String | False |
The left margin of the content. | |
| Opacity | String | False |
The opacity of the content. | |
| BorderWidth | String | False |
The border width of the content. | |
| BorderStyle | String | False |
The border style of the content. | |
| BorderColor | String | False |
The border color of the content. | |
| BackgroundColor | String | False |
The background color of the content. | |
| HideDesktop | Bool | False |
Hide the section when displayed on a desktop browser. Default false. | |
| HideMobile | Bool | False |
Hide the section when displayed on a desktop browser. Default false. | |
| ImageOpenNewWindow | String | False |
ImageOpenNewWindow | |
| FormattingOptionsZIndex | String | False |
The z-index of the content. |
Create, update, delete and query Landing Pages for a Marketo organization.
Note: This table uses the draft/approved versioning API. By default both versions are retrieved/modified. To interact with a specific version use the filter Status='draft' or Status='approved'.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
For example, the following queries are processed server-side:
SELECT * FROM LandingPages WHERE status='approved'
SELECT * FROM LandingPages WHERE folderId=1001
SELECT * FROM LandingPages WHERE folderId=1001 AND status='draft'
SELECT * FROM LandingPages WHERE name='string'
INSERT INTO LandingPages (Name, CustomHeadHTML, Description, FacebookOgTags, FolderId, FolderType, Keywords, MobileEnabled, Robots, Template, Title)
VALUES ('test insert landing page', '<!DOCTYPE html>\\n<html>\\n<body>\\n<h1>My landing page</h1>\\n<p>My landing page content.</p>\\n</body></html>', 'Testing Insert operation', '', 1184, 'Program', '', true, 'index, nofollow', 1, 'Insert Operation')
UPDATE LandingPages SET Description='Testing Update', FacebookOgTags='', Keywords='',
MobileEnabled=false, Name='Test Update', Robots='index, nofollow',Title='Updating Landing Page',
CustomHeadHTML='<!DOCTYPE html>\n<html>\n<body>\n<h1>Updating Landing Page</h1>\n<p>Editing Landing Page</p>\n</body></html>'
WHERE Id=1009
Note: Approved landing pages cannot be deleted. Use UnApproveAsset to revoke landing page approval.
DELETE FROM LandingPages WHERE Id=1003
DELETE FROM LandingPages WHERE Id=1003 WHERE status='draft'
| Name | Type | ReadOnly | Operators | Description |
| Id [KEY] | Int | True | = |
The unique, Marketo-assigned identifier of the landing page. |
| Status [KEY] | String | True | = |
Status filter for draft or approved versions. |
| Name | String | False | = |
The name of the landing page. |
| Description | String | False |
The description of the landing page. | |
| Title | String | False |
Title element of the landing page. | |
| URL | String | True |
The URL of the landing page in the Marketo UI. | |
| ComputedURL | String | True |
Computed URL of landing page. | |
| WorkspaceName | String | False |
Workspace name of the asset. | |
| Template | Int | False |
Id of the template used. | |
| Robots | String | False |
Robots directives to apply to the pages meta tags | |
| MobileEnabled | Bool | False |
Whether the page has mobile viewing enabled. Free-form pages only. Default false. | |
| CustomHeadHTML | String | False |
Any custom HTML to embed in the tag of the page. | |
| Keywords | String | False |
Keywords | |
| FormPrefill | Bool | True |
Boolean to toggle whether forms embedded in the page will prefill. Default false. | |
| FacebookOgTags | String | False |
Any OpenGraph meta tags to apply to the page. | |
| FolderId | Int | False | = |
The unique, Marketo-assigned identifier of the parent folder/program. |
| FolderName | String | True |
The name of the folder | |
| FolderType | String | False | = |
The type of folder (Folder,Program) |
| CreatedAt | Datetime | True |
Datetime the landing page was created. | |
| UpdatedAt | Datetime | True |
Datetime the landing page was most recently updated. |
Create, update, delete and query Landing Page Templates for a Marketo organization.
Note: This table uses the draft/approved versioning API. By default both versions are retrieved/modified. To interact with a specific version use the filter Status='draft' or Status='approved'.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side. The Name and Id filters will be processed server-side only if Status='approved'.
For example, the following queries are processed server-side:
SELECT * FROM LandingPageTemplates WHERE Status='approved'
SELECT * FROM LandingPageTemplates WHERE FolderId=19
SELECT * FROM LandingPageTemplates WHERE Name='Test Insert 1' AND Status='approved'
SELECT * FROM LandingPageTemplates WHERE Id=3 AND Status='approved'
INSERT INTO LandingPageTemplates (Name, TemplateType, Description, EnableMunchkin, FolderId, FolderType)
VALUES ('Test Insert 1', 'guided', 'Testing Insert', true, 19, 'Folder')
UPDATE LandingPageTemplates SET Description='Testing Update', EnableMunchkin=false, Name='Test Update' WHERE Id=1
DELETE FROM LandingPageTemplates WHERE Id=2 AND Status='approved'
DELETE FROM LandingPageTemplates WHERE Name='Test Insert 1'
| Name | Type | ReadOnly | Operators | Description |
| Id [KEY] | Int | True | = |
The unique, Marketo-assigned identifier of the landing page template. |
| Status [KEY] | String | True | = |
Status of the landing page template, draft or approved versions. |
| Name | String | False | = |
The name of the landing page template. |
| Description | String | False |
The description of the landing page template. | |
| EnableMunchkin | Bool | False |
Whether to enable munchkin on the derived pages. Defaults to true. | |
| TemplateType | String | False |
Type of template to create 'guided' or 'freeForm' | |
| URL | String | True |
The URL of the landing page in the Marketo UI. | |
| WorkspaceName | String | True |
Workspace name of the asset. | |
| FolderId | Int | False | = |
The unique, Marketo-assigned identifier of the parent folder/program. |
| FolderName | String | True |
The name of the folder | |
| FolderType | String | False | = |
The type of folder (Folder,Program) |
| CreatedAt | Datetime | True |
Datetime the landing page template was created. | |
| UpdatedAt | Datetime | True |
Datetime the landing page template was most recently updated. |
Query Leads of a Marketo organization.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
Tip: This table uses server-side projection. Performance can be improved by minimizing the number of columns in projection.
To optimize response time from the server, identify only the rows and columns you want to retrieve.
SELECT Id, FirstName, LastName FROM Leads WHERE Id IN (1, 2, 5, 10)
To achieve the best performance from this query, confine it to a list of known Leads within Marketo. Create a static list of Leads within Marketo, and then specify the ListId to retrieve them.
SELECT * FROM Leads WHERE ListId=1014
If you do not specify a filter, the driver retrieves all Leads, which might take a long time depending on the number of leads in your Marketo instance.
Specify the UpdatedAt filter to improve query performance by limiting the number of records requested.
SELECT * FROM Leads WHERE UpdatedAt >= '2024-03-20T15:49:22.000Z'
SELECT Id, UpdatedAt FROM Leads WHERE UpdatedAt >= '2024-01-17T14:32:37.000-05:00'
This table supports BATCH INSERT when UseBulkAPI is set to false.
INSERT INTO Leads (FirstName, LastName, Email, DoNotCall, DoNotCallReason, DateOfBirth) VALUES ('test', 'test', '[email protected]', true, 'Testing', '01/01/2000')
INSERT INTO Leads (FirstName, LastName, Email, DoNotCall, DoNotCallReason, DateOfBirth) VALUES ('test1', 'test1', '[email protected]', true, 'Testing', '01/01/2000'), ('test3', 'test3', '[email protected]', true, 'Testing', '01/01/2000')
INSERT INTO Leads (FirstName, LastName, Email, PartitionName) VALUES ('test', 'test', '[email protected]', 'testPartition')
To insert multiple leads at once via a #TEMP table, first create the #TEMP table, and then insert that table into your Leads table.
The following example creates a #TEMP table with three new Leads, and then inserts that #TEMP table into the Leads table:
INSERT INTO Leads#TEMP (FirstName, LastName, Email, Company) VALUES ('John', 'Mangel', '[email protected]', 'ABC')
INSERT INTO Leads#TEMP (FirstName, LastName, Email, Company) VALUES ('Steve', 'Puth', '[email protected]', 'ABC')
INSERT INTO Leads#TEMP (FirstName, LastName, Email, Company) VALUES ('Andrew', 'Stack', 'andy@abc', 'ABC')
INSERT INTO Leads (FirstName, LastName, Email, Company) SELECT FirstName, LastName, Email, Company FROM Leads#TEMP
This table supports BATCH UPDATE when UseBulkAPI is set to false.
You can update any field in the Leads table that is not read-only. All critria fields are used as deduplication fields. Use a field for deduplication if it supports server side filtering, otherwise the Id column is used for deduplication.
UPDATE Leads SET Company='TestCompany', NumberOfEmployees=100 WHERE Id='2521004'
UPDATE Leads SET Title='My Job', Address='123 Main St' WHERE Email='[email protected]'
UPDATE LEADS SET Email='[email protected]' WHERE Id=2523020
UPDATE LEADS SET TestKpQA='test' WHERE TestCustomfieldEmail='[email protected]'
This table supports BATCH UPSERT when UseBulkAPI is set to false.
This table supports BULK UPSERT when UseBulkAPI is set to true.
UPSERT INTO Leads (Email, FirstName, LastName) VALUES ('[email protected]', 'Lead', 'Upsert_InsertNewRecord')
This table supports BATCH DELETE when UseBulkAPI is set to false.
DELETE FROM Leads WHERE Id=508
DELETE FROM Leads WHERE Id IN (505, 506, 501, 507)
DELETE FROM Leads WHERE Email='[email protected]'
Note: The API returns only leads which have been deleted in the past 14 days.
GetDeleted FROM Leads
GetDeleted supports filtering by UpdatedAt.
GETDELETED FROM Leads WHERE UpdatedAt > '2024-01-01T01:00:00' GETDELETED FROM Leads WHERE UpdatedAt > '2024-01-01T01:00:00' AND UpdatedAt <= '2024-02-01T01:00:00'
| Name | Type | ReadOnly | Operators | Description |
| StaticListName | String | True | = |
Mirror column that can be used only as a filter. Will retrieve custom objects related to the provided static list name. |
| SmartListId | Int | True | = |
Mirror column that can be used only as a filter. Will retrieve custom objects related to the provided smart list Id. |
| SmartListName | String | True | = |
Mirror column that can be used only as a filter. Will retrieve custom objects related to the provided smart list name. |
SELECT Id, UpdatedAt FROM LEADS WHERE UpdatedAt>'2024-01-17T14:28:57.000-05:00' AND UpdatedAt<'2024-01-29T04:29:55.000-05:00'
SELECT Id, CreatedAt FROM LEADS WHERE CreatedAt>='2024-01-17T14:27:20.000-05:00' AND CreatedAt<'2024-01-29T04:29:30.000-05:00'
SELECT * FROM LEADS WHERE ListId=1062
SELECT * FROM LEADS WHERE StaticListName='test0614'
SELECT Id FROM LEADS WHERE SmartListId=1095
SELECT Id FROM LEADS WHERE SmartListName='LeadSmartListTest'
| Name | Type | ReadOnly | Operators | Description |
| Id [KEY] | Int | True | =,IN |
The id of the lead. |
| CreatedAt | Datetime | True |
The datetime when the lead was created. | |
| UpdatedAt | Datetime | True | =,>,>=,<,<= |
The datetime when the lead was last updated. |
| ProgramId | Int | True | = |
Mirror column that can be used only as a filter. Will retrieve Leads related to the given email ProgramId. Not available when UseBulkAPI=true. |
| ListId | Int | True | = |
Mirror column that can be used only as a filter. Will retrieve Leads related to the provided static list Id. |
| PartitionName | String | False |
Mirror column that can be used only during inserts to specify the partition of the lead. | |
| ItemURL | String | True |
The URL of the lead in the Marketo UI. | |
| AcmeAccessCode | String | False | =,IN | |
| AcquisitionProgramId | Int | False | ||
| Address | String | False | ||
| AnnualRevenue | Decimal | False | ||
| AnonymousIP | String | False | ||
| BillingCity | String | False | ||
| BillingCountry | String | False | ||
| BillingPostalCode | String | False | ||
| BillingState | String | False | ||
| BillingStreet | String | False | ||
| BlackListed | Bool | False | ||
| BlackListedCause | String | False | ||
| City | String | False | ||
| Company | String | False | ||
| ContactCompany | Int | True | ||
| Cookies | String | False | =,IN | |
| Country | String | False | ||
| Cstmfdtest1 | String | False | =,IN | |
| Cstmfdtest2 | String | False | =,IN | |
| DateOfBirth | Date | False | ||
| Department | String | False | =,IN | |
| DoNotCall | Bool | False | ||
| DoNotCallReason | String | False | ||
| Ecids | String | True | ||
| String | False | =,IN | ||
| EmailInvalid | Bool | False | ||
| EmailInvalidCause | String | False | ||
| EmailSuspended | Bool | False | ||
| EmailSuspendedAt | Datetime | False | ||
| EmailSuspendedCause | String | False | =,IN | |
| ExternalCompanyId | String | False | =,IN | |
| ExternalSalesPersonId | String | False | =,IN | |
| Fax | String | False | ||
| FirstName | String | False | ||
| FirstUTMCampaign | String | False | ||
| FirstUTMContent | String | False | ||
| FirstUTMMedium | String | False | ||
| FirstUTMSource | String | False | ||
| FirstUTMTerm | String | False | ||
| GdprMailableStatus | String | False | ||
| Industry | String | False | ||
| InferredCity | String | True | ||
| InferredCompany | String | True | ||
| InferredCountry | String | True | ||
| InferredMetropolitanArea | String | True | ||
| InferredPhoneAreaCode | String | True | ||
| InferredPostalCode | String | True | ||
| InferredStateRegion | String | True | ||
| IsAnonymous | Bool | False | ||
| IsLead | Bool | False | ||
| LastName | String | False | ||
| LatestUTMCampaign | String | False | ||
| LatestUTMContent | String | False | ||
| LatestUTMMedium | String | False | ||
| LatestUTMSource | String | False | ||
| LatestUTMterm | String | False | ||
| LeadPartitionId | Int | False | =,IN | |
| LeadPerson | Int | True | ||
| LeadRevenueCycleModelId | Int | False | ||
| LeadRevenueStageId | Int | False | ||
| LeadRole | String | False | ||
| LeadScore | Int | False | ||
| LeadSource | String | False | ||
| LeadStatus | String | False | ||
| MainPhone | String | False | ||
| MarketingSuspended | Bool | False | ||
| MarketingSuspendedCause | String | False | ||
| MiddleName | String | False | ||
| MktoAcquisitionDate | Datetime | False | ||
| MktoCompanyNotes | String | False | ||
| MktoDoNotCallCause | String | False | ||
| MktoIsCustomer | Bool | False | ||
| MktoIsPartner | Bool | False | ||
| MktoName | String | True | =,IN | |
| MktoPersonNotes | String | False | ||
| MobilePhone | String | False | ||
| NumberOfEmployees | Int | False | ||
| NumberofEmployeesProspect | String | False | ||
| OriginalReferrer | String | True | ||
| OriginalSearchEngine | String | True | ||
| OriginalSearchPhrase | String | True | ||
| OriginalSourceInfo | String | True | ||
| OriginalSourceType | String | True | ||
| PersonLevelEngagementScore | Int | False | =,IN | |
| PersonPrimaryLeadInterest | Int | True | ||
| PersonTimeZone | String | True | ||
| PersonType | String | False | ||
| Phone | String | False | ||
| PostalCode | String | False | ||
| Priority | Int | False | ||
| Rating | String | False | ||
| RegistrationSourceInfo | String | False | ||
| RegistrationSourceType | String | False | ||
| RelativeScore | Int | False | ||
| RelativeUrgency | Int | False | ||
| Salutation | String | False | ||
| SicCode | String | False | ||
| Site | String | False | ||
| State | String | False | ||
| Test | String | False | =,IN | |
| Test1 | Bool | False | ||
| Test98 | String | False | =,IN | |
| TestBoolean | Bool | False | ||
| TestCustomfieldEmail | String | False | =,IN | |
| TestFieldText1 | String | False | =,IN | |
| TestInteger | Bool | False | ||
| TestInteger_cf | Int | False | =,IN | |
| TestKpQA | String | False | =,IN | |
| Title | String | False | ||
| Unsubscribed | Bool | False | ||
| UnsubscribeDateFoFS | String | False | ||
| UnsubscribeDateUnleashed | String | False | ||
| UnsubscribedReason | String | False | ||
| UnsubscribeFoFS | String | False | ||
| UnsubscribeMarketing | String | False | ||
| UnsubscribeSales | String | False | ||
| UnsubscribeUnleashed | String | False | ||
| Urgency | Double | False | ||
| UTMTerm | String | False | =,IN | |
| Website | String | False |
Query Named Accounts for a Marketo organization.
Note: A server-side filter must be specified to query this table. Queries with the 'OR' operator are not supported.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
Tip: This table uses server-side projection. Performance can be improved by minimizing the number of columns in projection.
SELECT * FROM NamedAccounts WHERE Name='MyNamedAccount1'
This table supports BATCH INSERT when UseBulkAPI is set to false.
INSERT INTO NamedAccounts (Name, City, Country, DomainName, Industry) VALUES ('testNamedAccountInsert002', 'Chapel Hill', 'USA', 'MyDomain', 'Tech')
This table supports BATCH UPDATE when UseBulkAPI is set to false.
UPDATE NamedAccounts SET NumberOfEmployees=100, State='NC', AnnualRevenue='10000000.00' WHERE Name='testNamedAccountInsert002'
UPDATE NamedAccounts SET NumberOfEmployees=999 WHERE MarketoGUID='197d0ecd-4264-4826-a44a-58a6df1f9ae5'
This table supports BATCH UPSERT when UseBulkAPI is set to false.
UPSERT INTO NamedAccounts (Name, City, Country, DomainName, Industry) VALUES ('testUpsert', 'Chapel Hill', 'USA', 'MyDomain', 'Tech')
This table supports BATCH DELETE when UseBulkAPI is set to false.
DELETE FROM NamedAccounts WHERE Name IN ('MyAccount2', 'MyAccount')
DELETE FROM NamedAccounts WHERE marketoGUID IN ('04da404b-c4e9-40c8-867f-d9fae0062343', 'fd422222-a37f-4c2b-86df-3ed4c22e9c79')
| Name | Type | ReadOnly | Operators | Description |
| MarketoGUID [KEY] | String | True | =,IN | |
| Id | Int | True | =,IN | |
| ApproximateNumOfPeople | Int | True | =,IN | |
| ParentAccountId | Int | True | =,IN | |
| AccountOwnerId | Int | False | =,IN | |
| AccountPhoneNumber | String | False | =,IN | |
| AddressPostalCode | String | False | =,IN | |
| AddressRegion | String | False | =,IN | |
| AnnualRevenue | Decimal | False | =,IN | |
| City | String | False | =,IN | |
| Country | String | False | =,IN | |
| CreatedAt | Datetime | True | ||
| CrmGuid | String | False | =,IN | |
| CrmOrgId | Int | False | =,IN | |
| DomainName | String | False | =,IN | |
| ExternalSourceId | String | False | =,IN | |
| ExternalSourceInstanceId | String | False | =,IN | |
| ExternalSourceKey | String | False | =,IN | |
| ExternalSourceType | String | False | =,IN | |
| Industry | String | False | =,IN | |
| LogoUrl | String | False | =,IN | |
| MembershipCount | Int | True | =,IN | |
| Name | String | False | =,IN | |
| NumberOfEmployees | Int | False | =,IN | |
| OpptyAmount | Decimal | True | =,IN | |
| OpptyCount | Int | True | =,IN | |
| SicCode | String | False | =,IN | |
| SourceType | String | False | =,IN | |
| State | String | False | =,IN | |
| Street1 | String | False | =,IN | |
| UpdatedAt | Datetime | True |
Query Opportunities in Marketo.
Note: This table is only available for Marketo subscriptions which do not have a native CRM sync enabled.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
Tip: This table uses server-side projection. Performance can be improved by minimizing the number of columns in projection.
Note: A filter must be specified when retrieving Opportunities.
SELECT * FROM Opportunities WHERE ExternalOpportunityId='test2'
SELECT * FROM Opportunities WHERE ExternalCompanyId='CData'
This table supports BATCH INSERT when UseBulkAPI is set to false.
INSERT INTO Opportunities (ExternalOpportunityId, Description, ExternalCompanyId, Name) VALUES ('testOpportunitiesInsert001', 'First Opportunity', 'cdata', 'Opp')
This table supports BATCH UPDATE when UseBulkAPI is set to false.
UPDATE Opportunities SET IsWon=true, FiscalYear=2016, Amount='1000.00' WHERE ExternalOpportunityId='testOpportunitiesInsert001'
UPDATE Opportunities SET IsWon=false, FiscalYear=2017, Amount='1000.00' WHERE ExternalCompanyId='testInsert_ExternalCompanyId_012'
This table supports BATCH UPSERT when UseBulkAPI is set to false.
UPSERT INTO Opportunities (ExternalOpportunityId, Description, ExternalCompanyId, Name) VALUES ('testUpsert', 'First Opportunity', 'CData', 'Opp')
This table supports BATCH DELETE when UseBulkAPI is set to false.
DELETE FROM Opportunities WHERE ExternalOpportunityId='CDATA2'
DELETE FROM Opportunities WHERE marketoGUID IN ('c1bac835-e5d3-47cc-9c87-bd18fdf573f8', '04ecb93c-d140-4c38-96cc-1fc2821e91eb')
| Name | Type | ReadOnly | Operators | Description |
| CreatedAt | Datetime | True | ||
| ExternalOpportunityId | String | True | =,IN | |
| MarketoGUID [KEY] | String | True | =,IN | |
| UpdatedAt | Datetime | True | ||
| Amount | Decimal | False | ||
| CloseDate | Date | False | ||
| Description | String | False | ||
| ExpectedRevenue | Decimal | False | ||
| ExternalCompanyId | String | False | =,IN | |
| ExternalCreatedDate | Datetime | False | ||
| ExternalSalesPersonId | String | False | =,IN | |
| Fiscal | String | False | ||
| FiscalQuarter | Int | False | ||
| FiscalYear | Int | False | ||
| ForecastCategory | String | False | ||
| ForecastCategoryName | String | False | ||
| IsClosed | Bool | False | ||
| IsWon | Bool | False | ||
| LastActivityDate | Date | False | ||
| LeadSource | String | False | ||
| Name | String | False | ||
| NextStep | String | False | ||
| Probability | Int | False | ||
| Quantity | Double | False | ||
| Stage | String | False | ||
| Type | String | False |
Query Opportunity Roles in Marketo.
Note: This table is only available for Marketo subscriptions which do not have a native CRM sync enabled.
Note: A server-side filter must be specified to query this table. Queries with the 'OR' operator are not supported.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
Tip: This table uses server-side projection. Performance can be improved by minimizing the number of columns in projection.
SELECT * FROM OpportunityRoles WHERE externalOpportunityId='test2'
SELECT * FROM OpportunityRoles WHERE ExternalOpportunityId IN ('[email protected]', '[email protected]')
This table supports BATCH INSERT when UseBulkAPI is set to false.
INSERT INTO OpportunityRoles (ExternalOpportunityId, LeadId, IsPrimary, Role) VALUES ('testOpportunitiesInsert', '12', false, 'Test')
This table supports BATCH UPDATE when UseBulkAPI is set to false.
UPDATE OpportunityRoles SET IsPrimary=true WHERE MarketoGUID='c92c78dd-b869-40dc-bb2b-7cba112e8f50'
UPDATE OpportunityRoles SET IsPrimary=false WHERE ExternalOpportunityId='testOpportunitiesInsert'
UPDATE OpportunityRoles SET IsPrimary=false WHERE ExternalOpportunityId='testOpportunitiesInsert001' AND LeadId=12 AND Role='Test1'
This table supports BATCH UPSERT when UseBulkAPI is set to false.
UPSERT INTO OpportunityRoles (ExternalOpportunityId, LeadId, IsPrimary, Role) VALUES ('testOpportunitiesInsert001', '4', false, 'Test')
This table supports BATCH DELETE when UseBulkAPI is set to false.
DELETE FROM OpportunityRoles WHERE ExternalOpportunityId='CDATA1'
DELETE FROM OpportunityRoles WHERE LeadId IN (4, 6)
DELETE FROM OpportunityRoles WHERE ExternalOpportunityId='CDATA1' AND LeadId=6 AND Role='MyRole2'
| Name | Type | ReadOnly | Operators | Description |
| CreatedAt | Datetime | True | ||
| MarketoGUID [KEY] | String | True | =,IN | |
| UpdatedAt | Datetime | True | ||
| ExternalCreatedDate | Datetime | False | ||
| ExternalOpportunityId | String | False | =,IN | |
| IsPrimary | Bool | False | ||
| LeadId | Int | False | =,IN | |
| Role | String | False |
Query Program Members in Marketo.
UpdateLeadProgramStatus can be used to update the membership status of a lead.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
Tip: This table uses server-side projection. Performance can be improved by minimizing the number of columns in projection.
Note: The REST API throws an error if you query program members for a program with more than 100'000 members. You can set UseBulkAPI to 'true' or 'auto' to automatically use the BULK API to retrieve the records.
SELECT * FROM ProgramMembers WHERE ProgramId=1001
This table supports BATCH INSERT when UseBulkAPI is set to false.
INSERT INTO ProgramMembers (ProgramId, LeadId, StatusName) VALUES ('1001', 4, 'member')
This table supports BATCH UPDATE when UseBulkAPI is set to false.
UPDATE ProgramMembers SET WebinarURL='wsfldknfs1.com', RegistrationCode='adcff5f12-a7c7-11eb-bcbc-0242ac130001' WHERE LeadId='13' AND ProgramId='1001'
UPDATE ProgramMembers SET WebinarURL='[email protected]/sync' WHERE ProgramId=1001 AND LeadId IN (28, 29, -2)
UPDATE ProgramMembers SET WebinarURL='[email protected]/sync' WHERE ProgramId IN (1001, 1018) AND LeadId IN (12, 14)
This table supports only BULK UPSERT when UseBulkAPI is set to true.
UPSERT INTO OpportunityRoles (ExternalOpportunityId, LeadId, IsPrimary, Role) VALUES ('testOpportunitiesInsert001', '4', false, 'Test')
This table supports BATCH DELETE when UseBulkAPI is set to false.
DELETE FROM ProgramMembers WHERE ProgramId=1001 AND LeadId=21
DELETE FROM ProgramMembers WHERE ProgramId=1001 AND LeadId IN (28, 29, -2)
DELETE FROM ProgramMembers WHERE ProgramId IN (1001, 1018) AND LeadId IN (12, 14, -2)
DELETE FROM ProgramMembers WHERE ProgramId=1001 AND registrationCode='494164'
| Name | Type | ReadOnly | Operators | Description |
| ProgramId [KEY] | Int | False | = |
Id of the program. |
| LeadId [KEY] | Int | False |
Id of the lead. | |
| UpdatedAt | Datetime | True |
Datetime the records was most recently updated. | |
| IsExhausted | Bool | True | ||
| NurtureCadence | String | True | ||
| StatusName | String | False | =,IN | |
| AttendanceLikelihood | Int | True | ||
| CreatedAt | Datetime | True | ||
| MembershipDate | Datetime | True | ||
| Program | String | True | ||
| ReachedSuccess | Bool | True | =,IN | |
| ReachedSuccessDate | Datetime | True | ||
| RegistrationLikelihood | Int | True | ||
| TrackName | String | True | ||
| WaitlistPriority | Int | True | ||
| AcquiredBy | Bool | False | ||
| FlowStep | Int | False | =,IN | |
| RegistrationCode | String | False | ||
| ReiNewCustomField | String | False | =,IN | |
| StatusReason | String | False | ||
| Test99 | Int | False | =,IN | |
| TestCustomObjFd | String | False | =,IN | |
| UTMSource | String | False | =,IN | |
| WebinarUrl | String | False |
Create, update, delete, and query Programs for a Marketo organization.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
SELECT * FROM Programs WHERE Id=6201
SELECT * FROM Programs WHERE Id IN (6201, 6200, 6152, 6117)
SELECT * FROM Programs WHERE Name='duplicateProgramName'
SELECT * FROM Programs WHERE WorkspaceName='test'
SELECT * FROM Programs WHERE FolderId=48
SELECT * FROM Programs WHERE FolderId=48 AND folderType='Folder'
SELECT * FROM Programs WHERE UpdatedAt >' 2023-03-28T00:19:32.000-04:00'
SELECT * FROM Programs WHERE UpdatedA >=' 2023-03-28T00:19:32.000-04:00'
SELECT * FROM Programs WHERE UpdatedAt =' 2023-03-28T00:19:32.000-04:00'
SELECT * FROM Programs WHERE UpdatedAt <=' 2023-03-28T00:19:32.000-04:00' AND UpdatedAt>'2021-08-11T08:10:01.000Z'
SELECT * FROM Programs WHERE UpdatedAt < '2023-03-28T00:19:32.000-04:00' AND UpdatedAt>'2021-08-11T08:10:01.000Z'
INSERT INTO Programs (Name, FolderId, FolderType, Type, Description, Channel)
VALUES ('test insert program', '6152', 'Program', 'Event', 'Test Insert Description', 'Tradeshow')
UPDATE Programs SET Name='UpdatedProgram', Description='Updated Description' WHERE Id=6224
DELETE FROM Programs WHERE Id=2383
DELETE FROM Programs WHERE Name='Sample0034'
DELETE FROM Programs WHERE ID IN (1064, 1065, 1066, 1067)
DELETE FROM Programs WHERE Name IN ('Sample0035', 'Sample0036', 'Sample0037')
| Name | Type | ReadOnly | Operators | Description |
| Id [KEY] | Int | True | =,IN |
The unique, Marketo-assigned identifier of the program. |
| Name | String | False | = |
The name of the program. |
| Description | String | False |
The description of the program. | |
| Type | String | False |
The program type. | |
| Channel | String | False |
The channel the program is associated with. | |
| WorkspaceName | String | True | =,IN |
The name of the workspace where the program is located. |
| URL | String | True |
The URL reference to the program. | |
| Status | String | True |
The status of the program. | |
| FolderId | Int | False | =,IN |
The unique, Marketo-assigned identifier of the parent folder/program. |
| FolderName | String | True |
The name of the folder | |
| FolderType | String | False | = |
The type of folder (Folder,Program) |
| CreatedAt | Datetime | True |
Datetime the channel was created. | |
| UpdatedAt | Datetime | True | =,>,<,>=,<= |
Datetime the channel was most recently updated. |
Query Sales Persons in Marketo.
Note: This table is only available for Marketo subscriptions which do not have a native CRM sync enabled.
Note: A server-side filter must be specified to query this table. Queries with the 'OR' operator are not supported.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
Tip: This table uses server-side projection. Performance can be improved by minimizing the number of columns in projection.
SELECT * FROM SalesPersons WHERE ExternalSalesPersonId='test SalesPerson'
SELECT * FROM SalesPersons WHERE Id=2520998
SELECT * FROM SalesPersons WHERE Email='[email protected]'
SELECT * FROM SalesPersons WHERE Email IN ('[email protected]', '[email protected]')
This table supports BATCH INSERT when UseBulkAPI is set to false.
INSERT INTO SalesPersons (ExternalSalesPersonId, Email, FirstName, LastName) VALUES ('testInsertSalesPersons001', '[email protected]', 'Sales', 'Person')
This table supports BATCH UPDATE when UseBulkAPI is set to false.
UPDATE SalesPersons SET Phone='800-123-4567', Title='Technical Sales', Email='[email protected]' WHERE ExternalSalesPersonId='testInsertSalesPersons001'
This table supports BATCH UPSERT when UseBulkAPI is set to false.
UPSERT INTO SalesPersons (ExternalSalesPersonId, Email, FirstName, LastName) VALUES ('testInsertSalesPersons123', '[email protected]', 'Sales', 'Person')
This table supports BATCH DELETE when UseBulkAPI is set to false.
DELETE FROM SalesPersons WHERE ExternalSalesPersonId='[email protected]'
DELETE FROM SalesPersons WHERE ID='2521702'
DELETE FROM SalesPersons WHERE ID IN (2521703, 2521704)
DELETE FROM SalesPersons WHERE Email='[email protected]'
DELETE FROM SalesPersons WHERE Email IN ('[email protected]', '[email protected]')
| Name | Type | ReadOnly | Operators | Description |
| Id [KEY] | Int | True | =,IN | |
| ExternalSalesPersonId | String | True | =,IN | |
| String | False | =,IN | ||
| Fax | String | False | ||
| FirstName | String | False | ||
| LastName | String | False | ||
| MobilePhone | String | False | ||
| Phone | String | False | ||
| Title | String | False | ||
| CreatedAt | Datetime | True | ||
| UpdatedAt | Datetime | True |
Query Smart Campaigns for a Marketo organization.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
SELECT * FROM SmartCampaigns WHERE IsActive='False'
SELECT * FROM SmartCampaigns WHERE FolderId=5318 AND FolderType='Folder' AND IsActive='true'
SELECT * FROM SmartCampaigns WHERE UpdatedAt >'2024-01-17T19:19:51Z'
SELECT * FROM SmartCampaigns WHERE UpdatedAt >='2024-01-17T19:19:51Z'
SELECT * FROM SmartCampaigns WHERE UpdatedAt <'2024-01-17T19:19:51Z'
SELECT * FROM SmartCampaigns WHERE UpdatedAt <='2024-01-17T19:19:51Z'
SELECT * FROM SmartCampaigns WHERE UpdatedAt = '2024-01-17T19:19:51Z'
INSERT INTO SmartCampaigns (Name, FolderId, FolderType, Description)
VALUES ('test insert smart campaign', '6152', 'Program', 'Test Insert Description')
UPDATE SmartCampaigns Set Name = 'UpdatedSmartCampaignName', Description = 'CData Campaign' WHERE Id = 1109
DELETE FROM SmartCampaigns WHERE Id=1106
DELETE FROM SmartCampaigns WHERE Name='JET - Test email link reports'
DELETE FROM SmartCampaigns WHERE ID IN (1043, 5318)
DELETE FROM SmartCampaigns WHERE Name IN ('TestCampaign1', 'RCM Success Only (v1) Known --> Engaged', 'Update Segmentation [1001](1001)')
| Name | Type | ReadOnly | Operators | Description |
| Id [KEY] | Int | True | = |
Id of the smart campaign. |
| ParentProgramId | Int | True |
The id of the parent program. Present if smart campaign is under program or nested folder | |
| Name | String | False |
Name of the smart campaign. | |
| Description | String | False |
Description of the smart campaign. | |
| Type | String | True |
The type of the the smart campaign. Batch: has at least one filter and no triggers. Trigger: has at least one trigger. Default: has no smart list rules. | |
| ComputedUrl | String | True |
The Computed Url of the Smart Campaign | |
| Status | String | True |
The status of the smart campaign. | |
| IsSystem | Bool | True |
Whether smart campaign is system managed. | |
| IsActive | Bool | True | = |
Whether smart campaign is active. |
| IsRequestable | Bool | True |
Whether smart campaign is requestable (is active and contains 'Campaign is Requested' trigger with Source of 'Web Service API'). | |
| IsCommunicationLimitEnabled | Bool | True |
Whether smart campaign communication limit is enabled (i.e. block non-operational emails). | |
| MaxMembers | Int | True |
The smart campaign membership limit. | |
| SmartListId | Int | True |
The Id of the smart campaign's child smart list. | |
| FlowId | Int | True |
The Id of the smart campaign's child flow. | |
| FolderId | Int | False | = |
The unique, Marketo-assigned identifier of the parent folder/program. |
| FolderType | String | False | = |
The type of folder (Folder,Program) |
| WorkspaceName | String | True |
Name of the workspace the smart campaign is part of. | |
| QualificationRuleType | String | True |
The type of qualification rule. | |
| QualificationRuleInterval | Int | True |
The interval of qualification rule. Only set when qualificationRuleType is 'interval' | |
| QualificationRuleUnit | String | True |
The unit of measure of qualification rule. Only set when qualificationRuleType is 'interval' = ['hour', 'day', 'week', 'month'] | |
| RecurrenceStartAt | Datetime | True |
The datetime of the first scheduled campaign to run. Required if setting recurrence. Not required to create a smart campaign that has no recurrence. | |
| RecurrenceEndAt | Datetime | True |
The datetime after which no further runs will be automatically scheduled. | |
| RecurrenceIntervalType | String | True |
The recurrence interval. Not required to create a smart campaign that has no recurrence = ['Daily', 'Weekly', 'Monthly']. | |
| RecurrenceInterval | Int | True |
The number of interval units between recurrences. | |
| RecurrenceWeekDayOnly | Bool | True |
Only run smart campaign on weekdays. May only be set if intervalType is 'Daily'. | |
| RecurrenceWeekDayMask | String | True |
String array of empty or one or more of 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday', 'Sunday'. May only be set if intervalType is 'Weekly'. | |
| RecurrenceDayOfMonth | Int | True |
The day of the month to recur. Permissible range 1-31. May only be set if intervalType is 'Monthly' and dayOfWeek and weekOfMonth are unset. | |
| RecurrenceDayOfWeek | String | True |
The day of the week to recur. May only be set if dayOfMonth is not set, and weekOfMonth is set = ['Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday', 'Sunday']. | |
| RecurrenceWeekOfMonth | Int | True |
The week of the month to recur. Permissible range 1-4. May only be set if dayOfMonth is not set, and dayOfWeek is set. | |
| CreatedAt | Datetime | True |
Datetime the smart campaign was created. | |
| UpdatedAt | Datetime | True | =,>,<,>=,<= |
Datetime the smart campaign was most recently updated. |
Query Smart Lists for a Marketo organization.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
SELECT * FROM SmartLists WHERE Id='1093'
SELECT * FROM SmartLists WHERE Name='LeadSmartListTest'
SELECT * FROM SmartLists WHERE FolderId=7
SELECT * FROM SmartLists WHERE ProgramId=6116
SELECT * FROM SmartLists WHERE SmartCampaignId=1043
SELECT * FROM SmartLists WHERE UpdatedAt = '2021-02-02T08:26:01Z'
SELECT * FROM SmartLists WHERE UpdatedAt > '2021-02-02T08:26:01Z'
SELECT * FROM SmartLists WHERE UpdatedAt >= '2021-02-02T08:26:01Z'
SELECT * FROM SmartLists WHERE UpdatedAt <' 2022-06-08T06:17:24Z'
SELECT * FROM SmartLists WHERE UpdatedAt <=' 2022-06-08T06:17:24Z'
DELETE FROM SmartLists WHERE Id=3991
DELETE FROM SmartLists WHERE ID IN (3560, 1266, 3999)
DELETE FROM SmartLists WHERE Name='TestProgram Opportunities'
DELETE FROM SmartLists WHERE Name IN ('test_from_ui', 'JET - email tests')
| Name | Type | ReadOnly | Operators | Description |
| Id [KEY] | Int | False | = |
Id of the smart list. |
| Name | String | False | = |
Name of the smart list. |
| Description | String | False |
Description of the smart list. | |
| URL | String | False |
The URL of the smart list in the Marketo UI | |
| WorkspaceName | String | False |
Name of the workspace the smart list is part of. | |
| FolderId | Int | False | = |
The unique, Marketo-assigned identifier of the parent folder/program. |
| FolderType | String | False | = |
The type of folder (Folder,Program) |
| CreatedAt | Datetime | False |
Datetime the smart list was created. | |
| UpdatedAt | Datetime | False | =,>,<,>=,<= |
Datetime the smart list was most recently updated. |
| SmartCampaignId | Int | False | = |
Mirror column that can be used only as a filter. Will retrieve SmartLists related to the given SmartCampaignId. |
| ProgramId | Int | False | = |
Mirror column that can be used only as a filter. Will retrieve SmartLists related to the given email ProgramId. |
Create, update, delete and query snippets for a Marketo organization.
GetSnippetContent can be used to get the content of a snippet.
UpdateSnippetContent can be used to update the content of a snippet.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
SELECT * FROM Snippets WHERE status='approved'
SELECT * FROM Snippets WHERE Id='9'
SELECT * FROM Snippets WHERE Id='9' AND Status='approved'
INSERT INTO Snippets (Name, FolderId, FolderType, Description)
VALUES ('test insert smart snippet', '31', 'Folder', 'Test Insert Description')
UPDATE Snippets SET Description='Testing Update', IsArchive='true', Name='Test Update' WHERE Id=12
DELETE FROM Snippets WHERE Id=7
DELETE FROM Snippets WHERE Name='My Snippet2'
DELETE FROM Snippets WHERE ID IN (1, 9, 111)
DELETE FROM Snippets WHERE Name IN ('My Snippet1', 'My Snippet11')
| Name | Type | ReadOnly | Operators | Description |
| Id [KEY] | Int | True | = |
The unique, Marketo-assigned identifier of the snippet. |
| Status [KEY] | String | True | = |
Status filter for draft or approved versions. |
| Name | String | False |
The name of the snippet. | |
| Description | String | False |
The description of the snippet. | |
| URL | String | True |
The URL of the snippet in the Marketo UI. | |
| WorkspaceName | String | True |
Workspace name of the asset. | |
| FolderId | Int | False | = |
The unique, Marketo-assigned identifier of the parent folder/program. |
| FolderName | String | True |
The name of the folder | |
| FolderType | String | False | = |
The type of folder (Folder,Program) |
| CreatedAt | Datetime | True |
Datetime the snippet was created. | |
| UpdatedAt | Datetime | True |
Datetime the snippet was most recently updated. |
Query relations of static lists and leads in Marketo.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
SELECT * FROM StaticListMembership WHERE ListId='1014'
SELECT * FROM StaticListMembership WHERE LeadId='4'
Other queries partialy server-side:
SELECT * FROM StaticListMembership WHERE ListId IN (1014, 1044, 1057)
SELECT * FROM StaticListMembership WHERE LeadId IN (4, 9999, 1199433)
SELECT * FROM StaticListMembership WHERE ListId=1014 AND LeadId=1199433
SELECT * FROM StaticListMembership WHERE ListId=1014 AND LeadId IN (4, 9999, 1199433, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10)
This table supports BATCH INSERT when UseBulkAPI is set to false.
INSERT INTO StaticListMemberShip (ListId, LeadId) VALUES (1014, 4)
INSERT INTO StaticListMemberShip (ListId, LeadId) VALUES (1014, 4), (1014, 8), (1014, 12), (1014, 21)
INSERT INTO StaticListMemberShip (ListId, LeadId) VALUES (1014, 4), (1014, 8), (1014, 12), (1014, 21), (1349, 4), (1349, 8), (1062, 8), (1349, 21), (1349, 22)
This table supports BATCH DELETE when UseBulkAPI is set to false.
DELETE FROM StaticListMembership WHERE ListId=1057 AND LeadId=1083278
DELETE FROM StaticListMembership WHERE ListId=1057 AND LeadId IN (1083292, 1083293, 1199432)
DELETE FROM StaticListMembership WHERE ListId=1057
DELETE FROM StaticListMembership WHERE LeadId=9999
DELETE FROM StaticListMembership WHERE ListId IN (1057, 1568) AND LeadId IN (1083292, 1083293, 1199432, 1199433, 2521698)
DELETE FROM StaticListMembership WHERE LeadId IN (1083292, 1083293, 1199432, 1199433, 2521698, 4, 5, 6, 7, 8, 9, 10)
| Name | Type | ReadOnly | Operators | Description |
| ListId [KEY] | Int | False | = |
Id of the static list. |
| LeadId [KEY] | Int | False | = |
Id of the Lead. |
Query Static Lists for a Marketo organization.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
SELECT * FROM StaticLists WHERE Id='1556'
SELECT * FROM StaticLists WHERE Name='Anti-Smart List'
SELECT * FROM StaticLists WHERE FolderId='12'
SELECT * FROM StaticLists WHERE FolderType='Folder'
SELECT * FROM StaticLists WHERE FolderId='6113' AND FolderType='Program'
SELECT * FROM StaticLists WHERE UpdatedAt = '2024-01-17T14:31:26.000'
SELECT * FROM StaticLists WHERE UpdatedAt > '2023-06-07T08:00:01.000'
SELECT * FROM StaticLists WHERE UpdatedAt >= '2023-06-07T08:00:01.000'
SELECT * FROM StaticLists WHERE UpdatedAt < '2023-06-07T08:00:01.000'
SELECT * FROM StaticLists WHERE UpdatedAt <= '2023-06-07T08:00:01.000'
SELECT * FROM StaticLists WHERE UpdatedAt >= '2022-09-01T14:08:37.000' AND UpdatedAt < '2023-10-06T10:43:02.000'
INSERT INTO StaticLists (Name, FolderId, FolderType, Description) VALUES ('test insert StaticLists', '6152', 'Program', 'Test Insert Description')
UPDATE StaticLists Set Name = 'UpdatedStaticList', Description = 'CData StaticList' WHERE Id = 1570
DELETE FROM StaticLists WHERE Id=1561
DELETE FROM StaticLists WHERE Name='test'
DELETE FROM StaticLists WHERE ID IN (1563, 1564, 1565, 111)
DELETE FROM StaticLists WHERE Name IN ('test46AU1gBBg1', 'asd', 'testsDxzV3BAqn')
| Name | Type | ReadOnly | Operators | Description |
| Id [KEY] | Int | True | = |
Id of the static list. |
| Name | String | False | = |
Name of the static list. |
| Description | String | False |
Description of the static list. | |
| ComputedURL | String | True |
Computed URL of static list. | |
| WorkspaceName | String | True |
Name of the workspace the static list is part of. | |
| FolderId | Int | False | = |
The unique, Marketo-assigned identifier of the parent folder/program. |
| FolderName | String | True |
The name of the folder | |
| FolderType | String | False | = |
The type of folder (Folder,Program) |
| CreatedAt | Datetime | True |
Datetime the static list was created. | |
| UpdatedAt | Datetime | True | =,>,<,>=,<= |
Datetime the static list was most recently updated. |
Create, delete, and query Tokens for a Marketo organization.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
SELECT * FROM Tokens WHERE folderId=70
SELECT * FROM Tokens WHERE folderId=70 and FolderType='Folder'
INSERT INTO Tokens (Name, Type, Value, FolderId, FolderType) VALUES ('test insert token', 'text', 'test token value', 5365, 'Folder')
DELETE FROM Tokens WHERE FolderId=1111 AND FolderType='Program' AND Name='testname2' AND Type='text'
DELETE FROM Tokens WHERE FolderId=1112 AND FolderType='Program' AND Name='test'
DELETE FROM Tokens WHERE FolderId=1112
| Name | Type | ReadOnly | Operators | Description |
| Name [KEY] | String | False |
The name of the Token. | |
| Type [KEY] | String | False |
The data type of the Token. The supported values are date, number, rich text, score, sfdc campaign and text | |
| Value | String | False |
The value of the Token. | |
| ComputedURL | String | False |
The Computed URL of the Token. | |
| FolderId [KEY] | Int | False | = |
The unique, Marketo-assigned identifier of the parent folder/program. |
| FolderType [KEY] | String | False | = |
The type of folder (Folder,Program) |
Query users for a Marketo organization.
Note: Insert queries are not supported. Users can be invited using the InviteUser stored procedure. Invited users can be retrieved using the GetInvitedUserById stored procedure. Invited users can be deleted using the DeleteInvitedUser stored procedure.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
For example, the following queries are processed server-side:
SELECT * FROM Users WHERE UserId='[email protected]'
UPDATE USERS SET EmailAddress='[email protected]', FirstName='updated', LastName='updated', ExpiresAt='2024-12-12T00:00:00-01:00' WHERE UserId='[email protected]'
DELETE FROM USERS WHERE UserId='[email protected]'
| Name | Type | ReadOnly | Operators | Description |
| UserId [KEY] | String | True | = |
The user id in the form of an email address. |
| Id | Integer | True |
The user identifier. | |
| EmailAddress | String | False |
The user's email address. | |
| FirstName | String | False |
The user's first name. | |
| LastName | String | False |
The user's last name. | |
| APIOnly | Boolean | True |
Whether the user is API-Only. | |
| ExpiresAt | Datetime | False |
The date and time when the user login expires. | |
| LastLoginAt | Datetime | True |
The date and time of user's most recent login. | |
| FailedLogins | Integer | True |
Count of user login failures. | |
| FailedDeviceCode | Integer | True |
Device code for user login failure. | |
| IsLocked | Boolean | True |
Whether the user account is locked. | |
| LockedReason | String | True |
Reason that user account is locked. | |
| OptedIn | Boolean | True |
Whether user has opted in. | |
| UserWorkspaceRoles | String | True |
Array of user roles and workspaces. |
Query user roles for each workspace in Marketo.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
For example, the following query is processed server-side:
SELECT * FROM UserWorkspaceRoles WHERE UserId='[email protected]'
INSERT INTO UserWorkspaceRoles (UserId, WorkspaceId, AccessRoleId) VALUES ('[email protected]', 0, 1002)
DELETE FROM UserWorkspaceRoles WHERE UserId='[email protected]' AND AccessRoleId=1002 AND WorkspaceId=0;
| Name | Type | ReadOnly | Operators | Description |
| UserId [KEY] | String | False | = |
The user id in the form of an email address. |
| AccessRoleId [KEY] | Integer | False |
The user role id. | |
| AccessRoleName | String | False |
The user role name. | |
| WorkspaceId [KEY] | Integer | False |
The workspace id. | |
| WorkspaceName | String | False |
The workspace name. |
ビューは、データを示すという点でテーブルに似ていますが、ビューは読み取り専用です。
クエリは、ビューに対して通常のテーブルと同様に実行することができます。
| Name | Description |
| Activities | Retrieve activities of different types after a specific datetime. |
| Activities_AddtoList | Add a person/record to a list |
| Activities_AddtoNurture | Add a lead to a nurture program |
| Activities_AddtoOpportunity | Add to an Opportunity |
| Activities_Asksquestionsinwebinar | Lead asks questions in a webinar event |
| Activities_Assetdownloadsinwebinar | Lead downloads file/asset in a webinar event |
| Activities_Calltoactionclickedinwebinar | Lead clicks on a Call to Action Link in a webinar event |
| Activities_CallWebhook | Call a Webhook |
| Activities_ChangeDataValue | Changed attribute value for a person/record |
| Activities_ChangeLeadPartition | Lead partition is changed for a lead |
| Activities_ChangeNurtureCadence | Change the nurture cadence for a lead |
| Activities_ChangeNurtureTrack | Change the nurture track for a lead |
| Activities_ChangeProgramMemberData | Change Program Member Data |
| Activities_ChangeRevenueStage | Modify the value of a revenue stage field |
| Activities_ChangeRevenueStageManually | Revenue stage is changed manually (e.g. Lead Database or Salesforce) |
| Activities_ChangeScore | Modify the value of a score field |
| Activities_ChangeSegment | Change segment (within a segmentation) for a lead |
| Activities_ChangeStatusinProgression | Change a Status in an program progression |
| Activities_ClickEmail | User clicks on a link in a Marketo Email |
| Activities_ClickLink | User clicks link on a page |
| Activities_ClickSalesEmail | User clicks on a link in a sales Email |
| Activities_CreateBuyingGroup | Create Buying Group |
| Activities_DeleteLead | Delete lead from Marketo database |
| Activities_EmailBounced | Marketo Email is bounced for a lead |
| Activities_EmailBouncedSoft | Campaign Email is bounced soft for a lead |
| Activities_EmailDelivered | Marketo Email is delivered to a lead/contact |
| Activities_EngagedwithaConversationalFlow | Lead engages with Dynamic Chat conversational flow |
| Activities_EngagedwithaDialogue | Lead engages with Dynamic Chat dialogue |
| Activities_EngagedwithanAgentinConversationalFlow | Lead engages with an Agent in Dynamic Chat conversational flow |
| Activities_EngagedwithanAgentinDialogue | Lead engages with an Agent in Dynamic Chat dialogue |
| Activities_ExecuteCampaign | Invoke an executable campaign |
| Activities_FillOutForm | User fills out and submits a form on web page |
| Activities_Hasattendedevent | Has attended event |
| Activities_InteractedwithDocumentinConversationalFlow | Lead interacts with a document in Dynamic Chat conversational flow |
| Activities_InteractedwithDocumentinDialogue | Lead interacts with a document in Dynamic Chat dialogue |
| Activities_MergeLeads | Merge two or more leads into a single record |
| Activities_NewLead | New person/record is added to the lead database |
| Activities_OpenEmail | User opens Marketo Email |
| Activities_OpenSalesEmail | User opens a sales Email |
| Activities_PushLeadtoMarketo | Generated schema file. |
| Activities_ReachedConversationalFlowGoal | Lead reaches a goal in Dynamic Chat conversational flow |
| Activities_ReachedDialogueGoal | Lead reaches a goal in Dynamic Chat dialogue |
| Activities_ReceivedForwardtoFriendEmail | User receives forwarded Email from friend |
| Activities_ReceiveSalesEmail | Receive Email using Sales View (Outlook Plugin) |
| Activities_RemovefromList | Remove this lead from a list |
| Activities_RemovefromOpportunity | Remove from an Opportunity |
| Activities_ReplytoSalesEmail | User replies to a sales email |
| Activities_RequestCampaign | Campaign membership is requested for lead |
| Activities_Respondedtoapollinwebinar | Lead responds to a poll in a webinar event |
| Activities_SalesEmailBounced | Sales Email bounced |
| Activities_ScheduledMeetinginConversationalFlow | Lead schedules an appointment in Dynamic Chat conversational flow |
| Activities_ScheduledMeetinginDialogue | Lead schedules an appointment in Dynamic Chat dialogue |
| Activities_SendAlert | Send alert Email about a lead |
| Activities_SendEmail | Send Marketo Email to a person |
| Activities_SendSalesEmail | Send Email using Sales View (Outlook Plugin) |
| Activities_SentForwardtoFriendEmail | User Forwards Email to a person/record |
| Activities_ShareContent | Share Content |
| Activities_UnsubscribeEmail | Person unsubscribed from Marketo Emails |
| Activities_UpdateOpportunity | Update an Opportunity |
| Activities_VisitWebpage | User visits a web page |
| ActivityTypes | Get available activity types. |
| ActivityTypesAttributes | Get available activity type attributes. |
| BulkExportJobs | Returns a list of bulk export jobs that were created in the past 7 days. |
| Campaigns | Query Campaigns for a Marketo organization. |
| ChannelProgressionStatuses | Query ProgressionStatuses of Channels for a Marketo organization. |
| Channels | Query Channels for a Marketo organization. |
| DailyErrorStatistics | Retrieve the count of each error users have encountered in the current day. |
| DailyUsageStatistics | Retrieve the number of API calls that specific users have consumed in the current day. |
| EmailCCFields | Query Emails CC Fields for a Marketo organization. |
| EmailTemplatesUsedBy | Query email records which depend on a given email template. |
| Files | Query files for a Marketo organization. |
| FolderContents | Query Folders contents for a Marketo organization. |
| LandingPageTemplateContent | Query landing page template contents for a Marketo organization. |
| LeadChanges | Query Lead changes. |
| LeadChangesAttributes | Query Lead changes attributes. |
| LeadChangesFields | Query fields of lead changes. |
| LeadPartitions | Query Lead Partitions for a Marketo organization. |
| LeadPrograms | Query program membership for leads. |
| Lists | Query Static Lists for a Marketo organization from the Leads API. |
| ListStaticMemberShip | Query leads of a static list in Marketo. |
| ProgramCosts | Query, insert and delete program cost relations for a Marketo organization. |
| ProgramTags | Query tags relations for a Marketo organization. |
| Roles | Query roles. Requires permissions: 'Access User Management Api' and 'Access Users'. |
| Segmentations | Query segmentations for a Marketo organization. |
| Segments | Query segments for a Marketo organization. |
| SmartListFilterConditions | Query filters of smart lists in a Marketo organization. |
| SmartListFilters | Query filters of smart lists in a Marketo organization. |
| SmartListTriggers | Query rules of smart lists in a Marketo organization. |
| TagAllowedValues | Query allowed values for tags in a Marketo organization. |
| Tags | Query tags for a Marketo organization. |
| ThankYouList | Query form thank you pages for a Marketo organization. |
| WeeklyErrorStatistics | Retrieve the count of each error users have encountered in the past 7 days. |
| WeeklyUsageStatistics | Retrieve the number of API calls that specific users have consumed in the past 7 days. |
| Workspaces | Retrieve workspaces. Requires permissions: 'Access User Management Api' and 'Access Users'. |
Retrieve activities of different types after a specific datetime.
Each activity type in your Marketo organization is returned as a separate table. Each table name is prefixed with 'Activities_' followed by the name of the activity type. Activities are pushed as views. Custom activities are pushed as tables CustomActivities
All activites tables support BULK SELECT when UseBulkAPI is set to true.
By default this view retrieves all activity types from the creation of Marketo.
It is advised to provide a filter for ActivityTypeId and ActivityDate or to instead make use of tables such as Activities_AddtoList, Activities_AddtoNurture, Activities_AddtoOpportunity, etc. which are linked to a specific activity type.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
SELECT * FROM Activities WHERE ActivityDate > '2024-01-01T00:00:00Z'
SELECT * FROM Activities WHERE ActivityDate >= ' 2024-01-01T00:00:00Z' AND ActivityDate <= '2024-03-01T00:00:00Z'
SELECT * FROM Activities WHERE ListId = '1014' AND ActivityDate > '2024-01-01T00:00:00Z'
SELECT * FROM Activities WHERE ListId = '1014' AND ActivityTypeId = '13'
SELECT * FROM Activities WHERE ListId = '1014' AND ActivityTypeId = '13' AND ActivityDate > ' 2024-01-01T00:00:00Z'
SELECT * FROM Activities WHERE ActivityTypeId = 24
SELECT * FROM Activities WHERE ActivityTypeId IN (1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 13)
| Name | Type | Operators | Description |
| MarketoGUID [KEY] | String | Unique id of the activity. | |
| Id | String | Integer id of the activity. This value could exceed Int.MAX. For instances which have been migrated to Activity Service, this field may not be present, and should not be treated as unique. | |
| ActivityDateTime | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| ActivityTypeId | Int | =,IN | Id of the activity type. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| PrimaryAttributeValueId | Int | Id of the primary attribute field. | |
| PrimaryAttributeValue | String | Value of the primary attribute. | |
| Attributes | String | JSON aggregate containing the list of attribute key value pair for this activity. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
Add a person/record to a list
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListID | Int | = | |
| ListIDValue | String | ||
| Source | String |
Add a lead to a nurture program
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| ProgramID | Int | ||
| ProgramIDValue | String | ||
| TrackID | Int | ||
| TrackName | String |
Add to an Opportunity
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| OpptyID | Int | ||
| OpptyIDValue | String | ||
| IsPrimary | Bool | ||
| Role | String |
Lead asks questions in a webinar event
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| ProgramID | Int | ||
| ProgramIDValue | String | ||
| Question | String | ||
| Questionwasanswered | Bool |
Lead downloads file/asset in a webinar event
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| ProgramID | Int | ||
| ProgramIDValue | String | ||
| Downloadedasset | String |
Lead clicks on a Call to Action Link in a webinar event
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| ProgramID | Int | ||
| ProgramIDValue | String | ||
| Linkclicked | String |
Call a Webhook
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| Webhook | Int | ||
| WebhookValue | String | ||
| ErrorType | Int | ||
| Response | String |
Changed attribute value for a person/record
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| AttributeName | Int | ||
| AttributeNameValue | String | ||
| NewValue | String | ||
| OldValue | String | ||
| Reason | String | ||
| Source | String | ||
| APIMethodName | String | ||
| ModifyingUser | String | ||
| RequestId | String |
Lead partition is changed for a lead
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| NewPartitionID | Int | ||
| NewPartitionIDValue | String | ||
| OldPartitionID | Int | ||
| Reason | String |
Change the nurture cadence for a lead
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| ProgramID | Int | ||
| ProgramIDValue | String | ||
| NewNurtureCadence | String | ||
| PreviousNurtureCadence | String |
Change the nurture track for a lead
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| ProgramID | Int | ||
| ProgramIDValue | String | ||
| NewTrackID | Int | ||
| PreviousTrackID | Int | ||
| TrackName | String | ||
| PreviousTrackName | String |
Change Program Member Data
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| ProgramID | Int | ||
| ProgramIDValue | String | ||
| AttributeName | Int | ||
| NewValue | String | ||
| OldValue | String | ||
| Reason | String | ||
| Source | String | ||
| AttributeDisplayName | String |
Modify the value of a revenue stage field
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| ModelID | Int | ||
| ModelIDValue | String | ||
| NewStageID | Int | ||
| OldStageID | Int | ||
| SLAExpiration | Datetime | ||
| Reason | String | ||
| NewStage | String | ||
| OldStage | String |
Revenue stage is changed manually (e.g. Lead Database or Salesforce)
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| PrimaryAttributeValueId | Int | Id of the primary attribute field. | |
| PrimaryAttributeValue | String | Value of the primary attribute. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
Modify the value of a score field
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| ScoreName | Int | ||
| ScoreNameValue | String | ||
| ChangeValue | String | ||
| NewValue | Int | ||
| OldValue | Int | ||
| Reason | String |
Change segment (within a segmentation) for a lead
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| SegmentationID | Int | ||
| SegmentationIDValue | String | ||
| NewSegmentID | Int |
Change a Status in an program progression
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| ProgramID | Int | ||
| ProgramIDValue | String | ||
| NewStatusID | Int | ||
| OldStatusID | Int | ||
| Reason | String | ||
| AcquiredBy | Bool | ||
| Success | Bool | ||
| ProgramMemberID | Int | ||
| ReachedSuccessDate | Datetime | ||
| StatusReason | String | ||
| WebinarURL | String | ||
| RegistrationCode | String | ||
| NewStatus | String | ||
| OldStatus | String |
User clicks on a link in a Marketo Email
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| MailingID | Int | ||
| MailingIDValue | String | ||
| StepID | Int | ||
| ChoiceNumber | Int | ||
| Link | String | ||
| TestVariant | Int | ||
| LinkID | String | ||
| IsMobileDevice | Bool | ||
| Device | String | ||
| Platform | String | ||
| UserAgent | String | ||
| CampaignRunID | Int | ||
| IsPredictive | Bool | ||
| IsBotActivity | Bool | ||
| BotActivityPattern | String | ||
| Browser | String |
User clicks link on a page
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| LinkID | Int | ||
| LinkIDValue | String | ||
| WebpageID | Int | ||
| QueryParameters | String | ||
| ClientIPAddress | String | ||
| ReferrerURL | String | ||
| UserAgent | String | ||
| Browser | String | ||
| Platform | String | ||
| Device | String |
User clicks on a link in a sales Email
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| ArtifactID | Int | ||
| ArtifactIDValue | String | ||
| Sentby | String | ||
| Link | String | ||
| TemplateID | Int | ||
| CampaignRunID | Int | ||
| IsPredictive | Bool | ||
| Source | String | ||
| SalesTemplateURL | String | ||
| SalesCampaignURL | String | ||
| SalesTemplateName | String | ||
| SalesCampaignName | String | ||
| MarketoSalesPersonID | Int | ||
| SalesEmailURL | String | ||
| IsBotActivity | Bool | ||
| BotActivityPattern | String |
Create Buying Group
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| PrimaryAttributeValueId | Int | Id of the primary attribute field. | |
| PrimaryAttributeValue | String | Value of the primary attribute. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| BuyingGroupId | Int | ||
| BuyingGroupTemplateId | Int | ||
| SolutionInterestId | Int | ||
| MarketoGUID | Int |
Delete lead from Marketo database
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| LeadIDValue | String | ||
| RemovefromCRM | Bool | ||
| APIMethodName | String | ||
| ModifyingUser | String | ||
| RequestId | String |
Marketo Email is bounced for a lead
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| MailingID | Int | ||
| MailingIDValue | String | ||
| StepID | Int | ||
| ChoiceNumber | Int | ||
| Category | String | ||
| Details | String | ||
| Subcategory | String | ||
| String | |||
| TestVariant | Int | ||
| CampaignRunID | Int | ||
| HasPredictive | Bool | ||
| Browser | String | ||
| Platform | String | ||
| Device | String | ||
| UserAgent | String |
Campaign Email is bounced soft for a lead
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| MailingID | Int | ||
| MailingIDValue | String | ||
| StepID | Int | ||
| ChoiceNumber | Int | ||
| Category | String | ||
| Details | String | ||
| Subcategory | String | ||
| String | |||
| TestVariant | Int | ||
| CampaignRunID | Int | ||
| HasPredictive | Bool | ||
| Browser | String | ||
| Platform | String | ||
| Device | String | ||
| UserAgent | String |
Marketo Email is delivered to a lead/contact
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| MailingID | Int | ||
| MailingIDValue | String | ||
| StepID | Int | ||
| ChoiceNumber | Int | ||
| TestVariant | Int | ||
| CampaignRunID | Int | ||
| HasPredictive | Bool | ||
| Browser | String | ||
| Platform | String | ||
| Device | String | ||
| UserAgent | String |
Lead engages with Dynamic Chat conversational flow
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| ConversationalFlowID | Int | ||
| ConversationalFlowIDValue | String | ||
| ConversationalFlowName | String | ||
| PageURL | String | ||
| ConversationStatus | String | ||
| ConversationTranscript | String | ||
| ConversationSummary | String | ||
| SourceType | String | ||
| SourceName | String | ||
| InteractedUIType | String | ||
| Language | String | ||
| Workspace | String | ||
| DiscussedTopics | String | ||
| ConversationScore | Int |
Lead engages with Dynamic Chat dialogue
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| DialogueID | Int | ||
| DialogueIDValue | String | ||
| DialogueName | String | ||
| PageURL | String | ||
| ConversationStatus | String | ||
| ConversationTranscript | String | ||
| ConversationSummary | String | ||
| Language | String | ||
| Workspace | String | ||
| DiscussedTopics | String | ||
| ConversationScore | Int |
Lead engages with an Agent in Dynamic Chat conversational flow
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| ConversationalFlowID | Int | ||
| ConversationalFlowIDValue | String | ||
| ConversationalFlowName | String | ||
| PageURL | String | ||
| AgentID | Int | ||
| AgentEmail | String | ||
| AgentName | String | ||
| RoutingQueueID | Int | ||
| RoutingQueueType | String | ||
| RoutingQueueName | String | ||
| ConversationTranscript | String | ||
| ConversationSummary | String | ||
| ConversationStatus | String | ||
| DiscussedTopics | String | ||
| ConversationScore | Int |
Lead engages with an Agent in Dynamic Chat dialogue
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| DialogueID | Int | ||
| DialogueIDValue | String | ||
| DialogueName | String | ||
| PageURL | String | ||
| AgentID | Int | ||
| AgentEmail | String | ||
| AgentName | String | ||
| RoutingQueueID | Int | ||
| RoutingQueueType | String | ||
| RoutingQueueName | String | ||
| ConversationTranscript | String | ||
| ConversationSummary | String | ||
| ConversationStatus | String | ||
| DiscussedTopics | String | ||
| ConversationScore | Int |
Invoke an executable campaign
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| CampaignIDValue | String | ||
| Qualified | Bool | ||
| UsedParentCampaignTokenContext | Bool | ||
| TokenContextCampaignID | Int |
User fills out and submits a form on web page
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| WebformID | Int | ||
| WebformIDValue | String | ||
| FormFields | String | ||
| WebpageID | Int | ||
| QueryParameters | String | ||
| ClientIPAddress | String | ||
| ReferrerURL | String | ||
| UserAgent | String | ||
| Browser | String | ||
| Platform | String | ||
| Device | String |
Has attended event
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| ProgramID | Int | ||
| ProgramIDValue | String | ||
| Numberofpollresponses | Int | ||
| Numberofansweredquestions | Int | ||
| Numberofunansweredquestions | Int | ||
| Livewatchtimebypercent | Int | ||
| NumberofCTAsclicked | Int | ||
| Numberofassetsdownloaded | Int | ||
| EventMode | String | ||
| Watchdurationinminutes | Int | ||
| WatchedDate | Datetime |
Lead interacts with a document in Dynamic Chat conversational flow
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| DocumentID | Int | ||
| DocumentIDValue | String | ||
| DocumentName | String | ||
| DocumentURL | String | ||
| ConversationalFlowID | Int | ||
| ConversationalFlowName | String | ||
| PageURL | String | ||
| DocumentOpened | Bool | ||
| DocumentDownloaded | Bool | ||
| SearchTerms | String | ||
| Language | String | ||
| Workspace | String |
Lead interacts with a document in Dynamic Chat dialogue
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| DocumentID | Int | ||
| DocumentIDValue | String | ||
| DocumentName | String | ||
| DocumentURL | String | ||
| DialogueID | Int | ||
| DialogueName | String | ||
| PageURL | String | ||
| DocumentOpened | Bool | ||
| DocumentDownloaded | Bool | ||
| SearchTerms | String | ||
| Language | String | ||
| Workspace | String |
Merge two or more leads into a single record
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| LeadIDValue | String | ||
| MergeIDs | String | ||
| MasterUpdated | Bool | ||
| MergedinSales | Bool | ||
| MergeSource | String | ||
| APIMethodName | String | ||
| ModifyingUser | String | ||
| RequestId | String |
New person/record is added to the lead database
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| PrimaryAttributeValueId | Int | Id of the primary attribute field. | |
| PrimaryAttributeValue | String | Value of the primary attribute. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| SourceType | String | ||
| FormName | String | ||
| ListName | String | ||
| SFDCType | String | ||
| LeadSource | String | ||
| CreatedDate | Date | ||
| APIMethodName | String | ||
| ModifyingUser | String | ||
| RequestId | String |
User opens Marketo Email
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| MailingID | Int | ||
| MailingIDValue | String | ||
| StepID | Int | ||
| ChoiceNumber | Int | ||
| TestVariant | Int | ||
| IsMobileDevice | Bool | ||
| Device | String | ||
| Platform | String | ||
| UserAgent | String | ||
| CampaignRunID | Int | ||
| HasPredictive | Bool | ||
| IsBotActivity | Bool | ||
| BotActivityPattern | String | ||
| Browser | String |
User opens a sales Email
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| ArtifactID | Int | ||
| ArtifactIDValue | String | ||
| Sentby | String | ||
| TemplateID | Int | ||
| CampaignRunID | Int | ||
| HasPredictive | Bool | ||
| Source | String | ||
| SalesTemplateURL | String | ||
| SalesCampaignURL | String | ||
| SalesTemplateName | String | ||
| SalesCampaignName | String | ||
| MarketoSalesPersonID | Int | ||
| SalesEmailURL | String | ||
| IsBotActivity | Bool | ||
| BotActivityPattern | String |
Generated schema file.
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| ProgramID | Int | ||
| ProgramIDValue | String | ||
| Source | String | ||
| Reason | String | ||
| APIMethodName | String | ||
| ModifyingUser | String | ||
| RequestId | String |
Lead reaches a goal in Dynamic Chat conversational flow
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| ConversationalFlowID | Int | ||
| ConversationalFlowIDValue | String | ||
| GoalName | String | ||
| ConversationalFlowName | String | ||
| PageURL | String | ||
| Language | String | ||
| Workspace | String |
Lead reaches a goal in Dynamic Chat dialogue
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| DialogueID | Int | ||
| DialogueIDValue | String | ||
| GoalName | String | ||
| PageURL | String | ||
| DialogueName | String | ||
| Language | String | ||
| Workspace | String |
User receives forwarded Email from friend
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| MailingID | Int | ||
| MailingIDValue | String | ||
| StepID | Int | ||
| ChoiceNumber | Int |
Receive Email using Sales View (Outlook Plugin)
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| ArtifactID | Int | ||
| ArtifactIDValue | String | ||
| Receivedby | String | ||
| Source | String |
Remove this lead from a list
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListID | Int | = | |
| ListIDValue | String | ||
| Source | String |
Remove from an Opportunity
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| OpptyID | Int | ||
| OpptyIDValue | String | ||
| IsPrimary | Bool | ||
| Role | String |
User replies to a sales email
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| ArtifactID | Int | ||
| ArtifactIDValue | String | ||
| Sentby | String | ||
| TemplateID | Int | ||
| CampaignRunID | Int | ||
| HasPredictive | Bool | ||
| Source | String | ||
| SalesTemplateURL | String | ||
| SalesCampaignURL | String | ||
| SalesTemplateName | String | ||
| SalesCampaignName | String | ||
| MarketoSalesPersonID | Int | ||
| SalesEmailURL | String |
Campaign membership is requested for lead
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| CampaignIDValue | String | ||
| Source | String |
Lead responds to a poll in a webinar event
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| ProgramID | Int | ||
| ProgramIDValue | String | ||
| Pollquestion | String | ||
| Pollresponse | String |
Sales Email bounced
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| ArtifactID | Int | ||
| ArtifactIDValue | String | ||
| Sentby | String | ||
| Category | String | ||
| Details | String | ||
| Subcategory | String | ||
| String | |||
| CampaignRunID | Int | ||
| HasPredictive | Bool | ||
| TemplateID | Int | ||
| MarketoSalesPersonID | Int | ||
| Source | String |
Lead schedules an appointment in Dynamic Chat conversational flow
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| AgentID | Int | ||
| AgentIDValue | String | ||
| AgentEmail | String | ||
| AgentName | String | ||
| ConversationalFlowID | Int | ||
| ConversationalFlowName | String | ||
| PageURL | String | ||
| MeetingStatus | String | ||
| ScheduledFor | Datetime | ||
| RoutingQueueID | Int | ||
| RoutingQueueType | String | ||
| RoutingQueueName | String |
Lead schedules an appointment in Dynamic Chat dialogue
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| AgentID | Int | ||
| AgentIDValue | String | ||
| AgentEmail | String | ||
| AgentName | String | ||
| DialogueID | Int | ||
| DialogueName | String | ||
| PageURL | String | ||
| MeetingStatus | String | ||
| ScheduledFor | Datetime | ||
| RoutingQueueID | Int | ||
| RoutingQueueType | String | ||
| RoutingQueueName | String |
Send alert Email about a lead
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| MailingID | Int | ||
| MailingIDValue | String | ||
| SendToOwner | String | ||
| SendToSmartList | String | ||
| SendToList | String |
Send Marketo Email to a person
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| MailingID | Int | ||
| MailingIDValue | String | ||
| StepID | Int | ||
| ChoiceNumber | Int | ||
| TestVariant | Int | ||
| CampaignRunID | Int | ||
| HasPredictive | Bool | ||
| Browser | String | ||
| Platform | String | ||
| Device | String | ||
| UserAgent | String |
Send Email using Sales View (Outlook Plugin)
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| ArtifactID | Int | ||
| ArtifactIDValue | String | ||
| Sentby | String | ||
| TemplateID | Int | ||
| CampaignRunID | Int | ||
| HasPredictive | Bool | ||
| Source | String | ||
| SalesTemplateURL | String | ||
| SalesCampaignURL | String | ||
| SalesTemplateName | String | ||
| SalesCampaignName | String | ||
| MarketoSalesPersonID | Int | ||
| SalesEmailURL | String |
User Forwards Email to a person/record
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| MailingID | Int | ||
| MailingIDValue | String | ||
| StepID | Int | ||
| ChoiceNumber | Int |
Person unsubscribed from Marketo Emails
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| MailingID | Int | ||
| MailingIDValue | String | ||
| WebpageID | Int | ||
| QueryParameters | String | ||
| ClientIPAddress | String | ||
| ReferrerURL | String | ||
| UserAgent | String | ||
| WebformID | Int | ||
| FormFields | String | ||
| TestVariant | Int | ||
| CampaignRunID | Int | ||
| HasPredictive | Bool | ||
| Browser | String | ||
| Platform | String | ||
| Device | String |
Update an Opportunity
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| OpptyID | Int | ||
| OpptyIDValue | String | ||
| DataValueChanges | String | ||
| AttributeName | String | ||
| NewValue | String | ||
| OldValue | String |
User visits a web page
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
| WebpageID | Int | ||
| WebpageIDValue | String | ||
| WebpageURL | String | ||
| QueryParameters | String | ||
| ClientIPAddress | String | ||
| ReferrerURL | String | ||
| UserAgent | String | ||
| SearchEngine | String | ||
| SearchQuery | String | ||
| Token | String | ||
| Browser | String | ||
| Platform | String | ||
| Device | String |
Get available activity types.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
SELECT * FROM ActivityTypes WHERE Id=123
| Name | Type | Operators | Description |
| Id [KEY] | Int | The unique, Marketo-assigned identifier of the Activity type. | |
| Name | String | The name of the Activity type. | |
| Description | String | The description of the Activity type. | |
| PrimaryAttributeName | String | The name of the primary attribute. | |
| PrimaryAttributeDatatype | String | The data type of the primary attribute. | |
| Attributes | String | The activity attributes JSON aggregate. |
Get available activity type attributes.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
SELECT * FROM ActivityTypesAttributes WHERE ActivityTypeId=123
| Name | Type | Operators | Description |
| ActivityTypeId [KEY] | Int | The unique, Marketo-assigned identifier of the activity type. | |
| ActivityName | String | The name of the activity type. | |
| AttributeName [KEY] | String | The name of the attribute. | |
| AttributeDataType | String | The data type of the attribute. |
Returns a list of bulk export jobs that were created in the past 7 days.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
SELECT * FROM BulkExportJobs WHERE Table='Leads'
SELECT * FROM BulkExportJobs WHERE Table='Leads' AND Status='Created'
| Name | Type | Operators | Description |
| ExportId [KEY] | String | Unique id of the export job. | |
| Table [KEY] | String | = | Name of the table the export job was created for. Can be Activities, Leads, ProgramMembers or any CustomObject_ table. |
| Status | String | = | The status of the export. |
| Format | String | The format of the file. | |
| CreatedAt | Datetime | The date when the export request was created. | |
| QueuedAt | Datetime | The queue time of the export job. This column will have a value only when 'Queued' status is reached. | |
| StartedAt | Datetime | The start time of the export job. This column will have a value only when 'Processing' status is reached. | |
| FinishedAt | Datetime | The finish time of export job. This column will have a value only when status is 'Completed' or 'Failed'. | |
| FileSize | Long | The size of file in bytes. This column will have a value only when status is 'Completed'. | |
| FileChecksum | String | The checksum of the generated file. | |
| NumberOfRecords | Long | The number of records in the export file. This column will have a value only when the status is 'Completed'. | |
| ErrorMessage | String | The error message in case of failed status. |
Query Campaigns for a Marketo organization.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
SELECT * FROM Campaigns WHERE Id='1037'
SELECT * FROM Campaigns WHERE Id IN (1037, 1055, 1058)
SELECT * FROM Campaigns WHERE Name='TestCampaign1'
SELECT * FROM Campaigns WHERE Name='test' AND WorkspaceName='Default'
SELECT * FROM Campaigns WHERE ProgramName='Program6'
| Name | Type | Operators | Description |
| Id [KEY] | Int | =,IN | The unique, Marketo-assigned identifier of the campaign. |
| Name | String | =,IN | The name of the campaign. |
| Description | String | The description of the campaign. | |
| Type | String | The campaign type. | |
| ProgramId | Int | The Id of the program associated with the campaign. | |
| ProgramName | String | =,IN | The name of the program associated with the campaign. |
| WorkspaceName | String | =,IN | The name of the workspace associated with the campaign. |
| Active | Bool | Identifies whether the campaign is active. | |
| CreatedAt | Datetime | The date and time the campaign was created. | |
| UpdatedAt | Datetime | The date and time the campaign was last updated. |
Query ProgressionStatuses of Channels for a Marketo organization.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
SELECT * FROM ChannelProgressionStatuses WHERE ChannelName='Online Advertising'
Other queries:
SELECT * FROM ChannelProgressionStatuses WHERE ChannelName IN (SELECT Channel FROM Programs WHERE id=1010)
| Name | Type | Operators | Description |
| ChannelName [KEY] | String | = | The name of the channel. |
| Name [KEY] | String | Name of the status. | |
| Description | String | Description of the program status. | |
| Hidden | Bool | Whether the status has been hidden. | |
| Type | String | Type of the status. | |
| Step | Int | Step number of the status. | |
| Success | Bool | Whether this status is a success step for program members. |
Query Channels for a Marketo organization.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
SELECT * FROM Channels WHERE Name='Online Advertising'
| Name | Type | Operators | Description |
| Id [KEY] | Int | The unique, Marketo-assigned identifier of the channel. | |
| Name | String | = | The name of the channel. |
| ApplicableProgramType | String | The type of program that the channel is used for. | |
| CreatedAt | Datetime | The date and time the channel was created. | |
| UpdatedAt | Datetime | The date and time the channel was last updated. | |
| ProgressionStatuses | String | JSON array of progression statuses aggregates. Additionally exposed as the separate table ChannelProgressionStatuses. |
Retrieve the count of each error users have encountered in the current day.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
SELECT * FROM DailyErrorStatistics WHERE ErrorCode='610'
| Name | Type | Operators | Description |
| Date | Date | The date when the error was encountered. | |
| ErrorCode | String | The error code. | |
| Count | Int | The error count for the particular error code. |
Retrieve the number of API calls that specific users have consumed in the current day.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
SELECT * FROM DailyUsageStatistics WHERE UserId='User123'
| Name | Type | Operators | Description |
| Date | Date | The date when the API Calls were made. | |
| UserId | String | The ID of the user. | |
| Count | Int | The individual count for the user. |
Query Emails CC Fields for a Marketo organization.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
SELECT * FROM EmailCCFields WHERE AttributeId='attribute_123'
| Name | Type | Operators | Description |
| AttributeId [KEY] | String | The attribute identifier. | |
| ObjectName | String | Object name. Lead or Company. | |
| DisplayName | String | The display name. | |
| ApiName | String | The API name. |
Query email records which depend on a given email template.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
SELECT * FROM EmailTemplatesUsedBy WHERE EmailTemplateId=1
| Name | Type | Operators | Description |
| EmailTemplateId [KEY] | Int | = | The id of the email template. |
| Id [KEY] | Int | The id of the email that uses the email template. | |
| Name | String | The name of the email. | |
| Type | String | The type of the asset. | |
| Status | String | The status of the email. | |
| UpdatedAt | Datetime | The update date time of the email. |
Query files for a Marketo organization.
CreateFile can be used to upload a file.
UpdateFile can be used to update the file content.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
SELECT * FROM Files WHERE id='421'
SELECT * FROM Files WHERE Name='CData.png'
SELECT * FROM Files WHERE FolderId='34'
SELECT * FROM Files WHERE FolderId='34' AND ParentType='Folder'
| Name | Type | Operators | Description |
| Id [KEY] | Int | = | The unique, Marketo-assigned identifier of the file. |
| Name | String | = | The name of the file. |
| Description | String | Description of the file. | |
| FolderId | Int | = | The unique, Marketo-assigned identifier of the folder. |
| FolderName | String | The Name of the folder | |
| FolderType | String | The type of folder (Folder,Program) | |
| MimeType | String | MIME type of the file | |
| Size | Int | Size of the file in bytes | |
| URL | String | The explicit URL of the asset in the designated instance. | |
| CreatedAt | Datetime | The date and time the folder was created. | |
| UpdatedAt | Datetime | The date and time the folder was last updated. | |
| ParentType | String | = | Mirror column used as server side filter for the type of the parent folder. Will be ignored when filtering by Id or Name. |
Query Folders contents for a Marketo organization.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
SELECT * FROM FolderContents WHERE FolderId=12
SELECT * FROM FolderContents WHERE FolderId=12 AND FolderType='Folder'
| Name | Type | Operators | Description |
| Id [KEY] | Int | The marketo-assigned identifier of the folder content. | |
| Type | String | The type of the folder content. | |
| FolderId | Int | = | The unique, Marketo-assigned identifier of the folder. |
| FolderType | String | = | The type of the folder. Folder or Program, defaults to Folder. |
Query landing page template contents for a Marketo organization.
Note: This table uses the draft/approved versioning API. By default both versions are retrieved/modified. To interact with a specific version use the filter Status='draft' or Status='approved'.
UpdateLandingPageTemplateContent can be used to update the Landing Page Template Content.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
SELECT * FROM LandingPageTemplateContent WHERE LandingPageTemplateId=1 AND LandingPageTemplateStatus='approved'
SELECT * FROM LandingPageTemplateContent WHERE LandingPageTemplateId IN (1, 1005) AND LandingPageTemplateStatus IN ('draft', 'approved')
SELECT * FROM LandingPageTemplateContent WHERE LandingPageTemplateId IN (1, 1005)
SELECT * FROM LandingPageTemplateContent WHERE LandingPageTemplateStatus='draft'
SELECT * FROM LandingPageTemplateContent
| Name | Type | Operators | Description |
| LandingPageTemplateId [KEY] | Int | = | The unique, Marketo-assigned identifier of the landing page template. |
| LandingPageTemplateStatus [KEY] | String | = | Status of the landing page template, draft or approved versions. |
| Content | String | HTML content of the landing page template. | |
| EnableMunchkin | Bool | Whether to enable munchkin on the derived pages. Defaults to true. | |
| TemplateType | String | Type of template. |
Query Lead changes.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
SELECT * FROM LeadChanges WHERE ActivityDate = '2024-02-02 08:15:10.0'
SELECT * FROM LeadChanges WHERE ActivityDate > '2024-01-17T14:32:21'
SELECT * FROM LeadChanges WHERE ActivityDate >= '2024-01-17T14:32:21'
SELECT * FROM LeadChanges WHERE ActivityDate > '2024-01-17T14:32:21' AND ActivityDate < '2024-02-17T14:32:21'
SELECT * FROM LeadChanges WHERE LeadId IN (4, 14454)
SELECT * FROM LeadChanges WHERE ListId = 1014
SELECT * FROM LeadChanges WHERE ListId = 1014 AND ActivityDate > '2023-06-14T14:13:27Z'
SELECT * FROM LeadChanges WHERE LeadId = 9 AND ActivityDate > '2023-06-14T14:13:27Z'
Use LeadFields to specify the Lead columns from which you want to retrieve changes. Defaults to all columns. Retrieve column names from SYS_TABLECOLUMNS and provide them as comma-separated values.
SELECT * FROM LeadChanges WHERE LeadFields = 'mobilePhone'
SELECT * FROM LeadChanges WHERE LeadId = 4 AND LeadFields = 'mobilePhone'
| Name | Type | Operators | Description |
| ActivityId [KEY] | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| ActivityTypeId | Int | Id of the activity type. | |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| CampaignId | Int | Id of the associated Smart Campaign, if applicable. | |
| Attributes | String | JSON aggregate containing the list of attribute key value pair for this activity. | |
| Fields | String | JSON aggregate containing a list of changes made to lead fields. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| LeadFields | String | Mirror column used to specify Lead columns for which you want to retrieve changes for. Defaults to all columns. Column names can be retrieved from SYS_TABLECOLUMNS. SELECT [ColumnName] FROM SYS_TABLECOLUMNS WHERE TableName='leads' and should be provided as comma separated values. |
Query Lead changes attributes.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
SELECT * FROM LeadChangesAttributes WHERE ActivityDate = '2024-02-02 08:15:10.0'
SELECT * FROM LeadChangesAttributes WHERE ActivityDate > '2024-01-17T14:32:21'
SELECT * FROM LeadChangesAttributes WHERE ActivityDate >= '2024-01-17T14:32:21'
SELECT * FROM LeadChangesAttributes WHERE ActivityDate > '2024-01-17T14:32:21' AND ActivityDate < '2024-02-17T14:32:21'
SELECT * FROM LeadChangesAttributes WHERE LeadId IN (4, 14454)
SELECT * FROM LeadChangesAttributes WHERE ListId = 1014
SELECT * FROM LeadChangesAttributes WHERE ListId = 1014 AND ActivityDate > '2023-06-14T14:13:27Z'
SELECT * FROM LeadChangesAttributes WHERE LeadId = 9 AND ActivityDate > '2023-06-14T14:13:27Z'
Use LeadFields to specify the Lead columns from which you want to retrieve changes. Defaults to all columns. Retrieve column names from SYS_TABLECOLUMNS and provide them as comma-separated values.
SELECT * FROM LeadChangesAttributes WHERE LeadFields = 'mobilePhone'
SELECT * FROM LeadChangesAttributes WHERE LeadId = 4 AND LeadFields = 'mobilePhone'
| Name | Type | Operators | Description |
| ActivityId | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| ActivityTypeId | Int | Id of the activity type. | |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| AttributeAPIName | String | API Name of the attribute | |
| AttributeName | String | Name of the attribute | |
| AttributeValue | String | Value of the attribute | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| LeadFields | String | Mirror column used to specify Lead columns for which you want to retrieve changes for. Defaults to all columns. Column names can be retrieved from SYS_TABLECOLUMNS. SELECT [ColumnName] FROM SYS_TABLECOLUMNS WHERE TableName='leads' and should be provided as comma separated values. |
Query fields of lead changes.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
SELECT * FROM LeadChangesFields WHERE ActivityDate = '2024-02-02 08:15:10.0'
SELECT * FROM LeadChangesFields WHERE ActivityDate > '2024-01-17T14:32:21'
SELECT * FROM LeadChangesFields WHERE ActivityDate >= '2024-01-17T14:32:21'
SELECT * FROM LeadChangesFields WHERE ActivityDate > '2024-01-17T14:32:21' AND ActivityDate < '2024-02-17T14:32:21'
SELECT * FROM LeadChangesFields WHERE LeadId IN (4, 14454)
SELECT * FROM LeadChangesFields WHERE ListId = 1014
SELECT * FROM LeadChangesFields WHERE ListId = 1014 AND ActivityDate > '2023-06-14T14:13:27Z'
SELECT * FROM LeadChangesFields WHERE LeadId = 9 AND ActivityDate > '2023-06-14T14:13:27Z'
Use LeadFields to specify the Lead columns from which you want to retrieve changes. Defaults to all columns. Retrieve column names from SYS_TABLECOLUMNS and provide them as comma-separated values.
SELECT * FROM LeadChangesFields WHERE LeadFields = 'mobilePhone'
SELECT * FROM LeadChangesFields WHERE LeadId = 4 AND LeadFields = 'mobilePhone'
| Name | Type | Operators | Description |
| ActivityId | String | Unique id of the activity. | |
| ActivityDate | Datetime | >,>=,=,<,<= | Datetime of the activity. |
| ActivityTypeId | Int | Id of the activity type. | |
| LeadId | Int | =,IN | Id of the lead associated to the activity. |
| LeadChangeFieldId | Int | Unique integer id of the change record. | |
| LeadChangeFieldName | String | Name of the field which was changed. | |
| LeadChangeFieldNewValue | String | New value after the change. | |
| LeadChangeFieldOldValue | String | Old value before the change. | |
| ListId | Int | = | Mirror column that can be used only as a filter. Will retrieve activities for all leads that are members of this static list. Not available when UseBulkAPI=true. |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| LeadFields | String | Mirror column used to specify Lead columns for which you want to retrieve changes for. Defaults to all columns. Column names can be retrieved from SYS_TABLECOLUMNS. SELECT [ColumnName] FROM SYS_TABLECOLUMNS WHERE TableName='leads' and should be provided as comma separated values. |
Query Lead Partitions for a Marketo organization.
UpdateLeadPartition can be used to update the partition of a lead.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
SELECT * FROM LeadPartitions WHERE Id=123
| Name | Type | Operators | Description |
| Id [KEY] | Int | The unique, Marketo-assigned identifier of the lead partition. | |
| Name | String | The name of the partition. | |
| Description | String | The description of the partition. |
Query program membership for leads.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
If no LeadId filter is specified, this table queries all available LeadIds. This process is time-consuming because querying the Leads table is resource-intensive.
SELECT * FROM LeadPrograms WHERE LeadId=4
| Name | Type | Operators | Description |
| LeadId [KEY] | Int | = | The Marketo lead id. |
| ProgramId [KEY] | Int | Unique integer id of a program record. | |
| ProgressionStatus | String | Program status of the lead in the parent program. | |
| ProgressionStatusType | String | Program status Type of the lead in the parent program. | |
| IsExhausted | Bool | Whether the lead is currently exhausted in the stream, if applicable. | |
| AcquiredBy | Bool | Whether the lead was acquired by the parent program. | |
| ReachedSuccess | Bool | Whether the lead is in a success-status in the parent program. | |
| MembershipDate | Datetime | Date the lead first became a member of the program. | |
| UpdatedAt | Datetime | Datetime when the program was most recently updated. |
Query Static Lists for a Marketo organization from the Leads API.
This table contains the same records as StaticLists, however it has different columns and server-side filters that might be of use since the tables are retrieved from differnt API endpoints.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
SELECT * FROM Lists WHERE Id=1556
SELECT * FROM Lists WHERE Id IN (1556, 1057)
SELECT * FROM Lists WHERE Name='test0319'
SELECT * FROM Lists WHERE ProgramName='ImportTest0407'
SELECT * FROM Lists WHERE WorkspaceName='Default' AND Id=1014
| Name | Type | Operators | Description |
| Id [KEY] | Int | =,IN | Id of the static list. |
| Name | String | =,IN | Name of the static list. |
| Description | String | Description of the static list. | |
| ProgramName | String | =,IN | Name of the program. |
| WorkspaceId | Int | WorkspaceId of the static list. | |
| WorkspaceName | String | =,IN | Name of the workspace the static list is part of. |
| CreatedAt | Datetime | Datetime the static list was created. | |
| UpdatedAt | Datetime | Datetime the static list was most recently updated. |
Query leads of a static list in Marketo.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
Tip: This table uses server-side projection. Performance can be improved by minimizing the number of columns in projection.
SELECT * FROM ListStaticMemberShip WHERE ListId=123
| Name | Type | Operators | Description |
| ListId [KEY] | Int | = | Id of the static list. |
| Id [KEY] | Int | The lead Id. | |
| AcmeAccessCode | String | =,IN | |
| AcquisitionProgramId | Int | ||
| Address | String | ||
| AnnualRevenue | Decimal | ||
| AnonymousIP | String | ||
| BillingCity | String | ||
| BillingCountry | String | ||
| BillingPostalCode | String | ||
| BillingState | String | ||
| BillingStreet | String | ||
| BlackListed | Bool | ||
| BlackListedCause | String | ||
| City | String | ||
| Company | String | ||
| ContactCompany | Int | ||
| Cookies | String | =,IN | |
| Country | String | ||
| CreatedAt | Datetime | ||
| Cstmfdtest1 | String | =,IN | |
| Cstmfdtest2 | String | =,IN | |
| DateOfBirth | Date | ||
| Department | String | =,IN | |
| DoNotCall | Bool | ||
| DoNotCallReason | String | ||
| Ecids | String | ||
| String | =,IN | ||
| EmailInvalid | Bool | ||
| EmailInvalidCause | String | ||
| EmailSuspended | Bool | ||
| EmailSuspendedAt | Datetime | ||
| EmailSuspendedCause | String | =,IN | |
| ExternalCompanyId | String | =,IN | |
| ExternalSalesPersonId | String | =,IN | |
| Fax | String | ||
| FirstName | String | ||
| FirstUTMCampaign | String | ||
| FirstUTMContent | String | ||
| FirstUTMMedium | String | ||
| FirstUTMSource | String | ||
| FirstUTMTerm | String | ||
| GdprMailableStatus | String | ||
| Industry | String | ||
| InferredCity | String | ||
| InferredCompany | String | ||
| InferredCountry | String | ||
| InferredMetropolitanArea | String | ||
| InferredPhoneAreaCode | String | ||
| InferredPostalCode | String | ||
| InferredStateRegion | String | ||
| IsAnonymous | Bool | ||
| IsLead | Bool | ||
| LastName | String | ||
| LatestUTMCampaign | String | ||
| LatestUTMContent | String | ||
| LatestUTMMedium | String | ||
| LatestUTMSource | String | ||
| LatestUTMterm | String | ||
| LeadPartitionId | Int | =,IN | |
| LeadPerson | Int | ||
| LeadRevenueCycleModelId | Int | ||
| LeadRevenueStageId | Int | ||
| LeadRole | String | ||
| LeadScore | Int | ||
| LeadSource | String | ||
| LeadStatus | String | ||
| MainPhone | String | ||
| MarketingSuspended | Bool | ||
| MarketingSuspendedCause | String | ||
| MiddleName | String | ||
| MktoAcquisitionDate | Datetime | ||
| MktoCompanyNotes | String | ||
| MktoDoNotCallCause | String | ||
| MktoIsCustomer | Bool | ||
| MktoIsPartner | Bool | ||
| MktoName | String | =,IN | |
| MktoPersonNotes | String | ||
| MobilePhone | String | ||
| NumberOfEmployees | Int | ||
| NumberofEmployeesProspect | String | ||
| OriginalReferrer | String | ||
| OriginalSearchEngine | String | ||
| OriginalSearchPhrase | String | ||
| OriginalSourceInfo | String | ||
| OriginalSourceType | String | ||
| PersonLevelEngagementScore | Int | =,IN | |
| PersonPrimaryLeadInterest | Int | ||
| PersonTimeZone | String | ||
| PersonType | String | ||
| Phone | String | ||
| PostalCode | String | ||
| Priority | Int | ||
| Rating | String | ||
| RegistrationSourceInfo | String | ||
| RegistrationSourceType | String | ||
| RelativeScore | Int | ||
| RelativeUrgency | Int | ||
| Salutation | String | ||
| SicCode | String | ||
| Site | String | ||
| State | String | ||
| Test | String | =,IN | |
| Test1 | Bool | ||
| Test98 | String | =,IN | |
| TestBoolean | Bool | ||
| TestCustomfieldEmail | String | =,IN | |
| TestFieldText1 | String | =,IN | |
| TestInteger | Bool | ||
| TestInteger_cf | Int | =,IN | |
| TestKpQA | String | =,IN | |
| Title | String | ||
| Unsubscribed | Bool | ||
| UnsubscribeDateFoFS | String | ||
| UnsubscribeDateUnleashed | String | ||
| UnsubscribedReason | String | ||
| UnsubscribeFoFS | String | ||
| UnsubscribeMarketing | String | ||
| UnsubscribeSales | String | ||
| UnsubscribeUnleashed | String | ||
| UpdatedAt | Datetime | ||
| Urgency | Double | ||
| UTMTerm | String | =,IN | |
| Website | String |
Query, insert and delete program cost relations for a Marketo organization.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
SELECT * FROM ProgramCosts WHERE ProgramId='6205'
| Name | Type | Operators | Description |
| ProgramId | Int | = | The unique, Marketo-assigned identifier of the program. |
| Cost | Int | Amount of the cost. | |
| CostNote | String | Note of the cost. | |
| CostStartDate | Datetime | Start datetime of the period cost. |
Query tags relations for a Marketo organization.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
SELECT * FROM ProgramTags WHERE tagType='test' AND tagValue='asd1'
SELECT * FROM ProgramTags WHERE ProgramId=6138
| Name | Type | Operators | Description |
| ProgramId [KEY] | Int | = | The unique, Marketo-assigned identifier of the program. |
| TagType [KEY] | String | = | The tag type associated with the program. Each TagType has a value associated with it which is returned via the TagValue column. |
| TagValue | String | = | Value of the tag type. |
Query roles. Requires permissions: 'Access User Management Api' and 'Access Users'.
This view does not support server-side filtering.
SELECT * FROM Roles;
| Name | Type | Operators | Description |
| Id [KEY] | Integer | The unique, Marketo-assigned identifier of the role. | |
| Name | String | The name of the role. | |
| Description | String | The description of the role. | |
| Type | String | The type of the role. | |
| IsHidden | Boolean | Whether the role is hidden. | |
| IsOnlyAllZones | Boolean | Whether the role is all zones. | |
| CreatedAt | Datetime | The date and time the role was created. | |
| UpdatedAt | Datetime | The date and time the role was last updated. |
Query segmentations for a Marketo organization.
Note: This table uses the draft/approved versioning API. By default both versions are retrieved/modified. To interact with a specific version use the filter Status='draft' or Status='approved'.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
SELECT * FROM Segmentations WHERE Status='draft'
| Name | Type | Operators | Description |
| Id [KEY] | Int | Id of the segmentation. | |
| Status [KEY] | String | = | Status of the segmentation, draft or approved. |
| Name | String | Name of the segmentation. | |
| Description | String | Description of the segmentation. | |
| URL | String | Url of the segmentation in the Marketo UI. | |
| FolderId | Int | The unique, Marketo-assigned identifier of the parent folder/program. | |
| FolderName | String | The name of the folder | |
| FolderType | String | The type of folder (Folder,Program) | |
| WorkspaceName | String | Workspace Name of the asset. | |
| CreatedAt | Datetime | Datetime the segmentation was created. | |
| UpdatedAt | Datetime | Datetime the segmentation was most recently updated. |
Query segments for a Marketo organization.
Note: This table uses the draft/approved versioning API. By default both versions are retrieved/modified. To interact with a specific version use the filter Status='draft' or Status='approved'.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
SELECT * FROM Segments WHERE SegmentationId=1001 AND Status='draft'
SELECT * FROM Segments WHERE SegmentationId=1001
| Name | Type | Operators | Description |
| Id [KEY] | Int | Id of the segment. | |
| Status [KEY] | String | = | Status of the segment, draft or approved. |
| SegmentationId | Int | = | Id of the segmentation. |
| Name | String | Name of the segment. | |
| Description | String | Description of the segmentation. | |
| URL | String | Url of the segmentation in the Marketo UI. | |
| CreatedAt | Datetime | Datetime segment form was created. | |
| UpdatedAt | Datetime | Datetime the segment was most recently updated. |
Query filters of smart lists in a Marketo organization.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
SELECT * FROM SmartListFilterConditions WHERE SmartListId='1093'
| Name | Type | Operators | Description |
| FilterId | Int | Id of the smart list filter. | |
| SmartListId | Int | = | Id of the smart list. |
| ActivityAttributeId | String | Id of activity attribute. | |
| ActivityAttributeName | String | Name of activity attribute. | |
| AttributeId | String | Id of attribute. | |
| AttributeName | String | Name of attribute. | |
| Operator | String | Value of operator. | |
| Values | String | List of values. | |
| IsPrimary | String | Whether the condition is primary or not (first condition of the smart list). | |
| IsError | String | Whether the condition is error. | |
| ErrorMessage | String | The error message if IsError=true. |
Query filters of smart lists in a Marketo organization.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
SELECT * FROM SmartListFilters WHERE SmartListId='3560'
| Name | Type | Operators | Description |
| Id [KEY] | Int | Id of the smart list filter. | |
| SmartListId | Int | = | Id of the smart list. |
| Name | String | The name of the smart list rule filter. | |
| Operator | String | The operator used in the filter. | |
| RuleType | String | The type of the rule. | |
| RuleTypeId | Int | The Id of the rule type. | |
| FilterMatchType | String | The rule filter match type | |
| Conditions | String | JSON aggregate of smart list filter conditions. |
Query rules of smart lists in a Marketo organization.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
SELECT * FROM SmartListTriggers WHERE SmartListId='3560'
| Name | Type | Operators | Description |
| SmartListId | Int | = | Id of the smart list. |
| Trigger | String | Smart list trigger. |
Query allowed values for tags in a Marketo organization.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
SELECT * FROM TagAllowedValues WHERE TagType='test'
| Name | Type | Operators | Description |
| TagType [KEY] | String | = | The name/type of the tag. |
| AllowableValues | String | The acceptable values for the tag type. |
Query tags for a Marketo organization.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
SELECT * FROM Tags WHERE TagType='test'
| Name | Type | Operators | Description |
| TagType [KEY] | String | = | The name/type of the tag. |
| Required | Bool | Whether the tag is required for its applicable program types. | |
| ApplicableProgramTypes | String | The types of program that the tag is used for. |
Query form thank you pages for a Marketo organization.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
SELECT * FROM ThankYouList WHERE FormId=1
| Name | Type | Operators | Description |
| FormId | Int | = | Id of the form. |
| FollowupType | String | The follow up type. | |
| FollowupValue | String | The follow up value. | |
| Default | Bool | If this is the default ThankYouPage. | |
| Operator | String | The operator for the ThankYouPage. | |
| SubjectField | String | The subject field of the ThankYouPage. | |
| Values | String | JSON array of values. |
Retrieve the count of each error users have encountered in the past 7 days.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
SELECT * FROM WeeklyErrorStatistics WHERE ErrorCode='610'
| Name | Type | Operators | Description |
| Date | Date | The date when the error was encountered. | |
| ErrorCode | String | The error code. | |
| Count | Int | The error count for the particular error code. |
Retrieve the number of API calls that specific users have consumed in the past 7 days.
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
SELECT * FROM WeeklyUsageStatistics WHERE UserId='User123'
| Name | Type | Operators | Description |
| Date | Date | The date when the API Calls were made. | |
| UserId | String | The ID of the user. | |
| Count | Int | The individual count for the user. |
Retrieve workspaces. Requires permissions: 'Access User Management Api' and 'Access Users'.
This view does not support server-side filtering.
SELECT * FROM Workspaces;
| Name | Type | Operators | Description |
| Id [KEY] | Integer | The unique, Marketo-assigned identifier of the workspace. | |
| Name | String | The name of the workspace. | |
| Description | String | The description of the workspace. | |
| Status | String | The status of the workspace. | |
| GlobalVisualization | String | The global visualization of the workspace. | |
| CurrencyInfo | String | The currency info of the workspace. | |
| CreatedAt | Datetime | The date and time the workspace was created. | |
| UpdatedAt | Datetime | The date and time the workspace was last updated. |
| プロパティ | 説明 |
| URL | The URL of the Marketo instance to connect to. |
| プロパティ | 説明 |
| OAuthClientId | カスタムOAuth アプリケーションの作成時に割り当てられたクライアントId を指定します。(コンシューマーキーとも呼ばれます。)このID は、カスタムアプリケーションをOAuth 認可サーバーに登録します。 |
| OAuthClientSecret | カスタムOAuth アプリケーションの作成時に割り当てられたクライアントシークレットを指定します。( コンシューマーシークレット とも呼ばれます。)このシークレットは、カスタムアプリケーションをOAuth 認可サーバーに登録します。 |
| プロパティ | 説明 |
| SSLServerCert | TLS/SSL を使用して接続する際に、サーバーが受け入れ可能な証明書を指定します。 |
| プロパティ | 説明 |
| FirewallType | provider がプロキシベースのファイアウォールを介してトラフィックをトンネリングするために使用するプロトコルを指定します。 |
| FirewallServer | ファイアウォールを通過し、ユーザーのクエリをネットワークリソースに中継するために使用されるプロキシのIP アドレス、DNS 名、またはホスト名を識別します。 |
| FirewallPort | プロキシベースのファイアウォールで使用するTCP ポートを指定します。 |
| FirewallUser | プロキシベースのファイアウォールに認証するアカウントのユーザーID を識別します。 |
| FirewallPassword | プロキシベースのファイアウォールで認証するユーザーアカウントのパスワードを指定します。 |
| プロパティ | 説明 |
| ProxyAutoDetect | provider が、手動で指定されたプロキシサーバーを使用するのではなく、既存のプロキシサーバー構成についてシステムプロキシ設定をチェックするかどうかを指定します。 |
| ProxyServer | HTTP トラフィックをルートするプロキシサーバーのホストネームもしくはIP アドレス。 |
| ProxyPort | クライアントとの間でHTTP トラフィックをルーティングするために予約された、指定されたプロキシサーバー(ProxyServer 接続プロパティで設定)のTCP ポート。 |
| ProxyAuthScheme | ProxyServer 接続プロパティで指定されたプロキシサーバーに対して認証する際にprovider が使用する認証方法を指定します。 |
| ProxyUser | ProxyServer 接続プロパティで指定されたプロキシサーバーに登録されているユーザーアカウントのユーザー名。 |
| ProxyPassword | ProxyUser 接続プロパティで指定されたユーザーに紐付けられたパスワード。 |
| ProxySSLType | ProxyServer 接続プロパティで指定されたプロキシサーバーに接続する際に使用するSSL タイプ。 |
| ProxyExceptions | ProxyServer 接続プロパティで設定されたプロキシサーバー経由での接続が免除される宛先ホスト名またはIP のセミコロン区切りのリスト。 |
| プロパティ | 説明 |
| LogModules | ログファイルに含めるコアモジュールを指定します。セミコロンで区切られたモジュール名のリストを使用します。デフォルトでは、すべてのモジュールがログに記録されます。 |
| プロパティ | 説明 |
| Location | テーブル、ビュー、およびストアドプロシージャを定義するスキーマファイルを格納するディレクトリの場所を指定します。サービスの要件に応じて、これは絶対パスまたは相対パスのいずれかで表されます。 |
| BrowsableSchemas | レポートされるスキーマを利用可能なすべてのスキーマのサブセットに制限するオプション設定。例えば、 BrowsableSchemas=SchemaA,SchemaB,SchemaC です。 |
| Tables | レポートされるテーブルを利用可能なすべてのテーブルのサブセットに制限するオプション設定。例えば、 Tables=TableA,TableB,TableC です。 |
| Views | レポートされたビューを使用可能なテーブルのサブセットに制限するオプション設定。例えば、 Views=ViewA,ViewB,ViewC です。 |
| プロパティ | 説明 |
| BulkLeadsSupportsUpdatedAt | If set to true, the updatedAt filter will be marked as server-side supported. |
| BulkProgramMembersSupportsUpdatedAt | If set to true, the updatedAt filter will be marked as server-side supported. |
| DownloadChunkSize | The size of chunks (in bytes) when downloading large files. |
| IsCRMEnabled | Set to true to avoid pushing tables that are not available when CRM is enabled in Marketo. |
| JobPollingInterval | The maxmimum wait time in milliseconds between each job status poll. |
| MaxRows | 集計やGROUP BY を使用しないクエリで返される最大行数を指定します。 |
| MaxThreads | 同時リクエスト数を指定します。 |
| Other | 特定のユースケースに対して追加の隠しプロパティを指定します。これらは通常のprovider の機能では必要ありません。複数のプロパティを定義するには、セミコロンで区切られたリストを使用します。 |
| Pagesize | Marketo から返される、1ページあたりの結果の最大数を指定します。この設定は、ほとんどのユースケースに最適化されている、データソースによって設定されたデフォルトのページサイズをオーバーライドします。 |
| PseudoColumns | テーブルカラムとして公開する擬似カラムを指定します。'TableName=ColumnName;TableName=ColumnName' という形式を使用します。デフォルトは空の文字列で、このプロパティを無効にします。 |
| Timeout | provider がタイムアウトエラーを返すまでにサーバーからの応答を待機する最大時間を秒単位で指定します。デフォルトは60秒です。タイムアウトを無効にするには0を設定します。 |
| UploadChunkSize | The size of chunks (in bytes) when uploading large files. |
| UseBulkAPI | Specifies whether to use the Marketo Bulk API. |
| UserDefinedViews | カスタムビューを定義するJSON 構成ファイルへのファイルパスを指定します。provider は、このファイルで指定されたビューを自動的に検出して使用します。 |
このセクションでは、本プロバイダーの接続文字列で設定可能なConnection プロパティの全リストを提供します。
| プロパティ | 説明 |
| URL | The URL of the Marketo instance to connect to. |
The URL of the Marketo instance to connect to.
The URL of the REST API Service. Can be found in Admin -> Integration -> Web Services -> REST API. Example: https://123-abc-456.mktorest.com/ or https://123-abc-456.mktorest.com/rest.
このセクションでは、本プロバイダーの接続文字列で設定可能なOAuth プロパティの全リストを提供します。
| プロパティ | 説明 |
| OAuthClientId | カスタムOAuth アプリケーションの作成時に割り当てられたクライアントId を指定します。(コンシューマーキーとも呼ばれます。)このID は、カスタムアプリケーションをOAuth 認可サーバーに登録します。 |
| OAuthClientSecret | カスタムOAuth アプリケーションの作成時に割り当てられたクライアントシークレットを指定します。( コンシューマーシークレット とも呼ばれます。)このシークレットは、カスタムアプリケーションをOAuth 認可サーバーに登録します。 |
カスタムOAuth アプリケーションの作成時に割り当てられたクライアントId を指定します。(コンシューマーキーとも呼ばれます。)このID は、カスタムアプリケーションをOAuth 認可サーバーに登録します。
OAuthClientId は、ユーザーがOAuth 経由で認証を行う前に設定する必要があるいくつかの接続パラメータの1つです。詳細は接続の確立を参照してください。
カスタムOAuth アプリケーションの作成時に割り当てられたクライアントシークレットを指定します。( コンシューマーシークレット とも呼ばれます。)このシークレットは、カスタムアプリケーションをOAuth 認可サーバーに登録します。
OAuthClientSecret は、ユーザーがOAuth 経由で認証を行う前に設定する必要があるいくつかの接続パラメータの1つです。詳細は接続の確立を参照してください。
このセクションでは、本プロバイダーの接続文字列で設定可能なSSL プロパティの全リストを提供します。
| プロパティ | 説明 |
| SSLServerCert | TLS/SSL を使用して接続する際に、サーバーが受け入れ可能な証明書を指定します。 |
TLS/SSL を使用して接続する際に、サーバーが受け入れ可能な証明書を指定します。
TLS/SSL 接続を使用する場合は、このプロパティを使用して、サーバーが受け入れるTLS/SSL 証明書を指定できます。コンピュータによって信頼されていない他の証明書はすべて拒否されます。
このプロパティは、次のフォームを取ります:
| 説明 | 例 |
| フルPEM 証明書(例では省略されています) | -----BEGIN CERTIFICATE----- MIIChTCCAe4CAQAwDQYJKoZIhv......Qw== -----END CERTIFICATE----- |
| 証明書を保有するローカルファイルへのパス。 | C:\cert.cer |
| 公開鍵(例では省略されています) | -----BEGIN RSA PUBLIC KEY----- MIGfMA0GCSq......AQAB -----END RSA PUBLIC KEY----- |
| MD5 Thumbprint (hex 値はスペースおよびコロン区切り) | ecadbdda5a1529c58a1e9e09828d70e4 |
| SHA1 Thumbprint (hex 値はスペースおよびコロン区切り) | 34a929226ae0819f2ec14b4a3d904f801cbb150d |
これを指定しない場合は、マシンが信用するすべての証明書が受け入れられます。
すべての証明書の受け入れを示すには、'*'を使用します。セキュリティ上の理由から、これはお勧めできません。
このセクションでは、本プロバイダーの接続文字列で設定可能なFirewall プロパティの全リストを提供します。
| プロパティ | 説明 |
| FirewallType | provider がプロキシベースのファイアウォールを介してトラフィックをトンネリングするために使用するプロトコルを指定します。 |
| FirewallServer | ファイアウォールを通過し、ユーザーのクエリをネットワークリソースに中継するために使用されるプロキシのIP アドレス、DNS 名、またはホスト名を識別します。 |
| FirewallPort | プロキシベースのファイアウォールで使用するTCP ポートを指定します。 |
| FirewallUser | プロキシベースのファイアウォールに認証するアカウントのユーザーID を識別します。 |
| FirewallPassword | プロキシベースのファイアウォールで認証するユーザーアカウントのパスワードを指定します。 |
provider がプロキシベースのファイアウォールを介してトラフィックをトンネリングするために使用するプロトコルを指定します。
プロキシベースのファイアウォール(またはプロキシファイアウォール)は、ユーザーのリクエストとそれがアクセスするリソースの間に介在するネットワークセキュリティデバイスです。 プロキシは認証済みのユーザーのリクエストを受け取り、ファイアウォールを通過して適切なサーバーにリクエストを送信します。
プロキシは、リクエストを送信したユーザーに代わってデータバケットを評価し転送するため、ユーザーはサーバーに直接接続することなく、プロキシのみに接続します。
Note:デフォルトでは、Sync App はシステムプロキシに接続します。この動作を無効化し、次のプロキシタイプのいずれかに接続するには、ProxyAutoDetect をfalse に設定します。
次の表は、サポートされている各プロトコルのポート番号情報です。
| プロトコル | デフォルトポート | 説明 |
| TUNNEL | 80 | Sync App がMarketo への接続を開くポート。トラフィックはこの場所のプロキシを経由して行き来します。 |
| SOCKS4 | 1080 | Sync App がMarketo への接続を開くポート。SOCKS 4 は次にFirewallUser 値をプロキシに渡し、接続リクエストが許容されるかどうかを決定します。 |
| SOCKS5 | 1080 | Sync App がMarketo にデータを送信するポート。SOCKS 5 プロキシに認証が必要な場合には、FirewallUser およびFirewallPassword をプロキシが認識する認証情報に設定します。 |
HTTP プロキシへの接続には、ProxyServer およびProxyPort ポートを使ってください。HTTP プロキシへの認証には、ProxyAuthScheme、ProxyUser、およびProxyPassword を使ってください。
ファイアウォールを通過し、ユーザーのクエリをネットワークリソースに中継するために使用されるプロキシのIP アドレス、DNS 名、またはホスト名を識別します。
プロキシベースのファイアウォール(またはプロキシファイアウォール)は、ユーザーのリクエストとそれがアクセスするリソースの間に介在するネットワークセキュリティデバイスです。 プロキシは認証済みのユーザーのリクエストを受け取り、ファイアウォールを通過して適切なサーバーにリクエストを送信します。
プロキシは、リクエストを送信したユーザーに代わってデータバケットを評価し転送するため、ユーザーはサーバーに直接接続することなく、プロキシのみに接続します。
プロキシベースのファイアウォールで使用するTCP ポートを指定します。
プロキシベースのファイアウォール(またはプロキシファイアウォール)は、ユーザーのリクエストとそれがアクセスするリソースの間に介在するネットワークセキュリティデバイスです。 プロキシは認証済みのユーザーのリクエストを受け取り、ファイアウォールを通過して適切なサーバーにリクエストを送信します。
プロキシは、リクエストを送信したユーザーに代わってデータバケットを評価し転送するため、ユーザーはサーバーに直接接続することなく、プロキシのみに接続します。
プロキシベースのファイアウォールに認証するアカウントのユーザーID を識別します。
プロキシベースのファイアウォール(またはプロキシファイアウォール)は、ユーザーのリクエストとそれがアクセスするリソースの間に介在するネットワークセキュリティデバイスです。 プロキシは認証済みのユーザーのリクエストを受け取り、ファイアウォールを通過して適切なサーバーにリクエストを送信します。
プロキシは、リクエストを送信したユーザーに代わってデータバケットを評価し転送するため、ユーザーはサーバーに直接接続することなく、プロキシのみに接続します。
プロキシベースのファイアウォールで認証するユーザーアカウントのパスワードを指定します。
プロキシベースのファイアウォール(またはプロキシファイアウォール)は、ユーザーのリクエストとそれがアクセスするリソースの間に介在するネットワークセキュリティデバイスです。 プロキシは認証済みのユーザーのリクエストを受け取り、ファイアウォールを通過して適切なサーバーにリクエストを送信します。
プロキシは、リクエストを送信したユーザーに代わってデータバケットを評価し転送するため、ユーザーはサーバーに直接接続することなく、プロキシのみに接続します。
このセクションでは、本プロバイダーの接続文字列で設定可能なProxy プロパティの全リストを提供します。
| プロパティ | 説明 |
| ProxyAutoDetect | provider が、手動で指定されたプロキシサーバーを使用するのではなく、既存のプロキシサーバー構成についてシステムプロキシ設定をチェックするかどうかを指定します。 |
| ProxyServer | HTTP トラフィックをルートするプロキシサーバーのホストネームもしくはIP アドレス。 |
| ProxyPort | クライアントとの間でHTTP トラフィックをルーティングするために予約された、指定されたプロキシサーバー(ProxyServer 接続プロパティで設定)のTCP ポート。 |
| ProxyAuthScheme | ProxyServer 接続プロパティで指定されたプロキシサーバーに対して認証する際にprovider が使用する認証方法を指定します。 |
| ProxyUser | ProxyServer 接続プロパティで指定されたプロキシサーバーに登録されているユーザーアカウントのユーザー名。 |
| ProxyPassword | ProxyUser 接続プロパティで指定されたユーザーに紐付けられたパスワード。 |
| ProxySSLType | ProxyServer 接続プロパティで指定されたプロキシサーバーに接続する際に使用するSSL タイプ。 |
| ProxyExceptions | ProxyServer 接続プロパティで設定されたプロキシサーバー経由での接続が免除される宛先ホスト名またはIP のセミコロン区切りのリスト。 |
provider が、手動で指定されたプロキシサーバーを使用するのではなく、既存のプロキシサーバー構成についてシステムプロキシ設定をチェックするかどうかを指定します。
この接続プロパティをTrue に設定すると、Sync App は既存のプロキシサーバー構成についてシステムプロキシ設定をチェックします(プロキシサーバーの詳細を手動で入力する必要はありません)。
この接続プロパティは他のプロキシ設定より優先されます。特定のプロキシサーバーに接続するためにSync App を手動で構成する場合は、False に設定します。
HTTP プロキシへの接続には、ProxyServer を参照してください。SOCKS やトンネリングなどの他のプロキシには、FirewallType を参照してください。
HTTP トラフィックをルートするプロキシサーバーのホストネームもしくはIP アドレス。
ProxyAutoDetect がFalse に設定されている場合、Sync App はこの接続プロパティで指定されたプロキシサーバーを通じてのみHTTP トラフィックをルーティングします。ProxyAutoDetect がTrue に設定されている場合(デフォルト)、Sync App は代わりにシステムプロキシ設定で指定されたプロキシサーバーを介してHTTP トラフィックをルーティングします。
クライアントとの間でHTTP トラフィックをルーティングするために予約された、指定されたプロキシサーバー(ProxyServer 接続プロパティで設定)のTCP ポート。
ProxyAutoDetect がFalse に設定されている場合、Sync App はこの接続プロパティで指定されたプロキシサーバーポートを通じてのみHTTP トラフィックをルーティングします。ProxyAutoDetect がTrue に設定されている場合(デフォルト)、Sync App は代わりにシステムプロキシ設定で指定されたプロキシサーバーポートを介してHTTP トラフィックをルーティングします。
その他のプロキシタイプについては、FirewallType を参照してください。
ProxyServer 接続プロパティで指定されたプロキシサーバーに対して認証する際にprovider が使用する認証方法を指定します。
認証タイプは次のいずれかです。
"NONE" 以外のすべての値については、ProxyUser およびProxyPassword 接続プロパティも設定する必要があります。
SOCKS 5 認証のような他の認証タイプを使用するには、FirewallType を参照してください。
ProxyServer 接続プロパティで指定されたプロキシサーバーに登録されているユーザーアカウントのユーザー名。
ProxyUser および ProxyPassword 接続プロパティは、ProxyServer で指定されたHTTP プロキシに対して接続よび認証するために使用されます。
ProxyAuthScheme で利用可能な認証タイプを1つ選択した後、このプロパティを以下のように設定します。
| ProxyAuthScheme の値 | ProxyUser に設定する値 |
| BASIC | プロキシサーバーに登録されているユーザーのユーザー名。 |
| DIGEST | プロキシサーバーに登録されているユーザーのユーザー名。 |
| NEGOTIATE | プロキシサーバーが属するドメインまたは信頼されたドメイン内の有効なユーザーであるWindows ユーザーのユーザー名。user@domain またはdomain\user の形式で指定。 |
| NTLM | プロキシサーバーが属するドメインまたは信頼されたドメイン内の有効なユーザーであるWindows ユーザーのユーザー名。user@domain またはdomain\user の形式で指定。 |
| NONE | ProxyPassword 接続プロパティは設定しないでください。 |
Sync App は、ProxyAutoDetect がFalse に設定されている場合にのみ、このユーザー名を使用します。ProxyAutoDetect がTrue に設定されている場合(デフォルト)、Sync App は代わりにシステムのプロキシ設定で指定されているユーザー名を使用します。
ProxyUser 接続プロパティで指定されたユーザーに紐付けられたパスワード。
ProxyUser および ProxyPassword 接続プロパティは、ProxyServer で指定されたHTTP プロキシに対して接続よび認証するために使用されます。
ProxyAuthScheme で利用可能な認証タイプを1つ選択した後、このプロパティを以下のように設定します。
| ProxyAuthScheme の値 | ProxyPassword に設定する値 |
| BASIC | ProxyUser で指定したプロキシサーバーユーザーに紐付けられたパスワード。 |
| DIGEST | ProxyUser で指定したプロキシサーバーユーザーに紐付けられたパスワード。 |
| NEGOTIATE | ProxyUser で指定したWindows ユーザーアカウントに紐付けられたパスワード。 |
| NTLM | ProxyUser で指定したWindows ユーザーアカウントに紐付けられたパスワード。 |
| NONE | ProxyPassword 接続プロパティは設定しないでください。 |
SOCKS 5 認証もしくは、トンネリングは、FirewallType を参照してください。
Sync App は、ProxyAutoDetect がFalse に設定されている場合にのみ、このパスワードを使用します。ProxyAutoDetect がTrue に設定されている場合(デフォルト)、Sync App は代わりにシステムのプロキシ設定で指定されているパスワードを使用します。
ProxyServer 接続プロパティで指定されたプロキシサーバーに接続する際に使用するSSL タイプ。
このプロパティは、ProxyServer で指定されたHTTP プロキシへの接続にSSL を使用するかどうかを決定します。この接続プロパティには、以下の値を設定できます。
| AUTO | デフォルト設定。ProxyServer がHTTPS URL に設定されている場合、Sync App は、TUNNEL オプションを使用します。ProxyServer がHTTP URL に設定されている場合、コンポーネントはNEVER オプションを使用します。 |
| ALWAYS | 接続は、常にSSL 有効となります。 |
| NEVER | 接続は、SSL 有効になりません。 |
| TUNNEL | 接続はトンネリングプロキシ経由で行われます。プロキシサーバーがリモートホストへの接続を開き、プロキシを経由して通信が行われます。 |
ProxyServer 接続プロパティで設定されたプロキシサーバー経由での接続が免除される宛先ホスト名またはIP のセミコロン区切りのリスト。
ProxyServer は、このプロパティで定義されたアドレスを除くすべてのアドレスに使用されます。セミコロンを使用してエントリを区切ります。
Sync App はデフォルトでシステムプロキシ設定を使用するため、それ以上の設定は必要ありません。この接続にプロキシ例外を明示的に設定する場合は、ProxyAutoDetect をFalse に設定します。
このセクションでは、本プロバイダーの接続文字列で設定可能なLogging プロパティの全リストを提供します。
| プロパティ | 説明 |
| LogModules | ログファイルに含めるコアモジュールを指定します。セミコロンで区切られたモジュール名のリストを使用します。デフォルトでは、すべてのモジュールがログに記録されます。 |
ログファイルに含めるコアモジュールを指定します。セミコロンで区切られたモジュール名のリストを使用します。デフォルトでは、すべてのモジュールがログに記録されます。
このプロパティは、含めるログモジュールを指定することでログファイルの内容をカスタマイズすることができます。 ログモジュールは、クエリ実行、メタデータ、SSL 通信などの異なる領域にログ情報を分類します。 各モジュールは4文字のコードで表され、文字の名前の場合は末尾にスペースが必要なものもあります。
例えば、EXEC はクエリ実行をログに記録し、INFO は一般的なプロバイダーメッセージをログに記録します。 複数のモジュールを含めるには、次のように名前をセミコロンで区切ります:INFO;EXEC;SSL。
Verbosity 接続プロパティは、このプロパティで指定されたモジュールベースのフィルタリングよりも優先されます。 Verbosity レベルを満たし、指定されたモジュールに属するログエントリのみが記録されます。 利用可能なすべてのモジュールをログファイルに含めるには、このプロパティを空白のままにします。
利用可能なモジュールの完全なリストとログの設定に関する詳細な手引きについては、ログ の「高度なログの記録」セクションを参照してください。
このセクションでは、本プロバイダーの接続文字列で設定可能なSchema プロパティの全リストを提供します。
| プロパティ | 説明 |
| Location | テーブル、ビュー、およびストアドプロシージャを定義するスキーマファイルを格納するディレクトリの場所を指定します。サービスの要件に応じて、これは絶対パスまたは相対パスのいずれかで表されます。 |
| BrowsableSchemas | レポートされるスキーマを利用可能なすべてのスキーマのサブセットに制限するオプション設定。例えば、 BrowsableSchemas=SchemaA,SchemaB,SchemaC です。 |
| Tables | レポートされるテーブルを利用可能なすべてのテーブルのサブセットに制限するオプション設定。例えば、 Tables=TableA,TableB,TableC です。 |
| Views | レポートされたビューを使用可能なテーブルのサブセットに制限するオプション設定。例えば、 Views=ViewA,ViewB,ViewC です。 |
テーブル、ビュー、およびストアドプロシージャを定義するスキーマファイルを格納するディレクトリの場所を指定します。サービスの要件に応じて、これは絶対パスまたは相対パスのいずれかで表されます。
Location プロパティは、定義をカスタマイズしたり(例えば、カラム名を変更する、カラムを無視するなど)、新しいテーブル、ビュー、またはストアドプロシージャでデータモデルを拡張する場合にのみ必要です。
指定しない場合、デフォルトの場所は%APPDATA%\\CData\\Marketo Data Provider\\Schema となり、%APPDATA%はユーザーのコンフィギュレーションディレクトリに設定されます:
| プラットフォーム | %APPDATA% |
| Windows | APPDATA 環境変数の値 |
| Linux | ~/.config |
レポートされるスキーマを利用可能なすべてのスキーマのサブセットに制限するオプション設定。例えば、 BrowsableSchemas=SchemaA,SchemaB,SchemaC です。
利用可能なデータベーススキーマをすべてリストすると余分な時間がかかり、パフォーマンスが低下します。 接続文字列にスキーマのリストを指定することで、時間を節約しパフォーマンスを向上させることができます。
レポートされるテーブルを利用可能なすべてのテーブルのサブセットに制限するオプション設定。例えば、 Tables=TableA,TableB,TableC です。
データベースによっては、利用可能なすべてのテーブルをリストするのに時間がかかり、パフォーマンスが低下する場合があります。 接続文字列にテーブルのリストを指定することで、時間を節約しパフォーマンスを向上させることができます。
利用可能なテーブルがたくさんあり、すでに作業したいテーブルが決まっている場合、このプロパティを使用して対象のテーブルのみに表示を制限することができます。これを行うには、カンマ区切りのリストで使用したいテーブルを指定します。各テーブルは、角かっこ、二重引用符、またはバッククオートを使用してエスケープされた特殊文字列を含む有効なSQL 識別子である必要があります。 例えば、Tables=TableA,[TableB/WithSlash],WithCatalog.WithSchema.`TableC With Space` です。
Note:複数のスキーマまたはカタログを持つデータソースに接続する場合は、表示する各テーブルを完全修飾名で指定する必要があります。これにより、複数のカタログやスキーマに存在するテーブルが混同されることを防ぎます。
レポートされたビューを使用可能なテーブルのサブセットに制限するオプション設定。例えば、 Views=ViewA,ViewB,ViewC です。
データベースによっては、利用可能なすべてのビューをリストするのに時間がかかり、パフォーマンスが低下する場合があります。 接続文字列にビューのリストを指定することで、時間を節約しパフォーマンスを向上させることができます。
利用可能なビューがたくさんあり、すでに作業したいビューが決まっている場合、このプロパティを使用して対象のビューのみに表示を制限することができます。これを行うには、カンマ区切りのリストで使用したいビューを指定します。各ビューは、角かっこ、二重引用符、またはバッククオートを使用してエスケープされた特殊文字列を含む有効なSQL 識別子である必要があります。 例えば、Views=ViewA,[ViewB/WithSlash],WithCatalog.WithSchema.`ViewC With Space` です。
Note:複数のスキーマまたはカタログを持つデータソースに接続する場合は、確認する各ビューを完全修飾名で指定する必要があります。これにより、複数のカタログやスキーマに存在するビューが混同されることを防ぎます。
このセクションでは、本プロバイダーの接続文字列で設定可能なMiscellaneous プロパティの全リストを提供します。
| プロパティ | 説明 |
| BulkLeadsSupportsUpdatedAt | If set to true, the updatedAt filter will be marked as server-side supported. |
| BulkProgramMembersSupportsUpdatedAt | If set to true, the updatedAt filter will be marked as server-side supported. |
| DownloadChunkSize | The size of chunks (in bytes) when downloading large files. |
| IsCRMEnabled | Set to true to avoid pushing tables that are not available when CRM is enabled in Marketo. |
| JobPollingInterval | The maxmimum wait time in milliseconds between each job status poll. |
| MaxRows | 集計やGROUP BY を使用しないクエリで返される最大行数を指定します。 |
| MaxThreads | 同時リクエスト数を指定します。 |
| Other | 特定のユースケースに対して追加の隠しプロパティを指定します。これらは通常のprovider の機能では必要ありません。複数のプロパティを定義するには、セミコロンで区切られたリストを使用します。 |
| Pagesize | Marketo から返される、1ページあたりの結果の最大数を指定します。この設定は、ほとんどのユースケースに最適化されている、データソースによって設定されたデフォルトのページサイズをオーバーライドします。 |
| PseudoColumns | テーブルカラムとして公開する擬似カラムを指定します。'TableName=ColumnName;TableName=ColumnName' という形式を使用します。デフォルトは空の文字列で、このプロパティを無効にします。 |
| Timeout | provider がタイムアウトエラーを返すまでにサーバーからの応答を待機する最大時間を秒単位で指定します。デフォルトは60秒です。タイムアウトを無効にするには0を設定します。 |
| UploadChunkSize | The size of chunks (in bytes) when uploading large files. |
| UseBulkAPI | Specifies whether to use the Marketo Bulk API. |
| UserDefinedViews | カスタムビューを定義するJSON 構成ファイルへのファイルパスを指定します。provider は、このファイルで指定されたビューを自動的に検出して使用します。 |
If set to true, the updatedAt filter will be marked as server-side supported.
Only some Marketo instances support the UpdatedAt filter for Leads Bulk Exports. To enable the filter you need to reach out to Marketo support.
| True | The Leads.UpdatedAt filter will be processed server-side. |
| False | The Leads.UpdatedAt filter will be processed client-side. |
| Auto | The driver will execute a probe query to check if the filter is supported or not. |
If set to true, the updatedAt filter will be marked as server-side supported.
Only some Marketo instances support the UpdatedAt filter for ProgramMembers Bulk Exports. To enable the filter you need to reach out to Marketo support.
| True | The ProgramMembers.UpdatedAt filter will be processed server-side. |
| False | The ProgramMembers.UpdatedAt filter will be processed client-side. |
| Auto | The driver will execute a probe query to check if the filter is supported or not. |
The size of chunks (in bytes) when downloading large files.
The size of chunks (in bytes) to use when downloading large files, defaults to 3MB. To download the entire file in one chunk, set this value to -1.
Set to true to avoid pushing tables that are not available when CRM is enabled in Marketo.
| True | Tables that are not available when CRM is enabled in Marketo will not be pushed. |
| False | The driver will push all tables normally. |
| Auto | The driver will execute a probe query to check if CRM is enabled or not. |
The maxmimum wait time in milliseconds between each job status poll.
Initially the wait time is 5 seconds and doubles until it reaches the given JobPollingInterval.
集計やGROUP BY を使用しないクエリで返される最大行数を指定します。
このプロパティは、集計やGROUP BY 句を含まないクエリに対してSync App が返す行数の上限を設定します。 この制限により、クエリがデフォルトで過度に大きな結果セットを返さないようにします。
クエリにLIMIT 句が含まれている場合、クエリで指定された値がMaxRows 設定よりも優先されます。 MaxRows が"-1" に設定されている場合、LIMIT 句が明示的にクエリに含まれていない限り、行の制限は行われません。
このプロパティは、非常に大きなデータセットを返す可能性のあるクエリを実行する際に、パフォーマンスを最適化し過剰なリソース消費を防ぐのに役立ちます。
同時リクエスト数を指定します。
このプロパティを使用すると、複数のリクエストを同時に発行することができパフォーマンスが向上します。
特定のユースケースに対して追加の隠しプロパティを指定します。これらは通常のprovider の機能では必要ありません。複数のプロパティを定義するには、セミコロンで区切られたリストを使用します。
このプロパティは、シニアユーザーが特定のシナリオに対して隠しプロパティを設定できるようにします。 これらの設定は通常のユースケースには必要ありませんが、特定の要件に対応したり、追加の機能を提供したりすることができます。 複数のプロパティをセミコロン区切りのリストで定義できます。
Note: 特定のシナリオや問題に対処するためにサポートチームから助言があった場合にのみ、これらのプロパティを設定することを強く推奨します。
複数のプロパティをセミコロン区切りリストで指定します。
| DefaultColumnSize | データソースがメタデータにカラムの長さを提供しない場合に、文字列フィールドのデフォルトの長さを設定します。デフォルト値は2000です。 |
| ConvertDateTimeToGMT | 日時の値を、マシンのローカルタイムではなくGMT グリニッジ標準時に変換するかどうかを決定します。 |
| RecordToFile=filename | 基底のソケットデータ転送を指定のファイルに記録します。 |
Marketo から返される、1ページあたりの結果の最大数を指定します。この設定は、ほとんどのユースケースに最適化されている、データソースによって設定されたデフォルトのページサイズをオーバーライドします。
クエリする特定のオブジェクトやサービスエンドポイントの結果を最適化するために、デフォルトのページサイズを調整したい場合があります。 ページサイズを大きくするとパフォーマンスが向上するかもしれませんが、ページあたりのメモリ消費量が増える可能性もあることに注意してください。
テーブルカラムとして公開する擬似カラムを指定します。'TableName=ColumnName;TableName=ColumnName' という形式を使用します。デフォルトは空の文字列で、このプロパティを無効にします。
このプロパティを使用すると、Sync App がテーブルカラムとして公開する擬似カラムを定義できます。
個々の擬似カラムを指定するには、以下の形式を使用します。"Table1=Column1;Table1=Column2;Table2=Column3"
すべてのテーブルのすべての擬似カラムを含めるには、次のようにします:"*=*"
provider がタイムアウトエラーを返すまでにサーバーからの応答を待機する最大時間を秒単位で指定します。デフォルトは60秒です。タイムアウトを無効にするには0を設定します。
このプロパティは、Sync App が操作をキャンセルする前に操作の完了を待機する最大時間を秒単位で制御します。 操作の完了前にタイムアウト時間が経過すると、Sync App は操作をキャンセルして例外をスローします。
タイムアウトは、クエリや操作全体ではなくサーバーとの個々の通信に適用されます。 例えば、各ページング呼び出しがタイムアウト制限内に完了する場合、クエリは60秒を超えて実行を続けることができます。
このプロパティを0に設定するとタイムアウトが無効になり、操作が成功するか、サーバー側のタイムアウト、ネットワークの中断、またはサーバーのリソース制限などの他の条件で失敗するまで無期限に実行されます。 このプロパティは慎重に使用してください。長時間実行される操作がパフォーマンスを低下させたり、応答しなくなる可能性があるためです。
The size of chunks (in bytes) when uploading large files.
The size of chunks (in bytes) to use when uploading large files, defaults to 10MB. To upload the entire file in one chunk, set this value to -1.
Specifies whether to use the Marketo Bulk API.
| True | The Marketo Bulk API will be used to extract or import data where applicable in SELECT/UPSERT statemnts. |
| False | The driver will not make use of the Bulk API. |
| Auto | The driver will make use of the Bulk API only in cases when the REST API is not sufficient such as when querying more than 100_000 records from the ProgramMembers table. |
カスタムビューを定義するJSON 構成ファイルへのファイルパスを指定します。provider は、このファイルで指定されたビューを自動的に検出して使用します。
このプロパティを使用すると、UserDefinedViews.json というJSON 形式の構成ファイルを通じてカスタムビューを定義および管理できます。 これらのビューはSync App によって自動的に認識され、標準のデータベースビューのようにカスタムSQL クエリを実行できるようになります。 JSON ファイルは、各ビューをルート要素として定義し、その子要素として"query" を持ちます。この"query" にはビューのSQL クエリが含まれています。次に例を示します。
{
"MyView": {
"query": "SELECT * FROM Leads WHERE MyColumn = 'value'"
},
"MyView2": {
"query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
}
}
このプロパティを使用して、1つのファイルに複数のビューを定義し、ファイルパスを指定できます。 例:UserDefinedViews=C:\Path\To\UserDefinedViews.json。 このプロパティを使用すると、指定されたビューのみがSync App によって検知されます。
詳しくは、ユーザー定義ビュー を参照してください。