# Create object action

This action creates a new object in your Marketo instance.

# Input fields

Field Description
Object Select the object you plan to create. Options include Opportunity, Opportunity role, Lead, Program, Smart campaign, and Custom object.

Refer to the relevant sections to learn how to configure the input fields for the object you plan to create:

# Opportunity input fields

Field Description
External opportunity ID Provide the unique ID for the opportunity in an external system.
External opportunity campaign ID Enter the campaign ID associated with the opportunity from an external source.
Amount Fill in the total amount for the opportunity.
Close date Enter the date when the opportunity is expected to close.
Description Provide a brief description of the opportunity.
Expected revenue Fill in the estimated revenue expected from the opportunity.
External company ID Enter the external ID for the company associated with this opportunity.
External created date Provide the date when the opportunity was created in an external system.
External sales person ID Enter the ID of the salesperson from an external system.
Fiscal Specify the fiscal period for this opportunity.
Fiscal quarter Provide the fiscal quarter when this opportunity falls.
Fiscal year Enter the fiscal year for the opportunity.
Forecast category Specify the forecast category for this opportunity.
Forecast category name Enter the name of the forecast category for the opportunity.
Is closed Indicate whether the opportunity is closed.
Is won Indicate whether the opportunity has been won.
Last activity date Provide the date of the last activity related to this opportunity.
Lead source Enter the source from which the lead originated.
Name Fill in the name of the opportunity.
Next step Provide details about the next step for this opportunity.
Probability Enter the probability of winning this opportunity (as a percentage).
Quantity Specify the quantity of items or services in the opportunity.
Stage Provide the current stage of the opportunity.
Type Enter the type or classification of the opportunity.

# Opportunity role input fields

Field Description
Lead ID Provide the unique ID for the lead associated with the opportunity.
Role Enter the role of the lead in relation to the opportunity.
External contact ID Provide the external contact ID associated with the lead.
External ID Enter the external system ID related to the lead.
External created date Provide the date when the role was created in the external system.
Is primary Indicate whether this is the primary role for the opportunity.

# Lead input fields

Refer to the Marketo documentation for a list of standard fields (opens new window) available through the API. This list includes common fields but may not cover all input fields specific to this action.

# Program input fields

Field Description
Folder ID Provide the ID of the folder where you plan to create the program.
Folder type Specify the type of folder. Accepted values include Folder and Program.
Name Enter the name of the program you plan to create.
Program type Specify the type of the program. Accepted values include Default, Event, Event with Webinar, Engagement, and Email.
Channel Provide the marketing channel associated with the program.
Costs Enter the total costs associated with the program.
Costs source list (costs) Input a list datapill from which the program costs are derived. Learn more about list input.
Cost (costs) Provide the cost associated with the program.
Note (costs) Enter any notes related to the costs of the program.
Start date (costs) Provide the start date for the program costs.
Description Provide a description of the program.
Tags Enter tags associated with the program for categorization.
Tags source list (tags) Specify the source list for program tags.
Tag type (tags) Enter the type of tag for the program.
Tag value (tags) Provide the value associated with the program's tag.

# Smart campaign input fields

Field Description
Name Provide the name of the smart campaign.
Folder Enter the name of the folder where the smart campaign is located.
Folder type (folder) Specify the type of folder.
Folder ID (folder) Provide the unique ID of the folder where the smart campaign is stored.
Description Enter a description of the smart campaign.

# Custom object input fields

Field Description
Custom object name Provide the name of the custom object.

# Output fields

The output fields vary depending on the object you select for the action.

# Opportunity output fields

Field Description
Marketo GUID The unique identifier assigned to the opportunity in Marketo.

# Opportunity role output fields

Field Description
Marketo GUID The unique identifier assigned to the opportunity role in Marketo.

# Lead output fields

Field Description
Lead ID The unique identifier assigned to the lead in Marketo.

# Program output fields

Field Description
Success Indicates whether the program was created successfully.
Request ID The ID associated with the request to create the program.
Errors Any errors that occurred during the request.
Code (errors) The error code, if any, related to the request.
Message (errors) A descriptive message for any errors encountered.
Warnings Any warnings related to the request.
Result A list of programs created or affected by the request.
ID (result) The ID of the program created or affected.
Name (result) The name of the program created or affected.
Description (result) The description of the program created or affected.
URL (result) The URL where the program can be accessed.
Type (result) The type of the program created or affected.
Channel (result) The channel associated with the program created.
Status (result) The status of the program created or affected.
Workspace (result) The workspace where the program was created or modified.
Tags (result) Tags associated with the program created or affected.
Tag type (tags) The type of tag associated with the program.
Tag value (tags) The value of the tag associated with the program.
Folder (result) The folder where the program is located.
Folder name (folder) The name of the folder where the program is stored.
Type (folder) The type of folder where the program is located.
Value (folder) The value associated with the folder.
Created at The datetime when the program was created.
Updated at The datetime when the program was last updated.
SFDC ID The Salesforce ID associated with the program created.
SFDC name The Salesforce name associated with the program created.

# Smart campaign output fields

Field Description
ID The unique identifier for the smart campaign.
Name The name of the smart campaign.
Description The description of the smart campaign.
Type The type of smart campaign. For example, batch, default, or trigger.
Is system Indicates whether the smart campaign is a system-level smart campaign.
Is active Indicates whether the smart campaign is currently active.
Is requestable Indicates whether the smart campaign can be requested through an API.
Recurrence The recurrence object for the smart campaign.
Start at (recurrence) The datetime of the first scheduled campaign to run.
End at (recurrence) The datetime after which no further runs will be automatically scheduled.
Interval type (recurrence) The type of interval for recurrence. For example, Daily, Weekly, or Monthly.
Interval (recurrence) The number of interval units between recurrences.
Weekday only (recurrence) Indicates whether the smart campaign only runs weekdays.
Weekday mask (recurrence) A string array containing one or more of the following days: Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday. The array may also be empty.
Day of month (recurrence) The day of the month for the recurrence.
Day of week (recurrence) The day of the week for the recurrence.
Week of month (recurrence) The week of the month for the recurrence.
Qualification rule type The type of qualification rule for the smart campaign. For example, once, any, or interval.
Qualification rule interval The interval for qualification rule.
Qualification rule unit The unit of time for the qualification rule.
Max members The maximum number of members allowed in the smart campaign.
Is communication limit enabled Indicates whether communication limits are applied to the smart campaign.
Smart list ID The unique identifier for the smart list associated with the smart campaign.
Flow ID The unique identifier for the flow in the smart campaign.
Parent program ID The unique identifier for the parent program.
Folder The folder where the smart campaign is stored.
ID (folder) The unique identifier for the folder.
Type (folder) The type of folder.
Created at The datetime when the smart campaign was created.
Updated at The datetime when the smart campaign was updated.
Workspace The workspace in which the smart campaign is located.
Computed URL The URL where the smart campaign can be accessed or viewed.
Status The status of the smart campaign.

# Custom object output fields

Field Description
Marketo GUID The unique identifier assigned to the custom object in Marketo.


Last updated: 10/2/2024, 3:53:41 PM