Create App
You can use the REST API to create Apps programatically.Request
POST https://staging.cameratag.com/api/v16/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": "https://www.198u39f8ue3fc.com",
"notification_email": "chris@cameratag.com",
"bucket_name": "camertagtest",
"crop_length": null,
"s3_privacy": "public-read",
"s3_directory": "workyworky",
"s3_use_sse": false,
"publish_signature_required": false,
"playback_signature_required": true,
"ftp_server": "danzig-media.smartfile.com",
"ftp_username": "cdanzig",
"ftp_password": "",
"ftp_directory": "cameratag/directory/",
"use_ftp": true,
"use_s3": true,
"use_youtube": true,
"ftp_trigger": "processed",
"email_trigger": "processed",
"s3_trigger": "processed",
"youtube_trigger": "processed",
"wall_privacy": "all",
"photo_width": 640,
"photo_height": 480,
"media_factories": [
{
"id": 133540,
"uuid": null,
"name": "Testerooski",
"width": 1080,
"height": 1080,
"area": 1166400,
"extension": "mp4",
"length": "",
"bitrate": null,
"asset_class": null,
"is_system": null,
"created_at": "2020-07-03T12:38:43.000Z",
"updated_at": "2025-11-10T18:14:28.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": 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": 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": 204210,
"uuid": null,
"name": "waveform",
"width": 2000,
"height": 375,
"area": 750000,
"extension": "png",
"length": null,
"bitrate": null,
"asset_class": null,
"is_system": null,
"created_at": "2025-11-13T02:19:54.000Z",
"updated_at": "2025-11-13T02:19:54.000Z",
"camera_id": "63f9c870-72c4-0130-04c5-123139045d73",
"fg_color": "#c7074b",
"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": 720,
"height": 720,
"area": 518400,
"extension": "jpg",
"length": "",
"bitrate": null,
"asset_class": "Video",
"is_system": true,
"created_at": "2017-05-07T07:23:16.000Z",
"updated_at": "2025-10-10T01:45:48.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": 640,
"height": 640,
"area": 409600,
"extension": "jpg",
"length": 30,
"bitrate": null,
"asset_class": "Video",
"is_system": true,
"created_at": "2017-05-07T07:23:17.000Z",
"updated_at": "2025-11-11T00:57:16.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": 204211,
"uuid": null,
"name": "gif",
"width": 640,
"height": 480,
"area": 307200,
"extension": "gif",
"length": "",
"bitrate": null,
"asset_class": null,
"is_system": null,
"created_at": "2025-11-13T02:20:05.000Z",
"updated_at": "2025-11-13T02:20:05.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": 27,
"uuid": null,
"name": "thumb",
"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": "2025-05-17T00:19:07.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": 135800,
"uuid": null,
"name": "whole_room_video",
"width": 640,
"height": 480,
"area": 307200,
"extension": "mp4",
"length": null,
"bitrate": null,
"asset_class": "Video",
"is_system": true,
"created_at": "2022-02-03T19:56:22.000Z",
"updated_at": "2022-02-03T19:56:22.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": 135801,
"uuid": null,
"name": "whole_room_thumb",
"width": 640,
"height": 480,
"area": 307200,
"extension": "jpg",
"length": null,
"bitrate": null,
"asset_class": "Video",
"is_system": true,
"created_at": "2022-02-03T19:56:22.000Z",
"updated_at": "2022-02-03T19:56:22.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": 135802,
"uuid": null,
"name": "whole_room_filmstrip",
"width": 640,
"height": 480,
"area": 307200,
"extension": "jpg",
"length": 30,
"bitrate": null,
"asset_class": "Video",
"is_system": true,
"created_at": "2022-02-03T19:56:22.000Z",
"updated_at": "2022-02-03T19:56:22.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": 135803,
"uuid": null,
"name": "individual_stream_video",
"width": 640,
"height": 480,
"area": 307200,
"extension": "mp4",
"length": null,
"bitrate": null,
"asset_class": "Video",
"is_system": true,
"created_at": "2022-02-03T19:56:22.000Z",
"updated_at": "2022-02-03T19:56:22.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": 135804,
"uuid": null,
"name": "individual_stream_thumb",
"width": 640,
"height": 480,
"area": 307200,
"extension": "jpg",
"length": null,
"bitrate": null,
"asset_class": "Video",
"is_system": true,
"created_at": "2022-02-03T19:56:22.000Z",
"updated_at": "2022-02-03T19:56:22.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": 135805,
"uuid": null,
"name": "individual_stream_filmstrip",
"width": 640,
"height": 480,
"area": 307200,
"extension": "jpg",
"length": 30,
"bitrate": null,
"asset_class": "Video",
"is_system": true,
"created_at": "2022-02-03T19:56:22.000Z",
"updated_at": "2022-02-03T19:56:22.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": 204208,
"uuid": null,
"name": "Moderation",
"width": null,
"height": null,
"area": null,
"extension": null,
"length": null,
"bitrate": null,
"asset_class": null,
"is_system": null,
"created_at": "2025-10-14T17:47:54.000Z",
"updated_at": "2025-10-14T17:47:54.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": 204212,
"uuid": null,
"name": "audio",
"width": null,
"height": null,
"area": null,
"extension": "mp3",
"length": "",
"bitrate": null,
"asset_class": null,
"is_system": null,
"created_at": "2025-11-13T02:20:20.000Z",
"updated_at": "2025-11-13T02:20:20.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": 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
},
{
"id": 204101,
"uuid": null,
"name": "captions",
"width": null,
"height": null,
"area": null,
"extension": "VTT",
"length": null,
"bitrate": null,
"asset_class": null,
"is_system": null,
"created_at": "2024-02-08T02:38:43.000Z",
"updated_at": "2024-02-08T02:38:43.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": 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": 133541,
"uuid": null,
"name": "Original",
"width": null,
"height": null,
"area": null,
"extension": null,
"length": null,
"bitrate": null,
"asset_class": null,
"is_system": null,
"created_at": "2021-08-02T15:21:13.000Z",
"updated_at": "2021-08-02T15:21:13.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": 204209,
"uuid": null,
"name": "Moderation",
"width": null,
"height": null,
"area": null,
"extension": null,
"length": null,
"bitrate": null,
"asset_class": null,
"is_system": null,
"created_at": "2025-10-14T18:39:08.000Z",
"updated_at": "2025-10-14T18:39:08.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
}
],
"domains": []
}