Credentials

Generic OAuth

Explains how to create a Generic OAuth credential for authenticating with any OAuth-compatible API. Used in the Apicall task for client credentials OAuth flows.

# Overview

The Generic OAuth credential can be used to authenticate with any API that supports OAuth client credentials. When created, the platform will immediately attempt to obtain an access token from the specified token URL. This credential can be used in the API Call task.

# Fields

# Creating the Credential

1. Navigate to the Credentials section of the manage platform.
2. Click the
   + Create new item
   button.
3. Select Generic OAuth from the credential type dropdown.
4. Enter a Credential Name.
5. Enter the Token URL.
6. Enter the Client ID and Client Secret.
7. Optionally, enter the Scope.
8. Select the Grant Type.
9. Select the Client Authentication Method.
10. Click the
    Create
    button.

The platform will attempt to obtain an access token. If successful, the credential will be created and the token will be stored securely.

# Additional Credentials

Some OAuth providers have custom requirements on their token endpoint — for example, requiring a custom x-api-key header alongside the standard OAuth parameters. The Org Credentials field handles these cases.

To use this:

1. First, create the credential that satisfies the provider's extra requirement (e.g., a Custom Header credential with the required header key and value).
2. Copy the orgcredentialuuid of that credential (see Getting an orgcredentialuuid).
3. Paste it into the Org Credentials field when creating the Generic OAuth credential.

If multiple additional credentials are needed, provide them as comma-separated orgcredentialuuid values.