Save Files Trigger

Create or update a files trigger.

A files trigger runs an action automatically on file storage events — for example notifying the team when a file is uploaded. It fires on OnFileUploaded or OnFileDeleted. This method creates the trigger (or updates it when you pass an existing triggerId); the response returns its id.

This method is on the Hub surface (norbix.hub.files) — call it from admin tooling or IaC.

These examples assume the SDK is installed and your credentials are set as environment variables — each client reads them automatically, so the constructors below take no arguments. See Install a Norbix SDK.

JavaScript / TypeScript

import { Norbix } from '@norbix.ai/ts';
const norbix = new Norbix();

const result = await norbix.hub.files.saveFilesTrigger({
  trigger: {
    type: 'Files',
    when: 'OnFileUploaded',
    name: 'notify-on-upload',
    isEnabled: true,
    action: {
      type: 'email',
      templateId: 'tmpl_5XqvoF4k6I2GfarDBg3zqq',
      deliverySettings: { recipientsSourceType: 'AllUsers' },
    },
  },
});

.NET

using Norbix.Sdk;
using Norbix.Sdk.Types.Hub;

using var client = new NorbixClient();

var result = await client.Files.SaveFilesTriggerAsync(new SaveFilesTrigger
{
    Trigger = new FilesTriggerRequest
    {
        Type = TriggerType.Files,
        When = FilesTriggerType.OnFileUploaded,
        Name = "notify-on-upload",
        IsEnabled = true,
        Action = new TriggerActionEmailDto
        {
            Type = TriggerActionType.Email,
            TemplateId = "tmpl_5XqvoF4k6I2GfarDBg3zqq",
            DeliverySettings = new EmailToAllUsersDeliverySettingsDto
            {
                RecipientsSourceType = EmailCampaignRecipientsSourceTypes.AllUsers,
            },
        },
    },
});

Python

from norbix_python import NorbixHub

norbix = NorbixHub()

result = norbix.files.save_files_trigger(
    trigger={
        "type": "Files",
        "when": "OnFileUploaded",
        "name": "notify-on-upload",
        "isEnabled": True,
        "action": {
            "type": "email",
            "templateId": "tmpl_5XqvoF4k6I2GfarDBg3zqq",
            "deliverySettings": {"recipientsSourceType": "AllUsers"},
        },
    },
)

Go

c, _ := norbix.New(norbix.Options{})
ctx := context.Background()

var result map[string]any
err := c.Hub.Files.SaveFilesTrigger(ctx, map[string]any{
	"trigger": map[string]any{
		"type": "Files",
		"when": "OnFileUploaded",
		"name": "notify-on-upload",
		"isEnabled": true,
		"action": map[string]any{
			"type": "email",
			"templateId": "tmpl_5XqvoF4k6I2GfarDBg3zqq",
			"deliverySettings": map[string]any{"recipientsSourceType": "AllUsers"},
		},
	},
}, &result)

Dart / Flutter

import 'package:norbix/norbix_hub.dart';

final hub = NorbixHub();

final result = await hub.files.saveFilesTrigger(body: {
  'trigger': {
    'type': 'Files',
    'when': 'OnFileUploaded',
    'name': 'notify-on-upload',
    'isEnabled': true,
    'action': {
      'type': 'email',
      'templateId': 'tmpl_5XqvoF4k6I2GfarDBg3zqq',
      'deliverySettings': {'recipientsSourceType': 'AllUsers'},
    },
  },
});

Swift

import NorbixSwift

let client = Norbix()

let result = try await client.hub.files.saveFilesTrigger([
    "trigger": [
        "type": "Files",
        "when": "OnFileUploaded",
        "name": "notify-on-upload",
        "isEnabled": true,
        "action": [
            "type": "email",
            "templateId": "tmpl_5XqvoF4k6I2GfarDBg3zqq",
            "deliverySettings": ["recipientsSourceType": "AllUsers"],
        ],
    ],
])

Kotlin

import dev.norbix.sdk.hub.NorbixHub

val hub = NorbixHub()

val result = hub.files.saveFilesTrigger(mapOf(
    "trigger" to mapOf(
        "type" to "Files",
        "when" to "OnFileUploaded",
        "name" to "notify-on-upload",
        "isEnabled" to true,
        "action" to mapOf(
            "type" to "email",
            "templateId" to "tmpl_5XqvoF4k6I2GfarDBg3zqq",
            "deliverySettings" to mapOf("recipientsSourceType" to "AllUsers"),
        ),
    ),
))

CLI

norbix raw '/{version}/files/triggers' -X POST --body '{"trigger":{"type":"Files","when":"OnFileUploaded","name":"notify-on-upload","isEnabled":true,"action":{"type":"email","templateId":"tmpl_5XqvoF4k6I2GfarDBg3zqq","deliverySettings":{"recipientsSourceType":"AllUsers"}}}}'

