Skip to main content

Resource Templates

A Resource Template is a reusable blueprint built on top of an Identity Provider (IDP). It defines the OAuth scopes and, optionally, the default platform-level credentials that a specific service integration requires.

Think of a Resource Template as the definition of what a service connection needs — the actual live credentials and environment-specific settings are configured when you deploy a Managed Resource.

info

Location: Library > My Artifacts > Resource Templates


What You Can Do​

ActionDescription
CreateSet up a new Resource Template via a multi-step wizard
EditModify an existing template
ViewInspect template details in read-only mode
DeletePermanently remove a template
SearchFilter templates by name

Creating a Resource Template​

Navigate to Library > My Artifacts > Resource Templates and click Create. The wizard walks you through up to four steps (the Platform Credentials step is conditional).

Step 1 — Basic Details​

FieldRequiredDescription
NameRequiredA unique name for this template, scoped to the selected IDP. Validated in real time as you type.
Identity ProviderRequiredThe IDP this template is built on. This field cannot be changed after creation.
DescriptionOptionalA markdown-supported description of what this template represents.
Activity GroupOptionalThe group this resource activity will appear under in the activity palette.
IconOptionalPick from the icon library or upload a custom SVG file.
VersionOptionalA version identifier for this template (e.g., 1.0.0).
note

The Identity Provider field is locked once the template is saved. To change the provider, create a new template.


Step 2 — Scopes​

Define the OAuth scopes this resource requires. Each scope represents a specific permission the platform will request from the provider.

Click Add Scope to add a row to the scopes table:

FieldRequiredDescription
Scope IDRequiredThe scope string as defined by the provider (e.g., https://www.googleapis.com/auth/spreadsheets).
DescriptionOptionalA human-readable explanation of what this scope grants.
DefaultOptionalMark this scope as selected by default when deploying a Managed Resource. Users can still deselect non-required scopes during deployment.

You can add multiple scopes and reorder or remove them at any time before saving.


Step 3 — Platform Credentials (Conditional)​

This step only appears when both of the following are true for the linked IDP:

  • The IDP supports the Authorization Code grant type.
  • The IDP has Allow Default Connection enabled.

When these conditions are met, you can configure shared OAuth credentials at the platform level. These credentials are pre-filled when deploying Managed Resources, reducing the need for users to enter them manually.

For each environment defined in the IDP, provide:

FieldRequiredDescription
Environment—The IDP environment these credentials apply to (auto-populated from the IDP).
Grant TypeRequiredSelect Authorization Code or Client Credentials for this set of credentials.
OAuth Client IDRequiredThe client ID issued by the provider for your registered application.
OAuth Client SecretRequiredThe client secret issued by the provider. Stored securely.

Step 4 — Review​

Review all settings before saving. Click Back to make changes or Save to create the template.

Once saved, the Resource Template is available organization-wide and can be used to deploy Managed Resources.


Editing a Resource Template​

  1. Navigate to Library > My Artifacts > Resource Templates.
  2. Locate the template you want to modify.
  3. Click the Edit (pencil) icon.
  4. Update the relevant fields — the linked IDP cannot be changed.
  5. Click Save to apply changes.

Deleting a Resource Template​

  1. Navigate to Library > My Artifacts > Resource Templates.
  2. Click the Delete (trash) icon next to the template.
  3. Confirm the deletion in the dialog.
warning

Deleting a Resource Template will affect any Managed Resources deployed from it. Verify no active deployments depend on this template before deleting.


What's Next​

Once a Resource Template is ready, deploy it as a Managed Resource with environment-specific credentials and connection settings.