Create App
You can use the REST API to create Apps programatically.Request
POST https://www.cameratag.com/api/v15/apps.json
Parameters
Below is a list of parameters that this endpoint accepts.
| Parameter | Accepted Values | Description | Required |
|---|---|---|---|
| api_key | a valid user api_key | All App endpoints require authentcation | Required |
| name | * | The name of your application | Required |
| region | us, eu, ap, sa | The name of the region in which you would like CameraTag to store your assets. (defaults to "us" if blank) | Required |
| use_domain_auth | true / false | Turn on / off domain-based security | Optional |
| domains[] | * | The authorized domain(s) for your app. To select more than one pass multiple domains[] params | Optional |
| use_webhook | true, false | Turn on / off webhooks | Optional |
| callback_trigger | processed, approved, rejected, featured | CameraTag will perform the callback after assets reach a specific state | Optional |
| callback_url | * | A URL for the server callback functionality. | Optional |
| use_email | true, false | Turn on / off Email notifications | Optional |
| email_trigger | processed, approved, rejected, featured | CameraTag send an email after assets reach a specific state | Optional |
| notification_email | * | An email to receive asset notifications | Optional |
| publish_signature_required | true, false | require a valid signature for publishing of new assets | Optional |
| playback_signature_required | true, false | require a valid signature for playback | Optional |
| wall_privacy | none, all, whitelist, blacklist | Determines which assets are shown in videowalls connected to this app. | Optional |
| use_ftp | true, false | Turn on / off FTP syndication | Optional |
| ftp_trigger | processed, approved, rejected, featured | CameraTag will syndicate assets to your FTP account after they have reached the specified state | Optional |
| ftp_server | * | A FTP server for FTP syndication | Optional |
| ftp_username | * | A FTP user name for FTP syndication | Optional |
| ftp_password | * | ftp_password | Optional |
| ftp_directory | * | A FTP directory for FTP syndication | Optional |
| ftp_protocol | ftp, sftp | Optional | |
| use_s3 | true, false | Turn on / off S3 syndication | Optional |
| s3_trigger | processed, approved, rejected, featured | CameraTag will syndicate assets to S3 after they have reached the specified state | Optional |
| bucket_name | * | The name of your S3 Bucket (for S3 Syndication) | Optional |
| s3_directory | * | An optional subdirectry into which assets should be placed | Optional |
| s3_privacy | public-read, private, authenticated-read | The privacy settings for assets created in your S3 bucket | Optional |
| s3_use_sse | true, false | Use server side encryption on S3 | Optional |
| s3_key | * | An AWS Key with access to create objects and set ACLs | Optional |
| s3_secret | * | An AWS Secret with access to create objects and set ACLs | Optional |
| use_youtube | true, false | Turn on / off YouTube syndication | Optional |
| youtube_trigger | processed, approved, rejected, featured | CameraTag will synicate assets after they have reached the sspecified state | Optional |
| youtube_privacy | public, private | The privacy setting to videos created in your youtube account | Optional |
| use_slack | true, false | Turn on / off Slack notifications | Optional |
| slack_trigger | processed, approved, rejected, featured | CameraTag will notify your slack room after an asset reaches the specified state | Optional |
| slack_url | * | The URL provided by the Slack webhook add-on | Optional |
| slack_channel | * | The channel you would like us ti post to (starts with a #) | Optional |
Example Response
{
"uuid": "63f9c870-72c4-0130-04c5-123139045d73",
"name": "Homepage",
"callback_url": "http://postb.in/4c5DrNQy",
"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": [
]
}