# CreateProgram
<a name="API_CreateProgram"></a>

Creates a program within a channel. For information about programs, see [Working with programs](https://docs.aws.amazon.com/mediatailor/latest/ug/channel-assembly-programs.html) in the *MediaTailor User Guide*.

## Request Syntax
<a name="API_CreateProgram_RequestSyntax"></a>

```
POST /channel/ChannelName/program/ProgramName HTTP/1.1
Content-type: application/json

{
   "AdBreaks": [ 
      { 
         "AdBreakMetadata": [ 
            { 
               "Key": "string",
               "Value": "string"
            }
         ],
         "MessageType": "string",
         "OffsetMillis": number,
         "Slate": { 
            "SourceLocationName": "string",
            "VodSourceName": "string"
         },
         "SpliceInsertMessage": { 
            "AvailNum": number,
            "AvailsExpected": number,
            "SpliceEventId": number,
            "UniqueProgramId": number
         },
         "TimeSignalMessage": { 
            "SegmentationDescriptors": [ 
               { 
                  "SegmentationEventId": number,
                  "SegmentationTypeId": number,
                  "SegmentationUpid": "string",
                  "SegmentationUpidType": number,
                  "SegmentNum": number,
                  "SegmentsExpected": number,
                  "SubSegmentNum": number,
                  "SubSegmentsExpected": number
               }
            ]
         }
      }
   ],
   "AudienceMedia": [ 
      { 
         "AlternateMedia": [ 
            { 
               "AdBreaks": [ 
                  { 
                     "AdBreakMetadata": [ 
                        { 
                           "Key": "string",
                           "Value": "string"
                        }
                     ],
                     "MessageType": "string",
                     "OffsetMillis": number,
                     "Slate": { 
                        "SourceLocationName": "string",
                        "VodSourceName": "string"
                     },
                     "SpliceInsertMessage": { 
                        "AvailNum": number,
                        "AvailsExpected": number,
                        "SpliceEventId": number,
                        "UniqueProgramId": number
                     },
                     "TimeSignalMessage": { 
                        "SegmentationDescriptors": [ 
                           { 
                              "SegmentationEventId": number,
                              "SegmentationTypeId": number,
                              "SegmentationUpid": "string",
                              "SegmentationUpidType": number,
                              "SegmentNum": number,
                              "SegmentsExpected": number,
                              "SubSegmentNum": number,
                              "SubSegmentsExpected": number
                           }
                        ]
                     }
                  }
               ],
               "ClipRange": { 
                  "EndOffsetMillis": number,
                  "StartOffsetMillis": number
               },
               "DurationMillis": number,
               "LiveSourceName": "string",
               "ScheduledStartTimeMillis": number,
               "SourceLocationName": "string",
               "VodSourceName": "string"
            }
         ],
         "Audience": "string"
      }
   ],
   "LiveSourceName": "string",
   "ScheduleConfiguration": { 
      "ClipRange": { 
         "EndOffsetMillis": number,
         "StartOffsetMillis": number
      },
      "Transition": { 
         "DurationMillis": number,
         "RelativePosition": "string",
         "RelativeProgram": "string",
         "ScheduledStartTimeMillis": number,
         "Type": "string"
      }
   },
   "SourceLocationName": "string",
   "VodSourceName": "string"
}
```

## URI Request Parameters
<a name="API_CreateProgram_RequestParameters"></a>

The request uses the following URI parameters.

 ** [ChannelName](#API_CreateProgram_RequestSyntax) **   <a name="mediatailor-CreateProgram-request-uri-ChannelName"></a>
The name of the channel for this Program.  
Required: Yes

 ** [ProgramName](#API_CreateProgram_RequestSyntax) **   <a name="mediatailor-CreateProgram-request-uri-ProgramName"></a>
The name of the Program.  
Required: Yes

## Request Body
<a name="API_CreateProgram_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [AdBreaks](#API_CreateProgram_RequestSyntax) **   <a name="mediatailor-CreateProgram-request-AdBreaks"></a>
The ad break configuration settings.  
Type: Array of [AdBreak](API_AdBreak.md) objects  
Required: No

 ** [AudienceMedia](#API_CreateProgram_RequestSyntax) **   <a name="mediatailor-CreateProgram-request-AudienceMedia"></a>
The list of AudienceMedia defined in program.  
Type: Array of [AudienceMedia](API_AudienceMedia.md) objects  
Required: No

 ** [LiveSourceName](#API_CreateProgram_RequestSyntax) **   <a name="mediatailor-CreateProgram-request-LiveSourceName"></a>
The name of the LiveSource for this Program.  
Type: String  
Required: No

 ** [ScheduleConfiguration](#API_CreateProgram_RequestSyntax) **   <a name="mediatailor-CreateProgram-request-ScheduleConfiguration"></a>
The schedule configuration settings.  
Type: [ScheduleConfiguration](API_ScheduleConfiguration.md) object  
Required: Yes

 ** [SourceLocationName](#API_CreateProgram_RequestSyntax) **   <a name="mediatailor-CreateProgram-request-SourceLocationName"></a>
The name of the source location.  
Type: String  
Required: Yes

 ** [VodSourceName](#API_CreateProgram_RequestSyntax) **   <a name="mediatailor-CreateProgram-request-VodSourceName"></a>
The name that's used to refer to a VOD source.  
Type: String  
Required: No

## Response Syntax
<a name="API_CreateProgram_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "AdBreaks": [ 
      { 
         "AdBreakMetadata": [ 
            { 
               "Key": "string",
               "Value": "string"
            }
         ],
         "MessageType": "string",
         "OffsetMillis": number,
         "Slate": { 
            "SourceLocationName": "string",
            "VodSourceName": "string"
         },
         "SpliceInsertMessage": { 
            "AvailNum": number,
            "AvailsExpected": number,
            "SpliceEventId": number,
            "UniqueProgramId": number
         },
         "TimeSignalMessage": { 
            "SegmentationDescriptors": [ 
               { 
                  "SegmentationEventId": number,
                  "SegmentationTypeId": number,
                  "SegmentationUpid": "string",
                  "SegmentationUpidType": number,
                  "SegmentNum": number,
                  "SegmentsExpected": number,
                  "SubSegmentNum": number,
                  "SubSegmentsExpected": number
               }
            ]
         }
      }
   ],
   "Arn": "string",
   "AudienceMedia": [ 
      { 
         "AlternateMedia": [ 
            { 
               "AdBreaks": [ 
                  { 
                     "AdBreakMetadata": [ 
                        { 
                           "Key": "string",
                           "Value": "string"
                        }
                     ],
                     "MessageType": "string",
                     "OffsetMillis": number,
                     "Slate": { 
                        "SourceLocationName": "string",
                        "VodSourceName": "string"
                     },
                     "SpliceInsertMessage": { 
                        "AvailNum": number,
                        "AvailsExpected": number,
                        "SpliceEventId": number,
                        "UniqueProgramId": number
                     },
                     "TimeSignalMessage": { 
                        "SegmentationDescriptors": [ 
                           { 
                              "SegmentationEventId": number,
                              "SegmentationTypeId": number,
                              "SegmentationUpid": "string",
                              "SegmentationUpidType": number,
                              "SegmentNum": number,
                              "SegmentsExpected": number,
                              "SubSegmentNum": number,
                              "SubSegmentsExpected": number
                           }
                        ]
                     }
                  }
               ],
               "ClipRange": { 
                  "EndOffsetMillis": number,
                  "StartOffsetMillis": number
               },
               "DurationMillis": number,
               "LiveSourceName": "string",
               "ScheduledStartTimeMillis": number,
               "SourceLocationName": "string",
               "VodSourceName": "string"
            }
         ],
         "Audience": "string"
      }
   ],
   "ChannelName": "string",
   "ClipRange": { 
      "EndOffsetMillis": number,
      "StartOffsetMillis": number
   },
   "CreationTime": number,
   "DurationMillis": number,
   "LiveSourceName": "string",
   "ProgramName": "string",
   "ScheduledStartTime": number,
   "SourceLocationName": "string",
   "VodSourceName": "string"
}
```

## Response Elements
<a name="API_CreateProgram_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [AdBreaks](#API_CreateProgram_ResponseSyntax) **   <a name="mediatailor-CreateProgram-response-AdBreaks"></a>
The ad break configuration settings.  
Type: Array of [AdBreak](API_AdBreak.md) objects

 ** [Arn](#API_CreateProgram_ResponseSyntax) **   <a name="mediatailor-CreateProgram-response-Arn"></a>
The ARN to assign to the program.  
Type: String

 ** [AudienceMedia](#API_CreateProgram_ResponseSyntax) **   <a name="mediatailor-CreateProgram-response-AudienceMedia"></a>
The list of AudienceMedia defined in program.  
Type: Array of [AudienceMedia](API_AudienceMedia.md) objects

 ** [ChannelName](#API_CreateProgram_ResponseSyntax) **   <a name="mediatailor-CreateProgram-response-ChannelName"></a>
The name to assign to the channel for this program.  
Type: String

 ** [ClipRange](#API_CreateProgram_ResponseSyntax) **   <a name="mediatailor-CreateProgram-response-ClipRange"></a>
The clip range configuration settings.  
Type: [ClipRange](API_ClipRange.md) object

 ** [CreationTime](#API_CreateProgram_ResponseSyntax) **   <a name="mediatailor-CreateProgram-response-CreationTime"></a>
The time the program was created.  
Type: Timestamp

 ** [DurationMillis](#API_CreateProgram_ResponseSyntax) **   <a name="mediatailor-CreateProgram-response-DurationMillis"></a>
The duration of the live program in milliseconds.  
Type: Long

 ** [LiveSourceName](#API_CreateProgram_ResponseSyntax) **   <a name="mediatailor-CreateProgram-response-LiveSourceName"></a>
The name of the LiveSource for this Program.  
Type: String

 ** [ProgramName](#API_CreateProgram_ResponseSyntax) **   <a name="mediatailor-CreateProgram-response-ProgramName"></a>
The name to assign to this program.  
Type: String

 ** [ScheduledStartTime](#API_CreateProgram_ResponseSyntax) **   <a name="mediatailor-CreateProgram-response-ScheduledStartTime"></a>
The scheduled start time for this Program.  
Type: Timestamp

 ** [SourceLocationName](#API_CreateProgram_ResponseSyntax) **   <a name="mediatailor-CreateProgram-response-SourceLocationName"></a>
The name to assign to the source location for this program.  
Type: String

 ** [VodSourceName](#API_CreateProgram_ResponseSyntax) **   <a name="mediatailor-CreateProgram-response-VodSourceName"></a>
The name that's used to refer to a VOD source.  
Type: String

## Errors
<a name="API_CreateProgram_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

## See Also
<a name="API_CreateProgram_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediatailor-2018-04-23/CreateProgram) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediatailor-2018-04-23/CreateProgram) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediatailor-2018-04-23/CreateProgram) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediatailor-2018-04-23/CreateProgram) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediatailor-2018-04-23/CreateProgram) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediatailor-2018-04-23/CreateProgram) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediatailor-2018-04-23/CreateProgram) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediatailor-2018-04-23/CreateProgram) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediatailor-2018-04-23/CreateProgram) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediatailor-2018-04-23/CreateProgram)