---
schema_version: "1"
id: 065174783ffc09c5151d2779a71b3a0f9c3c4510cce704f7684e1d61e0c6d7ba
title: AutomationInstance
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/marketing-cloud/guides/mc-apis/automationinstance.md
canonical_url: https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/automationinstance.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: d54324bf328bd2935095d10c3d193c492d79144aeeced448a975fffdc5af0ee5
products:
  - Marketing Cloud Engagement APIs and Programmatic Languages
  - Marketing Cloud
---
# AutomationInstance

Represents a specific execution of an automation in Automation Studio. Every time an automation runs, whether on a schedule or executed manually, Marketing Cloud Engagement creates an `AutomationInstance` record to track that execution.

| Name                  | Data Type                                                            | Description                                                                                                  |
| --------------------- | -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| `AutomationID`        | String                                                               | Identifies automation associated with this instance. This field is supported for backward compatibility.     |
| `AutomationSource`    | [AutomationSource](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/automationsource.md) object                       | Identifies source of automation.                                                                             |
| `AutomationTasks`     | Array of AutomationTasks objects                                     | Identifies tasks within automation.                                                                          |
| `AutomationType`      | String                                                               | Identifies type of automation.                                                                               |
| `Client`              | [ClientID](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/clientid.md) object                                       | Defines which account owns the automation.                                                                   |
| `CompletedTime`       | DateTime                                                             | Indicates when automation completed.                                                                         |
| `CorrelationID`       | String                                                               | Identifies calls involved in a specific asynchronous process.                                                |
| `CreatedDate`         | DateTime                                                             | The date and time when the object was created.                                                               |
| `CustomerKey`         | String                                                               | User-supplied unique identifier for an object within an object type.                                         |
| `Description`         | String                                                               | Describes and provides information regarding the object.                                                     |
| `ID`                  | Int                                                                  | Read-only legacy identifier for an object. Not supported on all objects.                                     |
| `InteractionObjectID` | String                                                               | Returns associated ID for activities within the asynchronous process of the overall conversation or program. |
| `IsActive`            | Boolean                                                              | Specifies whether the object is active.                                                                      |
| `Keyword`             | String                                                               | Reserved for future use.                                                                                     |
| `ModifiedDate`        | DateTime                                                             | The date and time when the object was last modified.                                                         |
| `Name`                | String                                                               | Name of the object or property.                                                                              |
| `Notifications`       | Array of [AutomationNotification](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/automationnotification.md) objects | Indicates notifications to use when automation completes.                                                    |
| `ObjectID`            | String                                                               | System-controlled, read-only text string identifier for object.                                              |
| `ObjectState`         | String                                                               | Reserved for future use.                                                                                     |
| `Owner`               | [Owner](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/owner.md) object                                             | Describes account ownership of subscriber in an on-your-behalf account.                                      |
| `PartnerKey`          | String                                                               | Unique identifier provided by partner for an object. This property is accessible only via API.               |
| `PartnerProperties`   | Array of [APIProperty](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/apiproperty.md) objects                       | A collection of metadata supplied by client and stored by system. This property is accessible only via API.  |
| `Schedule`            | [ScheduleDefinition](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/scheduledefinition.md) object                   | Indicates schedule for automation.                                                                           |
| `ScheduledTime`       | DateTime                                                             | Keeps requests in asynchronous queue until time specified in call.                                           |
| `StartTime`           | DateTime                                                             | The date and time that this instance of an automation started.                                               |
| `Status`              | Int                                                                  | Indicates status of automation.                                                                              |
| `StatusLastUpdate`    | DateTime                                                             | The date and time that the status of this instance of the activity was last updated.                         |
| `StatusMessage`       | String                                                               | Indicates message associated with status.                                                                    |
| `TaskInstances`       | Array of [AutomationTaskInstance](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/automationtaskinstance.md) objects | Indicates instances of tasks associated with this automation instance.                                       |

## Related Items

- [Supported Operations for Objects and Methods](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/supported_operations_for_objects_and_methods.md)
- [Automation](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/automation.md)