1. Packages
  2. Packages
  3. Auth0 Provider
  4. API Docs
  5. Action
Viewing docs for Auth0 v2.24.3 (Older version)
published on Monday, Mar 9, 2026 by Pulumi
auth0 logo
Viewing docs for Auth0 v2.24.3 (Older version)
published on Monday, Mar 9, 2026 by Pulumi

    Actions are secure, tenant-specific, versioned functions written in Node.js that execute at certain points during the Auth0 runtime. Actions are used to customize and extend Auth0’s capabilities with custom logic.

    Create Action Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new Action(name: string, args: ActionArgs, opts?: CustomResourceOptions);
    @overload
    def Action(resource_name: str,
               args: ActionArgs,
               opts: Optional[ResourceOptions] = None)
    
    @overload
    def Action(resource_name: str,
               opts: Optional[ResourceOptions] = None,
               code: Optional[str] = None,
               supported_triggers: Optional[ActionSupportedTriggersArgs] = None,
               dependencies: Optional[Sequence[ActionDependencyArgs]] = None,
               deploy: Optional[bool] = None,
               name: Optional[str] = None,
               runtime: Optional[str] = None,
               secrets: Optional[Sequence[ActionSecretArgs]] = None)
    func NewAction(ctx *Context, name string, args ActionArgs, opts ...ResourceOption) (*Action, error)
    public Action(string name, ActionArgs args, CustomResourceOptions? opts = null)
    public Action(String name, ActionArgs args)
    public Action(String name, ActionArgs args, CustomResourceOptions options)
    
    type: auth0:Action
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    

    Parameters

    name string
    The unique name of the resource.
    args ActionArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args ActionArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args ActionArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args ActionArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args ActionArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var actionResource = new Auth0.Action("actionResource", new()
    {
        Code = "string",
        SupportedTriggers = new Auth0.Inputs.ActionSupportedTriggersArgs
        {
            Id = "string",
            Version = "string",
        },
        Dependencies = new[]
        {
            new Auth0.Inputs.ActionDependencyArgs
            {
                Name = "string",
                Version = "string",
            },
        },
        Deploy = false,
        Name = "string",
        Runtime = "string",
        Secrets = new[]
        {
            new Auth0.Inputs.ActionSecretArgs
            {
                Name = "string",
                Value = "string",
            },
        },
    });
    
    example, err := auth0.NewAction(ctx, "actionResource", &auth0.ActionArgs{
    	Code: pulumi.String("string"),
    	SupportedTriggers: &auth0.ActionSupportedTriggersArgs{
    		Id:      pulumi.String("string"),
    		Version: pulumi.String("string"),
    	},
    	Dependencies: auth0.ActionDependencyArray{
    		&auth0.ActionDependencyArgs{
    			Name:    pulumi.String("string"),
    			Version: pulumi.String("string"),
    		},
    	},
    	Deploy:  pulumi.Bool(false),
    	Name:    pulumi.String("string"),
    	Runtime: pulumi.String("string"),
    	Secrets: auth0.ActionSecretArray{
    		&auth0.ActionSecretArgs{
    			Name:  pulumi.String("string"),
    			Value: pulumi.String("string"),
    		},
    	},
    })
    
    var actionResource = new Action("actionResource", ActionArgs.builder()
        .code("string")
        .supportedTriggers(ActionSupportedTriggersArgs.builder()
            .id("string")
            .version("string")
            .build())
        .dependencies(ActionDependencyArgs.builder()
            .name("string")
            .version("string")
            .build())
        .deploy(false)
        .name("string")
        .runtime("string")
        .secrets(ActionSecretArgs.builder()
            .name("string")
            .value("string")
            .build())
        .build());
    
    action_resource = auth0.Action("actionResource",
        code="string",
        supported_triggers={
            "id": "string",
            "version": "string",
        },
        dependencies=[{
            "name": "string",
            "version": "string",
        }],
        deploy=False,
        name="string",
        runtime="string",
        secrets=[{
            "name": "string",
            "value": "string",
        }])
    
    const actionResource = new auth0.Action("actionResource", {
        code: "string",
        supportedTriggers: {
            id: "string",
            version: "string",
        },
        dependencies: [{
            name: "string",
            version: "string",
        }],
        deploy: false,
        name: "string",
        runtime: "string",
        secrets: [{
            name: "string",
            value: "string",
        }],
    });
    
    type: auth0:Action
    properties:
        code: string
        dependencies:
            - name: string
              version: string
        deploy: false
        name: string
        runtime: string
        secrets:
            - name: string
              value: string
        supportedTriggers:
            id: string
            version: string
    

    Action Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The Action resource accepts the following input properties:

    Code string
    The source code of the action.
    SupportedTriggers ActionSupportedTriggers
    List of triggers that this action supports. At this time, an action can only target a single trigger at a time. Read Retrieving the set of triggers available within actions to retrieve the latest trigger versions supported.
    Dependencies List<ActionDependency>
    List of third party npm modules, and their versions, that this action depends on.
    Deploy bool
    Deploying an action will create a new immutable version of the action. If the action is currently bound to a trigger, then the system will begin executing the newly deployed version of the action immediately.
    Name string
    The name of the action.
    Runtime string
    The Node runtime. Defaults to node12. Possible values are: node12, node16, node18 (beta) or node18-actions (GA).
    Secrets List<ActionSecret>
    List of secrets that are included in an action or a version of an action.
    Code string
    The source code of the action.
    SupportedTriggers ActionSupportedTriggersArgs
    List of triggers that this action supports. At this time, an action can only target a single trigger at a time. Read Retrieving the set of triggers available within actions to retrieve the latest trigger versions supported.
    Dependencies []ActionDependencyArgs
    List of third party npm modules, and their versions, that this action depends on.
    Deploy bool
    Deploying an action will create a new immutable version of the action. If the action is currently bound to a trigger, then the system will begin executing the newly deployed version of the action immediately.
    Name string
    The name of the action.
    Runtime string
    The Node runtime. Defaults to node12. Possible values are: node12, node16, node18 (beta) or node18-actions (GA).
    Secrets []ActionSecretArgs
    List of secrets that are included in an action or a version of an action.
    code String
    The source code of the action.
    supportedTriggers ActionSupportedTriggers
    List of triggers that this action supports. At this time, an action can only target a single trigger at a time. Read Retrieving the set of triggers available within actions to retrieve the latest trigger versions supported.
    dependencies List<ActionDependency>
    List of third party npm modules, and their versions, that this action depends on.
    deploy Boolean
    Deploying an action will create a new immutable version of the action. If the action is currently bound to a trigger, then the system will begin executing the newly deployed version of the action immediately.
    name String
    The name of the action.
    runtime String
    The Node runtime. Defaults to node12. Possible values are: node12, node16, node18 (beta) or node18-actions (GA).
    secrets List<ActionSecret>
    List of secrets that are included in an action or a version of an action.
    code string
    The source code of the action.
    supportedTriggers ActionSupportedTriggers
    List of triggers that this action supports. At this time, an action can only target a single trigger at a time. Read Retrieving the set of triggers available within actions to retrieve the latest trigger versions supported.
    dependencies ActionDependency[]
    List of third party npm modules, and their versions, that this action depends on.
    deploy boolean
    Deploying an action will create a new immutable version of the action. If the action is currently bound to a trigger, then the system will begin executing the newly deployed version of the action immediately.
    name string
    The name of the action.
    runtime string
    The Node runtime. Defaults to node12. Possible values are: node12, node16, node18 (beta) or node18-actions (GA).
    secrets ActionSecret[]
    List of secrets that are included in an action or a version of an action.
    code str
    The source code of the action.
    supported_triggers ActionSupportedTriggersArgs
    List of triggers that this action supports. At this time, an action can only target a single trigger at a time. Read Retrieving the set of triggers available within actions to retrieve the latest trigger versions supported.
    dependencies Sequence[ActionDependencyArgs]
    List of third party npm modules, and their versions, that this action depends on.
    deploy bool
    Deploying an action will create a new immutable version of the action. If the action is currently bound to a trigger, then the system will begin executing the newly deployed version of the action immediately.
    name str
    The name of the action.
    runtime str
    The Node runtime. Defaults to node12. Possible values are: node12, node16, node18 (beta) or node18-actions (GA).
    secrets Sequence[ActionSecretArgs]
    List of secrets that are included in an action or a version of an action.
    code String
    The source code of the action.
    supportedTriggers Property Map
    List of triggers that this action supports. At this time, an action can only target a single trigger at a time. Read Retrieving the set of triggers available within actions to retrieve the latest trigger versions supported.
    dependencies List<Property Map>
    List of third party npm modules, and their versions, that this action depends on.
    deploy Boolean
    Deploying an action will create a new immutable version of the action. If the action is currently bound to a trigger, then the system will begin executing the newly deployed version of the action immediately.
    name String
    The name of the action.
    runtime String
    The Node runtime. Defaults to node12. Possible values are: node12, node16, node18 (beta) or node18-actions (GA).
    secrets List<Property Map>
    List of secrets that are included in an action or a version of an action.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the Action resource produces the following output properties:

    Id string
    The provider-assigned unique ID for this managed resource.
    VersionId string
    Version ID of the action. This value is available if deploy is set to true.
    Id string
    The provider-assigned unique ID for this managed resource.
    VersionId string
    Version ID of the action. This value is available if deploy is set to true.
    id String
    The provider-assigned unique ID for this managed resource.
    versionId String
    Version ID of the action. This value is available if deploy is set to true.
    id string
    The provider-assigned unique ID for this managed resource.
    versionId string
    Version ID of the action. This value is available if deploy is set to true.
    id str
    The provider-assigned unique ID for this managed resource.
    version_id str
    Version ID of the action. This value is available if deploy is set to true.
    id String
    The provider-assigned unique ID for this managed resource.
    versionId String
    Version ID of the action. This value is available if deploy is set to true.

    Look up Existing Action Resource

    Get an existing Action resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: ActionState, opts?: CustomResourceOptions): Action
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            code: Optional[str] = None,
            dependencies: Optional[Sequence[ActionDependencyArgs]] = None,
            deploy: Optional[bool] = None,
            name: Optional[str] = None,
            runtime: Optional[str] = None,
            secrets: Optional[Sequence[ActionSecretArgs]] = None,
            supported_triggers: Optional[ActionSupportedTriggersArgs] = None,
            version_id: Optional[str] = None) -> Action
    func GetAction(ctx *Context, name string, id IDInput, state *ActionState, opts ...ResourceOption) (*Action, error)
    public static Action Get(string name, Input<string> id, ActionState? state, CustomResourceOptions? opts = null)
    public static Action get(String name, Output<String> id, ActionState state, CustomResourceOptions options)
    resources:  _:    type: auth0:Action    get:      id: ${id}
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    Code string
    The source code of the action.
    Dependencies List<ActionDependency>
    List of third party npm modules, and their versions, that this action depends on.
    Deploy bool
    Deploying an action will create a new immutable version of the action. If the action is currently bound to a trigger, then the system will begin executing the newly deployed version of the action immediately.
    Name string
    The name of the action.
    Runtime string
    The Node runtime. Defaults to node12. Possible values are: node12, node16, node18 (beta) or node18-actions (GA).
    Secrets List<ActionSecret>
    List of secrets that are included in an action or a version of an action.
    SupportedTriggers ActionSupportedTriggers
    List of triggers that this action supports. At this time, an action can only target a single trigger at a time. Read Retrieving the set of triggers available within actions to retrieve the latest trigger versions supported.
    VersionId string
    Version ID of the action. This value is available if deploy is set to true.
    Code string
    The source code of the action.
    Dependencies []ActionDependencyArgs
    List of third party npm modules, and their versions, that this action depends on.
    Deploy bool
    Deploying an action will create a new immutable version of the action. If the action is currently bound to a trigger, then the system will begin executing the newly deployed version of the action immediately.
    Name string
    The name of the action.
    Runtime string
    The Node runtime. Defaults to node12. Possible values are: node12, node16, node18 (beta) or node18-actions (GA).
    Secrets []ActionSecretArgs
    List of secrets that are included in an action or a version of an action.
    SupportedTriggers ActionSupportedTriggersArgs
    List of triggers that this action supports. At this time, an action can only target a single trigger at a time. Read Retrieving the set of triggers available within actions to retrieve the latest trigger versions supported.
    VersionId string
    Version ID of the action. This value is available if deploy is set to true.
    code String
    The source code of the action.
    dependencies List<ActionDependency>
    List of third party npm modules, and their versions, that this action depends on.
    deploy Boolean
    Deploying an action will create a new immutable version of the action. If the action is currently bound to a trigger, then the system will begin executing the newly deployed version of the action immediately.
    name String
    The name of the action.
    runtime String
    The Node runtime. Defaults to node12. Possible values are: node12, node16, node18 (beta) or node18-actions (GA).
    secrets List<ActionSecret>
    List of secrets that are included in an action or a version of an action.
    supportedTriggers ActionSupportedTriggers
    List of triggers that this action supports. At this time, an action can only target a single trigger at a time. Read Retrieving the set of triggers available within actions to retrieve the latest trigger versions supported.
    versionId String
    Version ID of the action. This value is available if deploy is set to true.
    code string
    The source code of the action.
    dependencies ActionDependency[]
    List of third party npm modules, and their versions, that this action depends on.
    deploy boolean
    Deploying an action will create a new immutable version of the action. If the action is currently bound to a trigger, then the system will begin executing the newly deployed version of the action immediately.
    name string
    The name of the action.
    runtime string
    The Node runtime. Defaults to node12. Possible values are: node12, node16, node18 (beta) or node18-actions (GA).
    secrets ActionSecret[]
    List of secrets that are included in an action or a version of an action.
    supportedTriggers ActionSupportedTriggers
    List of triggers that this action supports. At this time, an action can only target a single trigger at a time. Read Retrieving the set of triggers available within actions to retrieve the latest trigger versions supported.
    versionId string
    Version ID of the action. This value is available if deploy is set to true.
    code str
    The source code of the action.
    dependencies Sequence[ActionDependencyArgs]
    List of third party npm modules, and their versions, that this action depends on.
    deploy bool
    Deploying an action will create a new immutable version of the action. If the action is currently bound to a trigger, then the system will begin executing the newly deployed version of the action immediately.
    name str
    The name of the action.
    runtime str
    The Node runtime. Defaults to node12. Possible values are: node12, node16, node18 (beta) or node18-actions (GA).
    secrets Sequence[ActionSecretArgs]
    List of secrets that are included in an action or a version of an action.
    supported_triggers ActionSupportedTriggersArgs
    List of triggers that this action supports. At this time, an action can only target a single trigger at a time. Read Retrieving the set of triggers available within actions to retrieve the latest trigger versions supported.
    version_id str
    Version ID of the action. This value is available if deploy is set to true.
    code String
    The source code of the action.
    dependencies List<Property Map>
    List of third party npm modules, and their versions, that this action depends on.
    deploy Boolean
    Deploying an action will create a new immutable version of the action. If the action is currently bound to a trigger, then the system will begin executing the newly deployed version of the action immediately.
    name String
    The name of the action.
    runtime String
    The Node runtime. Defaults to node12. Possible values are: node12, node16, node18 (beta) or node18-actions (GA).
    secrets List<Property Map>
    List of secrets that are included in an action or a version of an action.
    supportedTriggers Property Map
    List of triggers that this action supports. At this time, an action can only target a single trigger at a time. Read Retrieving the set of triggers available within actions to retrieve the latest trigger versions supported.
    versionId String
    Version ID of the action. This value is available if deploy is set to true.

    Supporting Types

    ActionDependency, ActionDependencyArgs

    Name string
    Dependency name, e.g. lodash.
    Version string
    Dependency version, e.g. latest or 4.17.21.
    Name string
    Dependency name, e.g. lodash.
    Version string
    Dependency version, e.g. latest or 4.17.21.
    name String
    Dependency name, e.g. lodash.
    version String
    Dependency version, e.g. latest or 4.17.21.
    name string
    Dependency name, e.g. lodash.
    version string
    Dependency version, e.g. latest or 4.17.21.
    name str
    Dependency name, e.g. lodash.
    version str
    Dependency version, e.g. latest or 4.17.21.
    name String
    Dependency name, e.g. lodash.
    version String
    Dependency version, e.g. latest or 4.17.21.

    ActionSecret, ActionSecretArgs

    Name string
    Secret name.
    Value string
    Secret value.
    Name string
    Secret name.
    Value string
    Secret value.
    name String
    Secret name.
    value String
    Secret value.
    name string
    Secret name.
    value string
    Secret value.
    name str
    Secret name.
    value str
    Secret value.
    name String
    Secret name.
    value String
    Secret value.

    ActionSupportedTriggers, ActionSupportedTriggersArgs

    Id string
    The trigger ID.
    Version string
    The trigger version. This regulates which runtime versions are supported.
    Id string
    The trigger ID.
    Version string
    The trigger version. This regulates which runtime versions are supported.
    id String
    The trigger ID.
    version String
    The trigger version. This regulates which runtime versions are supported.
    id string
    The trigger ID.
    version string
    The trigger version. This regulates which runtime versions are supported.
    id str
    The trigger ID.
    version str
    The trigger version. This regulates which runtime versions are supported.
    id String
    The trigger ID.
    version String
    The trigger version. This regulates which runtime versions are supported.

    Import

    An action can be imported using the action’s ID. # Example

     $ pulumi import auth0:index/action:Action my_action 12f4f21b-017a-319d-92e7-2291c1ca36c4
    

    ~> For security reasons importing secrets is not allowed. Therefore, it is advised to import the action without secrets and adding them back after the action has been imported.

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    Auth0 pulumi/pulumi-auth0
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the auth0 Terraform Provider.
    auth0 logo
    Viewing docs for Auth0 v2.24.3 (Older version)
    published on Monday, Mar 9, 2026 by Pulumi
      Try Pulumi Cloud free. Your team will thank you.