Scenarios

The examples above send an email to all users. The action object is where the behaviour lives — here is one working example for every action type (JavaScript; the structure is identical in the other SDKs, only syntax changes as in the tabs above).

Email specific users

Send a templated email to chosen project users when a file is uploaded.

const result = await norbix.hub.files.saveFilesTrigger({
  trigger: {
    type: 'Files',
    when: 'OnFileUploaded',
    name: 'email-team',
    isEnabled: true,
    action: {
      type: 'email',
      templateId: 'tmpl_3bJqQKtPFWfYpVSYnsN3mn',
      deliverySettings: {
        recipientsSourceType: 'SpecifiedUsers',
        userRecipients: ['usr_5hoyo3ThWet5Ik9nc8i8ni', 'usr_3IzD37jxlmrmVhUs9wa7BC'],
      },
    },
  },
});

Email raw addresses

Send the email to fixed addresses (an ops inbox, an external partner) instead of project users.

const result = await norbix.hub.files.saveFilesTrigger({
  trigger: {
    type: 'Files',
    when: 'OnFileUploaded',
    name: 'email-ops',
    isEnabled: true,
    action: {
      type: 'email',
      templateId: 'tmpl_3bJqQKtPFWfYpVSYnsN3mn',
      deliverySettings: {
        recipientsSourceType: 'Email',
        recipients: ['[e-mail]'],
      },
    },
  },
});

Push notification to all users

Send a mobile push from a push template to every user when a file is uploaded.

const result = await norbix.hub.files.saveFilesTrigger({
  trigger: {
    type: 'Files',
    when: 'OnFileUploaded',
    name: 'push-announce',
    isEnabled: true,
    action: {
      type: 'push',
      templateId: 'tmpl_1mq9lRiNGCKMST1hiEQ74M',
      deliverySettings: { recipientsSourceType: 'AllUsers' },
    },
  },
});

SMS to phone numbers

Send a text message to fixed phone numbers.

const result = await norbix.hub.files.saveFilesTrigger({
  trigger: {
    type: 'Files',
    when: 'OnFileUploaded',
    name: 'sms-oncall',
    isEnabled: true,
    action: {
      type: 'sms',
      templateId: 'tmpl_25aiVcKJGOyZmO58pedIeX',
      deliverySettings: {
        recipientsSourceType: 'PhoneNumbers',
        phoneNumbers: ['[phone]'],
      },
    },
  },
});

Call a webhook

Publish the event to your configured webhook destinations. Destinations (URLs, secrets) are managed in the Webhooks module; here you only pick which ones receive it.

const result = await norbix.hub.files.saveFilesTrigger({
  trigger: {
    type: 'Files',
    when: 'OnFileUploaded',
    name: 'webhook-crm',
    isEnabled: true,
    action: {
      type: 'webhookcall',
      deliverySettings: { destinationIds: ['whd_5K6DoEHqml6S0sa7fNuHIQ'] },
    },
  },
});

Run a function

Execute one of your functions from the Code module with the event as input.

const result = await norbix.hub.files.saveFilesTrigger({
  trigger: {
    type: 'Files',
    when: 'OnFileUploaded',
    name: 'run-function',
    isEnabled: true,
    action: {
      type: 'code',
      functionId: 'cf_3VXuCiv7paJwQHkKTFWrVq',
      deliverySettings: {},
    },
  },
});

Send a realtime (SSE) event

Push a server-sent event to connected clients — for live UI updates.

const result = await norbix.hub.files.saveFilesTrigger({
  trigger: {
    type: 'Files',
    when: 'OnFileUploaded',
    name: 'realtime-update',
    isEnabled: true,
    action: {
      type: 'ssecall',
      deliverySettings: {
        audience: 'ToCurrentUser',
        eventName: 'entity.changed',
      },
    },
  },
});

Run a marketplace function

Fire an installed marketplace function; payload passes extra static values.

const result = await norbix.hub.files.saveFilesTrigger({
  trigger: {
    type: 'Files',
    when: 'OnFileUploaded',
    name: 'marketplace-sync',
    isEnabled: true,
    action: {
      type: 'marketplace',
      functionId: 'func_4f3VoJJV9ayAellzC9o58T',
      payload: { plan: 'pro' },
    },
  },
});

For every field of every shape (CC/BCC, campaign timing, timezone settings, token mappings, collection-based audiences), see the API reference. More runnable examples live in the SDK repos on GitHub.

In the dashboard

Manage this visually in Norbix Cloud — see Files → Triggers.

API reference

Full request and response for this endpoint: Save Files Trigger.