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.

Select

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]')

Insert

This table supports BATCH INSERT when UseBulkAPI is set to false.

	INSERT INTO CustomObject_cdata (Names) VALUES ('tes123')

Update

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]')

Upsert

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')

Delete

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]')

Bulk

When UseBulkAPI is set to true the UpdateAt filter can be processed server-side, in addition to that the following extra filters are available:

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.

Sample queries:

	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

Columns

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