Create App
You can use the REST API to create Apps programatically.Request
POST https://cameratag.com/api/v14/apps.json
Parameters
Below is a list of parameters that this endpoint accepts.
%table %thead %tr %th Parameter %th Accepted Values %th Description %th Required %tbody %tr %td api_key %td a valid user api_key %td All App endpoints require authentcation %td Required %tr %td name %td * %td The name of your application %td Required %tr %td region %td us, eu, ap, sa %td The name of the region in which you would like CameraTag to store your assets. (defaults to "us" if blank) %td Required %tr %td use_domain_auth %td true / false %td Turn on / off domain-based security %td Optional %tr %td domains[] %td * %td The authorized domain(s) for your app. To select more than one pass multiple domains[] params %td Optional %tr %td use_webhook %td true, false %td Turn on / off webhooks %td Optional %tr %td callback_trigger %td processed, approved, rejected, featured %td CameraTag will perform the callback after assets reach a specific state %td Optional %tr %td callback_url %td * %td A URL for the server callback functionality. %td Optional %tr %td use_email %td true, false %td Turn on / off Email notifications %td Optional %tr %td email_trigger %td processed, approved, rejected, featured %td CameraTag send an email after assets reach a specific state %td Optional %tr %td notification_email %td * %td An email to receive asset notifications %td Optional %tr %td publish_signature_required %td true, false %td require a valid signature for publishing of new assets %td Optional %tr %td playback_signature_required %td true, false %td require a valid signature for playback %td Optional %tr %td wall_privacy %td none, all, whitelist, blacklist %td Determines which assets are shown in videowalls connected to this app. %td Optional %tr %td use_ftp %td true, false %td Turn on / off FTP syndication %td Optional %tr %td ftp_trigger %td processed, approved, rejected, featured %td CameraTag will syndicate assets to your FTP account after they have reached the specified state %td Optional %tr %td ftp_server %td * %td A FTP server for FTP syndication %td Optional %tr %td ftp_username %td * %td A FTP user name for FTP syndication %td Optional %tr %td ftp_password %td * %td ftp_password %td Optional %tr %td ftp_directory %td * %td A FTP directory for FTP syndication %td Optional %tr %td ftp_protocol %td ftp, sftp %td %td Optional %tr %td use_s3 %td true, false %td Turn on / off S3 syndication %td Optional %tr %td s3_trigger %td processed, approved, rejected, featured %td CameraTag will syndicate assets to S3 after they have reached the specified state %td Optional %tr %td bucket_name %td * %td The name of your S3 Bucket (for S3 Syndication) %td Optional %tr %td s3_directory %td * %td An optional subdirectry into which assets should be placed %td Optional %tr %td s3_privacy %td public-read, private, authenticated-read %td The privacy settings for assets created in your S3 bucket %td Optional %tr %td s3_use_sse %td true, false %td Use server side encryption on S3 %td Optional %tr %td s3_key %td * %td An AWS Key with access to create objects and set ACLs %td Optional %tr %td s3_secret %td * %td An AWS Secret with access to create objects and set ACLs %td Optional %tr %td use_youtube %td true, false %td Turn on / off YouTube syndication %td Optional %tr %td youtube_trigger %td processed, approved, rejected, featured %td CameraTag will synicate assets after they have reached the sspecified state %td Optional %tr %td youtube_privacy %td public, private %td The privacy setting to videos created in your youtube account %td Optional / %tr / %td preroll_source / %td / %td / %td / %tr / %td preroll_video_uuid / %td / %td / %td / %tr / %td preroll_skip_offset / %td / %td / %td / %tr / %td preroll_click_destination / %td / %td / %td / %tr / %td preroll_impression_tracking_url / %td / %td / %td / %tr / %td preroll_server_url / %td / %td / %td / %tr / %td preroll_server_type / %td / %td / %td / %tr / %td error_image_id / %td / %td / %td / %tr / %td error_video_id / %td / %td / %td %tr %td use_slack %td true, false %td Turn on / off Slack notifications %td Optional %tr %td slack_trigger %td processed, approved, rejected, featured %td CameraTag will notify your slack room after an asset reaches the specified state %td Optional %tr %td slack_url %td * %td The URL provided by the Slack webhook add-on %td Optional %tr %td slack_channel %td * %td The channel you would like us ti post to (starts with a #) %td OptionalExample Response
{
"uuid": "63f9c870-72c4-0130-04c5-123139045d73",
"name": "Homepage",
"callback_url": "https://www.postb.in/1766867905196-5944248966407",
"notification_email": "chris@cameratag.com",
"bucket_name": "cameratagtest",
"crop_length": null,
"s3_privacy": "public-read",
"s3_directory": "terst",
"s3_use_sse": false,
"publish_signature_required": false,
"playback_signature_required": false,
"ftp_server": "danzig-media.smartfile.com",
"ftp_username": "cdanzig",
"ftp_password": "424D.86K/7N?949iyp9;CJ{}=CL{w,Y+",
"ftp_directory": "cameratag/directory/",
"use_ftp": false,
"use_s3": true,
"use_youtube": true,
"ftp_trigger": "processed",
"email_trigger": "processed",
"s3_trigger": "processed",
"youtube_trigger": "processed",
"wall_privacy": "whitelist",
"photo_width": 640,
"photo_height": 480,
"media_factories": [
{
"id": 8,
"uuid": null,
"name": "720p",
"width": 1280,
"height": 720,
"area": 921600,
"extension": "mp4",
"length": "",
"bitrate": null,
"asset_class": "Video",
"is_system": null,
"created_at": "2017-05-07T07:22:58.000Z",
"updated_at": "2017-06-02T02:33:11.000Z",
"camera_id": "63f9c870-72c4-0130-04c5-123139045d73",
"fg_color": null,
"deleted_at": null,
"language": null,
"fps": null,
"offset": null,
"source": "camera",
"media_source": null,
"auto_rotate": true
},
{
"id": 10,
"uuid": null,
"name": "vga_thumb",
"width": 1280,
"height": 720,
"area": 921600,
"extension": "jpg",
"length": "",
"bitrate": null,
"asset_class": "Video",
"is_system": true,
"created_at": "2017-05-07T07:23:16.000Z",
"updated_at": "2017-06-02T02:33:25.000Z",
"camera_id": "63f9c870-72c4-0130-04c5-123139045d73",
"fg_color": null,
"deleted_at": null,
"language": null,
"fps": null,
"offset": null,
"source": "camera",
"media_source": null,
"auto_rotate": true
},
{
"id": 11,
"uuid": null,
"name": "vga_filmstrip",
"width": 1280,
"height": 720,
"area": 921600,
"extension": "jpg",
"length": 30,
"bitrate": null,
"asset_class": "Video",
"is_system": true,
"created_at": "2017-05-07T07:23:17.000Z",
"updated_at": "2017-06-02T02:33:37.000Z",
"camera_id": "63f9c870-72c4-0130-04c5-123139045d73",
"fg_color": null,
"deleted_at": null,
"language": null,
"fps": null,
"offset": null,
"source": "camera",
"media_source": null,
"auto_rotate": true
},
{
"id": 82916,
"uuid": null,
"name": "vertical",
"width": 720,
"height": 1280,
"area": 921600,
"extension": "mp4",
"length": "",
"bitrate": null,
"asset_class": "Video",
"is_system": null,
"created_at": "2019-04-16T13:20:00.000Z",
"updated_at": "2019-04-16T13:20:00.000Z",
"camera_id": "63f9c870-72c4-0130-04c5-123139045d73",
"fg_color": null,
"deleted_at": null,
"language": null,
"fps": null,
"offset": null,
"source": "camera",
"media_source": null,
"auto_rotate": true
},
{
"id": 25,
"uuid": null,
"name": "waveform",
"width": 2000,
"height": 375,
"area": 750000,
"extension": "png",
"length": null,
"bitrate": null,
"asset_class": "Audio",
"is_system": true,
"created_at": "2017-05-07T07:25:21.000Z",
"updated_at": "2017-05-16T14:26:16.000Z",
"camera_id": "63f9c870-72c4-0130-04c5-123139045d73",
"fg_color": null,
"deleted_at": null,
"language": null,
"fps": null,
"offset": null,
"source": "microphone",
"media_source": null,
"auto_rotate": true
},
{
"id": 26,
"uuid": null,
"name": "negative_waveform",
"width": 2000,
"height": 375,
"area": 750000,
"extension": "png",
"length": null,
"bitrate": null,
"asset_class": "Audio",
"is_system": true,
"created_at": "2017-05-07T07:25:21.000Z",
"updated_at": "2017-05-16T14:26:16.000Z",
"camera_id": "63f9c870-72c4-0130-04c5-123139045d73",
"fg_color": null,
"deleted_at": null,
"language": null,
"fps": null,
"offset": null,
"source": "microphone",
"media_source": null,
"auto_rotate": true
},
{
"id": 109876,
"uuid": null,
"name": "Giphy",
"width": 640,
"height": 480,
"area": 307200,
"extension": "gif",
"length": "10",
"bitrate": null,
"asset_class": "Video",
"is_system": null,
"created_at": "2020-05-05T01:01:03.000Z",
"updated_at": "2020-05-05T01:01:03.000Z",
"camera_id": "63f9c870-72c4-0130-04c5-123139045d73",
"fg_color": null,
"deleted_at": null,
"language": null,
"fps": 12.0,
"offset": 0.0,
"source": "camera",
"media_source": null,
"auto_rotate": true
},
{
"id": 27,
"uuid": null,
"name": "photo",
"width": 640,
"height": 480,
"area": 307200,
"extension": "jpg",
"length": null,
"bitrate": null,
"asset_class": "Photo",
"is_system": true,
"created_at": "2017-05-07T07:25:21.000Z",
"updated_at": "2017-05-16T14:26:16.000Z",
"camera_id": "63f9c870-72c4-0130-04c5-123139045d73",
"fg_color": null,
"deleted_at": null,
"language": null,
"fps": null,
"offset": null,
"source": "photobooth",
"media_source": null,
"auto_rotate": true
},
{
"id": 134277,
"uuid": null,
"name": "user_stream",
"width": 640,
"height": 480,
"area": 307200,
"extension": "mp4",
"length": null,
"bitrate": null,
"asset_class": "Video",
"is_system": true,
"created_at": "2020-07-01T10:57:42.000Z",
"updated_at": "2020-07-01T10:57:42.000Z",
"camera_id": "63f9c870-72c4-0130-04c5-123139045d73",
"fg_color": null,
"deleted_at": null,
"language": null,
"fps": null,
"offset": null,
"source": "room",
"media_source": "composite",
"auto_rotate": true
},
{
"id": 134278,
"uuid": null,
"name": "user_thumb",
"width": 640,
"height": 480,
"area": 307200,
"extension": "jpg",
"length": null,
"bitrate": null,
"asset_class": "Video",
"is_system": true,
"created_at": "2020-07-01T10:57:42.000Z",
"updated_at": "2020-07-01T10:57:42.000Z",
"camera_id": "63f9c870-72c4-0130-04c5-123139045d73",
"fg_color": null,
"deleted_at": null,
"language": null,
"fps": null,
"offset": null,
"source": "room",
"media_source": "composite",
"auto_rotate": true
},
{
"id": 134279,
"uuid": null,
"name": "user_filmstrip",
"width": 640,
"height": 480,
"area": 307200,
"extension": "jpg",
"length": 30,
"bitrate": null,
"asset_class": "Video",
"is_system": true,
"created_at": "2020-07-01T10:57:42.000Z",
"updated_at": "2020-07-01T10:57:42.000Z",
"camera_id": "63f9c870-72c4-0130-04c5-123139045d73",
"fg_color": null,
"deleted_at": null,
"language": null,
"fps": null,
"offset": null,
"source": "room",
"media_source": "composite",
"auto_rotate": true
},
{
"id": 366587,
"uuid": null,
"name": "fwefwe",
"width": 640,
"height": 480,
"area": 307200,
"extension": "mp4",
"length": "",
"bitrate": null,
"asset_class": null,
"is_system": null,
"created_at": "2022-06-02T16:02:20.000Z",
"updated_at": "2022-06-02T16:02:20.000Z",
"camera_id": "63f9c870-72c4-0130-04c5-123139045d73",
"fg_color": null,
"deleted_at": null,
"language": null,
"fps": null,
"offset": null,
"source": "room_composite",
"media_source": null,
"auto_rotate": true
},
{
"id": 366588,
"uuid": null,
"name": "fwefweffwef",
"width": 640,
"height": 480,
"area": 307200,
"extension": "mp4",
"length": "",
"bitrate": null,
"asset_class": null,
"is_system": null,
"created_at": "2022-06-02T16:04:19.000Z",
"updated_at": "2022-06-02T16:04:19.000Z",
"camera_id": "63f9c870-72c4-0130-04c5-123139045d73",
"fg_color": null,
"deleted_at": null,
"language": null,
"fps": null,
"offset": null,
"source": "room_streams",
"media_source": null,
"auto_rotate": true
},
{
"id": 92166,
"uuid": null,
"name": "Original",
"width": null,
"height": null,
"area": null,
"extension": null,
"length": null,
"bitrate": null,
"asset_class": "Video",
"is_system": null,
"created_at": "2019-11-25T14:49:10.000Z",
"updated_at": "2019-11-25T14:49:10.000Z",
"camera_id": "63f9c870-72c4-0130-04c5-123139045d73",
"fg_color": null,
"deleted_at": null,
"language": null,
"fps": null,
"offset": null,
"source": "camera",
"media_source": null,
"auto_rotate": true
},
{
"id": 467239,
"uuid": null,
"name": "Captions",
"width": null,
"height": null,
"area": null,
"extension": "VTT",
"length": null,
"bitrate": null,
"asset_class": null,
"is_system": null,
"created_at": "2025-06-04T19:27:36.000Z",
"updated_at": "2025-06-04T19:27:36.000Z",
"camera_id": "63f9c870-72c4-0130-04c5-123139045d73",
"fg_color": null,
"deleted_at": null,
"language": "en-US",
"fps": null,
"offset": null,
"source": "camera",
"media_source": null,
"auto_rotate": true
},
{
"id": 24,
"uuid": null,
"name": "mp3",
"width": null,
"height": null,
"area": null,
"extension": "mp3",
"length": null,
"bitrate": null,
"asset_class": "Audio",
"is_system": true,
"created_at": "2017-05-07T07:25:21.000Z",
"updated_at": "2017-05-07T07:25:21.000Z",
"camera_id": "63f9c870-72c4-0130-04c5-123139045d73",
"fg_color": null,
"deleted_at": null,
"language": null,
"fps": null,
"offset": null,
"source": "microphone",
"media_source": null,
"auto_rotate": true
}
],
"domains": []
}