Automation
The Automation object defines an Automation Studio automation. To update, delete, or perform an automation, you must have the Automation Studio | Automation permission.
The only supported operators for the Automation object are IN and EQUALS. Complex filters aren't supported.
| Name | Data Type | Description |
|---|---|---|
AutomationSource | AutomationSource object | An object that identifies the source of the automation. |
AutomationTasks | Array of AutomationTask objects | An array of objects. Each object specifies a task in the automation. |
AutomationType | String | The type of automation. |
Client | ClientID | Defines which account owns the automation. |
CorrelationID | String | Identifies calls involved in a specific asynchronous process. |
CreatedDate | String | The date and time when the object was created. Read-only. |
CustomerKey | String | A user-supplied unique identifier for the automation, sometimes referred to as the external key. |
Description | String | A description of the object. |
ID | Integer | A unique ID for the object. Not used with this object type. |
InteractionObjectID | String | A unique ID for activities within the asynchronous process of the overall conversation or program. |
IsActive | Boolean | Specifies whether the object is active. |
Keyword | String | Not used. |
ModifiedDate | String | The date and time when the object was last modified. Read-only. |
Name | String | The name of the automation. |
Notifications | Array of AutomationNotification objects | An array of objects. Each object represents a notification to send when the automation completes. |
ObjectID | String | A unique ID for the object. Not used with this object type. |
ObjectState | String | Not used. |
Owner | Owner | Describes the account ownership of a subscriber in an account that is managed on your behalf. |
PartnerKey | String | A unique identifier for an object, provided by a partner. This property can only be accessed by using the API. |
PartnerProperties | Array of APIProperty objects | A collection of metadata supplied by the client and stored by the system. This property can only be accessed by using the API. |
ProgramID | String | An identifier for the automation. Read-only. |
Schedule | ScheduleDefinition | An object that represents the schedule for the automation. |
ScheduledTime | String | The date and time when the automation is scheduled for publishing. Specify the value in ISO 8601 format with UTC time or a timezone offset. The specified time can be up to 30 days in the future. |
Status | Integer | A code that indicates the status of the automation. See (Status Codes)[#status-codes] for more information. |
The values of the ScheduledTime and CreatedDate properties are always shown as "0001-01-01T00:00:00.000".
The Status property can contain the values in this table.
| Code | Description |
|---|---|
-1 | The automation failed. |
0 | The automation failed while being built. |
1 | The automation is being built. |
2 | The automation is ready to start. |
3 | The automation is running. |
4 | The automation has been paused. |
5 | The automation has been stopped. |
6 | The automation is scheduled. |
7 | The automation is waiting for a trigger. |
8 | The trigger for the automation is inactive. |