FIfiles
notifications
Notifications

Create Notification

Changed on

Create Notification

post/notifications

Request

  • Base URL
    https://app.files.com/api/rest/v1
  • URL
    https://app.files.com/api/rest/v1/notifications
  • Auth
    none declared

Request body multipart/form-data

user_idinteger

The id of the user to notify. Provide user_id, username or group_id.

notify_on_copyboolean

If true, copying or moving resources into this path will trigger a notification, in addition to just uploads.

notify_on_deleteboolean

Trigger on files deleted in this path?

notify_on_downloadboolean

Trigger on files downloaded in this path?

notify_on_moveboolean

Trigger on files moved to this path?

notify_on_uploadboolean

Trigger on files created/uploaded/updated/changed in this path?

notify_user_actionsboolean

If true actions initiated by the user will still result in a notification

recursiveboolean

If true, enable notifications for each subfolder in this path

send_intervalstring

The time interval that notifications are aggregated by. Can be five_minutes, fifteen_minutes, hourly, or daily.

subjectstring

Custom subject line to use for notification emails

messagestring

Custom message to include in notification emails

triggering_filenamesstring[]

Array of filenames (possibly with wildcards) to scope trigger

triggering_group_idsinteger[]

If set, will only notify on actions made by a member of one of the specified groups

triggering_user_idsinteger[]

If set, will only notify on actions made one of the specified users

trigger_by_share_recipientsboolean

Notify when actions are performed by a share recipient?

workspace_idinteger

Workspace ID. 0 means the default workspace.

group_idinteger

The ID of the group to notify. Provide user_id, username or group_id.

group_idsstring

Group IDs when the notification requires multiple groups. If sent as a string, it should be comma-delimited.

pathstring

Path

usernamestring

The username of the user to notify. Provide user_id, username or group_id.

Example request

{
  "notify_on_delete": true,
  "notify_on_download": true,
  "notify_on_move": true,
  "notify_on_upload": true,
  "send_interval": "daily",
  "subject": "Vendor A CSV Activity",
  "message": "custom notification email message",
  "triggering_filenames": [
    "*.jpg",
    "notify_file.txt"
  ],
  "triggering_group_ids": [
    1
  ],
  "triggering_user_ids": [
    1
  ],
  "trigger_by_share_recipients": true,
  "workspace_id": 1
}

Response

The Notifications object.

idinteger

Notification ID

pathstring

Folder path to notify on

group_idinteger

ID of Group to receive notifications

group_namestring

Group name, if a Group ID is set

group_idsinteger[]

Group IDs when the notification requires multiple groups

group_namesstring[]

Group names when the notification requires multiple groups

triggering_group_idsinteger[]

If set, will only notify on actions made by a member of one of the specified groups

triggering_user_idsinteger[]

If set, will only notify on actions made one of the specified users

trigger_by_share_recipientsboolean

Notify when actions are performed by a share recipient?

notify_user_actionsboolean

If true, will send notifications about a user's own activity to that user. If false, only activity performed by other users (or anonymous users) will be sent in notifications.

notify_on_copyboolean

Trigger on files copied to this path?

notify_on_deleteboolean

Trigger on files deleted in this path?

notify_on_downloadboolean

Trigger on files downloaded in this path?

notify_on_moveboolean

Trigger on files moved to this path?

notify_on_uploadboolean

Trigger on files created/uploaded/updated/changed in this path?

recursiveboolean

Apply notification recursively? This will enable notifications for each subfolder.

send_interval'five_minutes' | 'fifteen_minutes' | 'hourly' | 'daily'

The time interval that notifications are aggregated to

subjectstring

Custom subject line to use for notification emails

messagestring

Custom message to include in notification emails

triggering_filenamesstring[]

Array of filenames (possibly with wildcards) to scope trigger

workspace_idinteger

Workspace ID. 0 means the default workspace.

unsubscribedboolean

Is the user unsubscribed from this notification?

unsubscribed_reason'none' | 'unsubscribe_link_clicked' | 'mail_bounced' | 'mail_marked_as_spam'

The reason that the user unsubscribed

user_idinteger

Notification user ID

usernamestring

Notification username

suppressed_emailboolean

If true, it means that the recipient at this user's email address has manually unsubscribed from all emails, or had their email "hard bounce", which means that we are unable to send mail to this user's current email address. Notifications will resume if the user changes their email address.

Example response

{
  "id": 1,
  "path": "path",
  "group_name": "example",
  "group_ids": [
    1
  ],
  "group_names": [
    "example"
  ],
  "triggering_group_ids": [
    1
  ],
  "triggering_user_ids": [
    1
  ],
  "trigger_by_share_recipients": true,
  "notify_user_actions": true,
  "notify_on_copy": true,
  "notify_on_delete": true,
  "notify_on_download": true,
  "notify_on_move": true,
  "notify_on_upload": true,
  "recursive": true,
  "send_interval": "fifteen_minutes",
  "subject": "Vendor A CSV Activity",
  "message": "custom notification email message",
  "triggering_filenames": [
    "*.jpg",
    "notify_file.txt"
  ],
  "workspace_id": 1,
  "unsubscribed": true,
  "unsubscribed_reason": "example",
  "user_id": 1,
  "username": "User",
  "suppressed_email": true
}

Changes