# 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: 5/21/2025, 5:22:32 AM