Skip to main content

SpotDraft API

SpotDraft is a contract management platform that uses AI to streamline contract creation, review, and management processes, helping legal teams automate workflows and reduce manual contract handling.

SpotDraft API icon

Power end-to-end data operations for your SpotDraft API API with Nexla. Our bi-directional SpotDraft API connector is purpose-built for SpotDraft API, making it simple to ingest data, sync it across systems, and deliver it anywhere — all with no coding required. Nexla turns API-sourced data into ready-to-use, reusable data products and makes it easy to send data to SpotDraft API or any other destination. With comprehensive monitoring, lineage tracking, and access controls, Nexla keeps your SpotDraft API workflows fast, secure, and fully governed.

Features

Type: API

SourceDestination

  • Seamless API Integration: Connect to any endpoint as source or destination without coding, with automatic data product creation
  • Visual Composition & Chaining: Build complex integrations using visual templates, chain API calls, and compose workflows with data validation and filtering
  • API Proxy: Expose curated slices of your data securely with a secure and customizable API proxy that validates and transforms data on the fly
  • Request optimization with intelligent batching, retry, and caching to minimize API calls and costs

Prerequisites

Before creating a SpotDraft credential, you need to obtain your Client ID, Client Secret, and optionally a User Email from your SpotDraft account. SpotDraft uses header-based authentication for all API requests, with credentials sent in custom headers.

To obtain your SpotDraft credentials, follow these steps:

  1. Sign in to your SpotDraft account using your administrator credentials.

  2. Navigate to Settings in your SpotDraft account, then select Developer Settings or navigate to Settings > Developer Settings.

  3. Look for the API Credentials or API Keys section in the Developer Settings page.

  4. If you don't have API credentials yet, look for the option to generate or create API credentials.

  5. Click Generate API Credentials or Create API Key to create new API credentials.

  6. Configure your API credentials:

    • Enter a name for the API credentials (e.g., "Nexla Integration")
    • Review and select the permissions or scopes for the API credentials (if applicable)
  7. Click Generate or Create to create the API credentials.

  8. After the credentials are created, you will be provided with your Client ID and Client Secret. Copy both credentials immediately, as the Client Secret may not be accessible again after you navigate away from the page.

  9. Optionally, you can specify a User Email to impersonate a specific user when making API requests. This is useful if you need to access data on behalf of a specific user. If not specified, the API will use the account's default permissions.

  10. Store all credentials securely, as you will need them to configure your Nexla credential. The Client ID and Client Secret are sensitive information and should be kept confidential.

The Client ID, Client Secret, and User Email (if provided) are sent in custom headers (client-id, client-secret, user-email) for all API requests to the SpotDraft API. The credentials authenticate your requests and grant access to SpotDraft resources based on your account permissions. If your credentials are compromised, you should immediately revoke them in your SpotDraft Developer Settings and generate new ones. For detailed information about API authentication, credential generation, and available endpoints, refer to the SpotDraft API documentation.

Authenticate

Credentials required

FieldRequiredSecretDescription
Client IDYesNo
Client SecretYesYes
User email to impersonate (optional)NoNo

Create a credential in Nexla

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

New Credential Overlay – SpotDraft API

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

Header Authentication

SpotDraft uses header-based authentication for all API requests. The Client ID, Client Secret, and optionally User Email are sent in custom headers for authentication.

  1. Enter your SpotDraft Client ID in the Client ID field. This is the Client ID you obtained from your SpotDraft account settings (Settings > Developer Settings > API Credentials) when generating your API credentials. The Client ID is sent in the client-id header for all API requests to the SpotDraft API.

  2. Enter your SpotDraft Client Secret in the Client Secret field. This is the Client Secret you obtained from your SpotDraft account settings when generating your API credentials. The Client Secret is sent in the client-secret header for all API requests to the SpotDraft API. The Client Secret is sensitive information and must be kept confidential.

  3. Optionally, enter a User Email in the User email to impersonate (optional) field. This should be the email address of a user in your SpotDraft account that you want to impersonate when making API requests. If provided, the User Email is sent in the user-email header for all API requests. If not specified, the API will use the account's default permissions.

    Your SpotDraft API credentials can be found in your SpotDraft account settings under Settings > Developer Settings > API Credentials. The Client ID and Client Secret are generated when you create API credentials.

    These credentials are sent in custom headers (client-id, client-secret, user-email) for all API requests to the SpotDraft API. The credentials authenticate your requests and grant access to SpotDraft resources based on your account permissions.

    If your credentials are compromised, you should immediately revoke them in your SpotDraft Developer Settings and generate new ones. The credentials provide access to your SpotDraft account data and should be treated as sensitive information. Keep your credentials secure and do not share them publicly.

    For detailed information about API authentication, credential generation, and available endpoints, see the SpotDraft API documentation.

  4. Click the Save button at the bottom of the overlay. The newly added credential will now appear in a tile on the Authenticate screen during data source/destination creation.

Use as a data source

To create a new data flow, navigate to the Integrate section, and click the New Data Flow button. Select the SpotDraft connector tile, then select the credential that will be used to connect to your SpotDraft account, and click Next; or, create a new SpotDraft credential for use in this flow.

Endpoint templates

Nexla provides pre-built templates that can be used to rapidly configure data sources to ingest data from common SpotDraft endpoints. Each template is designed specifically for the corresponding SpotDraft endpoint, making data source setup easy and efficient. Select the endpoint from which this source will fetch data from the Endpoint pulldown menu. Available endpoint templates are listed in the expandable boxes below. Click on an endpoint to see more information about it and how to configure your data source for this endpoint.

Gets the list of all the users in the Client's account.

