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

The ScheduleDefinition object is a run-time set of attributes used to schedule an email send or program.

## Properties

| Name                  | Data Type                                             | Description                                                                                                                                                                                                                                                                                                                 |
| --------------------- | ----------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Client`              | [ClientID](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/clientid.md)                               | Specifies the account ownership and context of an object.                                                                                                                                                                                                                                                                   |
| `CorrelationID`       | String                                                | Identifies correlation of objects across several requests.                                                                                                                                                                                                                                                                  |
| `CreatedDate`         | DateTime                                              | The date and time when the object was created.                                                                                                                                                                                                                                                                              |
| `CustomerKey`         | String                                                | User-supplied unique identifier for an object within an object type. This property corresponds to the external key assigned to an object.                                                                                                                                                                                   |
| `Description`         | String                                                | Describes and provides information regarding the object.                                                                                                                                                                                                                                                                    |
| `EndDateTime`         | DateTime                                              | Specifies end time of schedule definition.                                                                                                                                                                                                                                                                                  |
| `ID`                  | Int                                                   | Read-only identifier for an object. Some objects use the ObjectID property as a unique ID.                                                                                                                                                                                                                                  |
| `Keyword`             | String                                                | Not used.                                                                                                                                                                                                                                                                                                                   |
| `ModifiedDate`        | DateTime                                              | The date and time when the object was last modified.                                                                                                                                                                                                                                                                        |
| `Name`                | String                                                | Name of the object or property.                                                                                                                                                                                                                                                                                             |
| `ObjectID`            | String                                                | System-controlled, read-only text string identifier for object.                                                                                                                                                                                                                                                             |
| `ObjectState`         | String                                                | Not used.                                                                                                                                                                                                                                                                                                                   |
| `Occurrences`         | Int                                                   | Specifies number of times to run a schedule definition.                                                                                                                                                                                                                                                                     |
| `Owner`               | [Owner](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/owner.md)                                     | 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 the client and stored by the system. These properties are accessible only via API.                                                                                                                                                                                                     |
| `Recurrence`          | [Recurrence](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/recurrence.md)                           | Interval of recurrence type.                                                                                                                                                                                                                                                                                                |
| `RecurrenceRangeType` | [RecurrenceRangeTypeEnum](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/recurrencerangetypeenum.md) | Defines how a recurrence type ends.                                                                                                                                                                                                                                                                                         |
| `RecurrenceType`      | [RecurrenceTypeEnum](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/recurrencetypeenum.md)           | Specifies type of recurrence, such as daily or hourly.                                                                                                                                                                                                                                                                      |
| `StartDateTime`       | DateTime                                              | Specifies start time of schedule definition.                                                                                                                                                                                                                                                                                |
| `TimeZone`            | [TimeZone](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/timezone.md)                               | Contains time zone information for an Account. For Create and Update calls, this property defines the time zone for an Account object. On a Retrieve call, TimeZone indicates which time zone is in effect for the Account object in question. Without a specific time zone, the Account defaults to Central Standard Time. |

## Related Items

[Schedule a User-Initiated Email Message Send](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/scheduling_a_user_initiated_email_message_send_via_the_web_service_api.md "Scheduling_a_User-Initiated_Email_Message_Send_Via_the_Web_Service_API")