Skip to main content

Authorization

Follow this guide to create a new Seismic credential that will allow Nexla to authenticate to and exchange data with your Seismic account.
seismic_api_auth.png

Seismic

Prerequisites​

Before creating a Seismic credential in Nexla, you need to register an application in the Seismic App Registration Portal and obtain OAuth2 credentials. Seismic uses the OAuth2 Authorization Code Flow (3-legged OAuth) to authorize third-party integrations.

Identify Your Tenant ID​

Your Seismic Tenant ID is the subdomain portion of your Seismic URL. For example, if your organization accesses Seismic at https://mycompany.seismic.com, your Tenant ID is mycompany.

Register an Application in the Seismic App Registration Portal​

Only Seismic tenant administrators have permission to register applications. Complete the following steps in the Seismic App Registration Portal:

  1. Log in to the Seismic App Registration Portal using your Seismic tenant administrator credentials.

  2. Click the orange + button in the upper right corner of the portal to begin creating a new application.

  3. On the Basic Information tab, enter an application name (e.g., "Nexla Integration"), a contact email address, and a short description.

  4. On the Authentication tab, select Authorization Code as the authentication flow. This is the flow required for the Nexla integration.

  5. In the Redirect URIs field, add the Nexla OAuth callback URL: https://app.nexla.io/oauth/callback.

  6. On the Scopes tab, select the scopes that correspond to the data you want Nexla to access. Seismic scopes follow the format seismic.object.permission. For typical reporting and data extraction use cases, select:

    • seismic.reporting.read — Required for all Reporting API endpoints (content usage, user activity, programs, library contents, etc.)
    • seismic.content.read — Required for reading content items and library data
    • seismic.channels.manage — Required if using Channels API endpoints (List Channels, List Posts in Channel, List Posts)

    Select only the scopes required for your specific use case. Additional scopes can be added later by updating the application registration. For a complete list of available scopes, refer to the Seismic Scopes documentation.

  7. Click Save to create the application. After saving, copy the Client ID displayed on the application details page.

  8. Click the Generate button to generate a Client Secret. Copy the Client Secret immediately, as it will not be shown again after you leave this page.

    Important

    Store the Client Secret in a secure location. Seismic does not display the secret again after initial generation. If the secret is lost, you must generate a new one, which will invalidate the previous secret.

  9. Log in to your Seismic instance (e.g., https://mycompany.seismic.com), navigate to Admin Settings > My Apps, and locate the application you just created.

  10. Click on the application row to open its configuration page, then click Enable App in Seismic to activate the application for your tenant. Accept the consent modal that appears.

The application must be enabled in your Seismic tenant before Nexla can complete the OAuth authorization flow. This step is separate from the App Registration Portal and must be performed by a tenant administrator.

Create a Seismic Credential​

  • To create a new Seismic credential, after selecting the data source/destination type, click the Add Credential tile to open the Add New Credential overlay.

Credential Name & Description​

  1. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

    Resource descriptions are recommended but are not required. They should be used to provide information about the resource purpose, data freshness, etc. that can help the owner and other users efficiently understand and utilize the resource.

Seismic OAuth2 (3-legged) Configuration​

Nexla connects to Seismic using the OAuth2 Authorization Code (3-legged) flow. You will need your Tenant ID, Client ID, and Client Secret obtained from the Seismic App Registration Portal.

  1. Enter your Seismic Tenant ID in the Tenant ID field. This is the subdomain of your Seismic instance URL (e.g., if your Seismic URL is https://mycompany.seismic.com, enter mycompany).

  2. Enter the Client ID from the Seismic App Registration Portal in the Client ID field. This uniquely identifies your registered application.

  3. Enter the Client Secret generated in the Seismic App Registration Portal in the Client Secret field. This secret is used to authenticate the application during token exchange.

  4. Click the Authorize button (or equivalent OAuth flow trigger) to initiate the Seismic OAuth2 authorization flow. You will be redirected to Seismic's login page at https://auth.seismic.com/tenants/{your-tenant}/connect/authorize to grant Nexla permission to access your Seismic account.

  5. Log in to Seismic with your Seismic user account credentials and review the requested permissions. Click Accept or Authorize to grant Nexla access.

    The Seismic user account used to authorize the credential must have access to the scopes requested by the registered application. For reporting data, the user should have appropriate reporting permissions within Seismic. The authorization grants Nexla access on behalf of this user account.

  6. After successfully authorizing, Nexla will receive an access token and refresh token, which will be stored securely with the credential. Nexla will use these tokens for all subsequent API calls to Seismic.

Save the Credential​

  1. Once all of the relevant steps in the above sections have been completed, click the Save button at the bottom of the overlay to save the configured credential.

  2. The newly added credential will now appear in a tile on the Authenticate screen during data source/destination creation and can be selected for use with a new data source or destination.