This endpoint template retrieves a list of all users in your SpotDraft account. Use this template when you need to retrieve information about users, including user IDs, email addresses, and other user metadata.

  • This endpoint automatically retrieves all users from your SpotDraft account. The endpoint uses incrementing page-based pagination to handle large datasets efficiently, returning up to 100 records per page by default.

This endpoint returns a list of all users in your SpotDraft account, including user IDs, email addresses, and other user metadata. The endpoint uses incrementing page-based pagination with page and limit parameters to handle large datasets efficiently. Nexla will automatically fetch subsequent pages of data by incrementing the page parameter.

For detailed information about users, API response structures, pagination, and available user data, see the SpotDraft API documentation.

Get contacts

This endpoint template returns the list of contracts belonging to the related workspace from your SpotDraft account. Use this template when you need to retrieve information about contracts, including contract IDs, details, and other contract metadata.

  • Enter the Client Email in the Client Email field. This should be the email address of the client whose contracts you want to retrieve. The Client Email is used as a filter to retrieve contracts for a specific client. The endpoint uses incrementing page-based pagination to handle large datasets efficiently, returning up to 100 records per page by default.

This endpoint returns the list of contracts belonging to the related workspace from your SpotDraft account, including contract IDs, details, and other contract metadata. The endpoint uses incrementing page-based pagination with page and limit parameters to handle large datasets efficiently. Nexla will automatically fetch subsequent pages of data by incrementing the page parameter.

The Client Email is used as a filter to retrieve contracts for a specific client. For detailed information about contracts, API response structures, pagination, and available contract data, see the SpotDraft API documentation.

Get Counterparties

This endpoint template retrieves the list of counterparties from your SpotDraft account. Use this template when you need to retrieve information about counterparties, including counterparty IDs, names, and other counterparty metadata.

  • Enter the Client Email in the Client Email field. This should be the email address of the client whose counterparties you want to retrieve. The Client Email is used as a filter to retrieve counterparties for a specific client. The endpoint uses incrementing page-based pagination to handle large datasets efficiently, returning up to 100 records per page by default.

This endpoint returns the list of counterparties from your SpotDraft account, including counterparty IDs, names, and other counterparty metadata. The endpoint uses incrementing page-based pagination with page and limit parameters to handle large datasets efficiently. Nexla will automatically fetch subsequent pages of data by incrementing the page parameter.

The Client Email is used as a filter to retrieve counterparties for a specific client. For detailed information about counterparties, API response structures, pagination, and available counterparty data, see the SpotDraft API documentation.

Get Counterparty contacts

This endpoint template retrieves the list of counterparty contacts from your SpotDraft account. Use this template when you need to retrieve information about counterparty contacts, including contact IDs, names, and other contact metadata.

  • Enter the Counterparty ID in the Counterparty ID field. This should be the unique identifier of the counterparty whose contacts you want to retrieve. The Counterparty ID determines which counterparty's contacts will be retrieved. You can find the Counterparty ID by using the "Get Counterparties" endpoint. The endpoint uses incrementing page-based pagination to handle large datasets efficiently, returning up to 100 records per page by default.

This endpoint returns the list of counterparty contacts from your SpotDraft account, including contact IDs, names, and other contact metadata. The endpoint uses incrementing page-based pagination with page and limit parameters to handle large datasets efficiently. Nexla will automatically fetch subsequent pages of data by incrementing the page parameter.

The Counterparty ID can be found by using the "Get Counterparties" endpoint. For detailed information about counterparty contacts, API response structures, pagination, and available contact data, see the SpotDraft API documentation.

Get Counterparty Addresses

This endpoint template retrieves the list of counterparty addresses from your SpotDraft account. Use this template when you need to retrieve information about counterparty addresses, including address IDs, addresses, and other address metadata.

  • Enter the Counterparty ID in the Counterparty ID field. This should be the unique identifier of the counterparty whose addresses you want to retrieve. The Counterparty ID determines which counterparty's addresses will be retrieved. You can find the Counterparty ID by using the "Get Counterparties" endpoint. The endpoint uses incrementing page-based pagination to handle large datasets efficiently, returning up to 100 records per page by default.

This endpoint returns the list of counterparty addresses from your SpotDraft account, including address IDs, addresses, and other address metadata. The endpoint uses incrementing page-based pagination with page and limit parameters to handle large datasets efficiently. Nexla will automatically fetch subsequent pages of data by incrementing the page parameter.

The Counterparty ID can be found by using the "Get Counterparties" endpoint. For detailed information about counterparty addresses, API response structures, pagination, and available address data, see the SpotDraft API documentation.

Once the selected endpoint template has been configured, click the Test button to the right of the endpoint selection menu to retrieve a sample of the data that will be fetched. Sample data will be displayed in the Endpoint Test Result panel on the right, allowing you to verify that the source is configured correctly before saving.

Manual configuration

SpotDraft data sources can also be manually configured to ingest data from any valid SpotDraft API endpoint, including endpoints not covered by the pre-built templates, chained API calls, or custom query parameters. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the API method, endpoint URL, date/time and lookup macros, path to data, metadata, and request headers.

SpotDraft API typically uses the GET method for retrieving data from an API base URL of https://api.spotdraft.com/api/v2/public/ (e.g., https://api.spotdraft.com/api/v2/public/auth/users, https://api.spotdraft.com/api/v2/public/contracts). Use a Response Data Path such as $.results[*] to extract items from a paginated results array, or $[*] for endpoints that return a plain array, and configure incrementing page-based pagination using the page and limit parameters (up to 100 records per page).

Once all of the relevant settings have been configured, click the Next button to proceed with the rest of the data flow configuration, or click Save to save the data source configuration for later use.