Conga

Conga Bulk Import API

The Bulk Import API from Conga — 5 operation(s) for bulk import.

GitHub OpenAPI

Operations 6

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /api/clm/v1/import/jobs Start a bulk CSV import job · Create a bulk import job #
Ask an LLM
“How do I bulk-load accounts, contacts or agreements into Conga CLM from a CSV?”
“Can I upload a CSV file to create many CLM records at once?”
Tell an agent
Start a bulk import job with the CSV file {file}.
Upload {file} to import contacts into CLM in bulk.
POST /api/clm/v1/import/jobs/query List bulk import jobs · List bulk import jobs #
Ask an LLM
“Which bulk import jobs have been run so far?”
“Can I filter and sort the list of past CSV import jobs?”
Tell an agent
List my bulk import jobs.
Show the latest {limit} import jobs.
DELETE /api/clm/v1/import/jobs/{jobId} Delete a bulk import job record · Delete a bulk import job #
Ask an LLM
“Can I permanently remove the record of an old import job?”
“How do I clean up a bulk import job from the system?”
Tell an agent destructive · confirm first
Delete the import job record {job}.
Permanently remove bulk import job {job}.
GET /api/clm/v1/import/jobs/{jobId} Get the result of a bulk import job · Get bulk import job result #
Ask an LLM
“Did my bulk import job succeed or fail?”
“How do I check the outcome of a specific CSV import job?”
Tell an agent
Get the result of import job {job}.
Tell me whether bulk import {job} succeeded.
GET /api/clm/v1/import/jobs/{jobId}/batch/{batchId} Get the file uploaded in an import batch · Get uploaded file details #
Ask an LLM
“How can I see what was in the CSV file uploaded for an import batch?”
“What contents were submitted in a given batch of a bulk import job?”
Tell an agent
Show the uploaded file for batch {batch} of import job {job}.
Fetch the contents submitted in job {job}, batch {batch}.
GET /api/clm/v1/import/templates/{format} Download a bulk import template · Get bulk import templates #
Ask an LLM
“Where do I get the CSV template needed to bulk-import agreements?”
“Which columns does the import template for contacts expect?”
Tell an agent
Get the {format} import template for {object}.
Download the bulk import template in {format} format.

Documentation

📖
Authentication
https://raw.githubusercontent.com/api-evangelist/conga/refs/heads/main/authentication/conga-authentication.yml
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/conga/refs/heads/main/rate-limits/conga-rate-limits.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/conga/refs/heads/main/openapi/conga-bulk-import-api-openapi.yml

Other Resources

🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/conga/refs/heads/main/data-model/conga-data-model.yml
🔗
OAuthScopes
https://raw.githubusercontent.com/api-evangelist/conga/refs/heads/main/scopes/conga-scopes.yml
🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/conga/refs/heads/main/conventions/conga-conventions.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/conga/refs/heads/main/errors/conga-problem-types.yml
🔗
Lifecycle
https://raw.githubusercontent.com/api-evangelist/conga/refs/heads/main/lifecycle/conga-lifecycle.yml
🔗
Conformance
https://raw.githubusercontent.com/api-evangelist/conga/refs/heads/main/conformance/conga-conformance.yml
🔗
Sandbox
https://raw.githubusercontent.com/api-evangelist/conga/refs/heads/main/sandbox/conga-sandbox.yml
🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/conga/refs/heads/main/asyncapi/conga-webhooks.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/conga:conga-bulk-import-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

conga-bulk-import-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Contracts Bulk Import API
  version: v1
servers:
- url: https://rls.congacloud.com
- url: https://preview-rls09.congacloud.com
security:
- bearerAuth: []
tags:
- name: Bulk Import
paths:
  /api/clm/v1/import/jobs:
    post:
      tags:
      - Bulk Import
      summary: Create a bulk import job
      description: The API allows you to upload .CSV files and import bulk data into Conga CLM. You can upload accounts, contacts, and agreements in bulk by creating and uploading a .CSV file. This creates a record for the file, which is assigned a queued status. The conga-contracts-batch-worker verifies the data and skips invalid data records. It creates records for the valid records in CLM. You can review failure reasons by accessing the .CSV file at the specified endpoint (/api/clm/v1/import/jobs/{jobId}).
      requestBody:
        description: The .CSV file containing data to be imported
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                file:
                  type: string
                  format: binary
            encoding:
              file:
                style: form
      responses:
        '200':
          description: Returns jobID of the bulk import job created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobAPIResponse'
        '400':
          description: Provided query is invalid
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIResponseError'
              example:
                Success: false
                Data: null
                Warnings: null
                Errors:
                - Id: null
                  Message: Error Message
        '500':
          description: Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIResponseError'
              example:
                Success: false
                Data: null
                Warnings: null
                Errors:
                - Id: null
                  Message: Internal server error occurred. Please contact admin.
      operationId: postApiClmV1ImportJobs
      x-operation-id-source: derived
  /api/clm/v1/import/jobs/query:
    post:
      tags:
      - Bulk Import
      summary: List bulk import jobs
      description: Retrieves all bulk import job records.
      requestBody:
        description: Query parameters to get bulk import jobs
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CustomQuery'
            example:
              Distinct: false
              Fields: null
              GroupBy: null
              IncludeTotalCount: true
              SortInfo:
                FieldName: ContractType
                Direction: Ascending
              CriteriaExpression: null
              Limit: 10
              Skip: 0
          text/json:
            schema:
              $ref: '#/components/schemas/CustomQuery'
            example:
              Distinct: false
              Fields: null
              GroupBy: null
              IncludeTotalCount: true
              SortInfo:
                FieldName: ContractType
                Direction: Ascending
              CriteriaExpression: null
              Limit: 10
              Skip: 0
          application/*+json:
            schema:
              $ref: '#/components/schemas/CustomQuery'
            example:
              Distinct: false
              Fields: null
              GroupBy: null
              IncludeTotalCount: true
              SortInfo:
                FieldName: ContractType
                Direction: Ascending
              CriteriaExpression: null
              Limit: 10
              Skip: 0
      responses:
        '200':
          description: Returns the list of bulk import jobs that match the query
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BulkImportResponseQueryResponseAPIResponse'
        '400':
          description: Provided query is invalid
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIResponseError'
              example:
                Success: false
                Data: null
                Warnings: null
                Errors:
                - Id: null
                  Message: Error Message
        '500':
          description: Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIResponseError'
              example:
                Success: false
                Data: null
                Warnings: null
                Errors:
                - Id: null
                  Message: Internal server error occurred. Please contact admin.
      operationId: postApiClmV1ImportJobsQuery
      x-operation-id-source: derived
  /api/clm/v1/import/jobs/{jobId}:
    delete:
      tags:
      - Bulk Import
      summary: Delete a bulk import job
      description: Permanently deletes record of the given job ID from the system.
      parameters:
      - name: jobId
        in: path
        description: ID of the bulk import job
        required: true
        schema:
          type: string
      responses:
        '200':
          description: The bulk import job is deleted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BulkJobResultResponseListAPIResponse'
        '400':
          description: The provided job ID is invalid
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIResponseError'
              example:
                Success: false
                Data: null
                Warnings: null
                Errors:
                - Id: null
                  Message: Error Message
        '500':
          description: Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIResponseError'
              example:
                Success: false
                Data: null
                Warnings: null
                Errors:
                - Id: null
                  Message: Internal server error occurred. Please contact admin.
      operationId: deleteApiClmV1ImportJobsByJobId
      x-operation-id-source: derived
    get:
      tags:
      - Bulk Import
      summary: Get bulk import job result
      description: Gets the result (failure or success) for a given job.
      parameters:
      - name: jobId
        in: path
        description: ID of the bulk import job
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Returns details of bulk import job for the provided job ID
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BulkJobResultResponseListAPIResponse'
        '400':
          description: Provided query is invalid
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIResponseError'
              example:
                Success: false
                Data: null
                Warnings: null
                Errors:
                - Id: null
                  Message: Error Message
        '500':
          description: Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIResponseError'
              example:
                Success: false
                Data: null
                Warnings: null
                Errors:
                - Id: null
                  Message: Internal server error occurred. Please contact admin.
      operationId: getApiClmV1ImportJobsByJobId
      x-operation-id-source: derived
  /api/clm/v1/import/jobs/{jobId}/batch/{batchId}:
    get:
      tags:
      - Bulk Import
      summary: Get uploaded file details
      description: Fetches contents of the file uploaded for bulk data creation based on jobID and batchID.
      parameters:
      - name: jobId
        in: path
        description: ID of the bulk import job
        required: true
        schema:
          type: string
      - name: batchId
        in: path
        description: ID of the bulk import batch
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Returns the file uploaded for bulk data import
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BulkJobResultResponseListAPIResponse'
        '400':
          description: Provided query is invalid
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIResponseError'
              example:
                Success: false
                Data: null
                Warnings: null
                Errors:
                - Id: null
                  Message: Error Message
        '500':
          description: Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIResponseError'
              example:
                Success: false
                Data: null
                Warnings: null
                Errors:
                - Id: null
                  Message: Internal server error occurred. Please contact admin.
      operationId: getApiClmV1ImportJobsByJobIdBatchByBatchId
      x-operation-id-source: derived
  /api/clm/v1/import/templates/{format}:
    get:
      tags:
      - Bulk Import
      summary: Get bulk import templates
      description: The API fetches bulk import templates for the provided objectName and format. Templates are required for uploading .CSV files to import bulk data into Conga CLM. A template comprises columns corresponding to the database fields required for inserting data for the data type. A distinct template is provided to create .CSV files to upload the Account, Contact, and Agreement data types.
      parameters:
      - name: objectName
        in: query
        description: Object name, such as Agreement, Account, or Contact
        schema:
          type: array
          items:
            type: string
      - name: format
        in: path
        description: Template file format. The only supported format is .CSV
        required: true
        schema:
          $ref: '#/components/schemas/AllowedTemplateDocumentFormats'
      responses:
        '200':
          description: Returns list of bulk import templates that match the query
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileResultAPIResponse'
        '400':
          description: Provided query is invalid
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIResponseError'
              example:
                Success: false
                Data: null
                Warnings: null
                Errors:
                - Id: null
                  Message: Error Message
        '500':
          description: Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIResponseError'
              example:
                Success: false
                Data: null
                Warnings: null
                Errors:
                - Id: null
                  Message: Internal server error occurred. Please contact admin.
      operationId: getApiClmV1ImportTemplatesByFormat
      x-operation-id-source: derived
components:
  schemas:
    BulkJobResultResponseListAPIResponse:
      type: object
      properties:
        Success:
          type: boolean
          description: The state of the API response
        Data:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/BulkJobResultResponse'
          description: Generic data to return
        Warnings:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/WarningDetail'
          description: Warning detail list for non-blocking issues
        Errors:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/ErrorDetail'
          description: Error detail list in case of failure
      additionalProperties: false
      description: API Response Class
    WarningDetail:
      type: object
      properties:
        Code:
          type:
          - string
          - 'null'
          description: Warning code
        Message:
          type:
          - string
          - 'null'
          description: Warning message
      additionalProperties: false
      description: Warning detail class for non-blocking issues
    Job:
      type: object
      properties:
        JobId:
          type:
          - string
          - 'null'
        State:
          $ref: '#/components/schemas/JobState'
      additionalProperties: false
    BulkImportResponseQueryResponseAPIResponse:
      type: object
      properties:
        Success:
          type: boolean
          description: The state of the API response
        Data:
          $ref: '#/components/schemas/BulkImportResponseQueryResponse'
        Warnings:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/WarningDetail'
          description: Warning detail list for non-blocking issues
        Errors:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/ErrorDetail'
          description: Error detail list in case of failure
      additionalProperties: false
      description: API Response Class
    HttpStatusCode:
      enum:
      - Continue
      - SwitchingProtocols
      - Processing
      - EarlyHints
      - OK
      - Created
      - Accepted
      - NonAuthoritativeInformation
      - NoContent
      - ResetContent
      - PartialContent
      - MultiStatus
      - AlreadyReported
      - IMUsed
      - MultipleChoices
      - MovedPermanently
      - Found
      - SeeOther
      - NotModified
      - UseProxy
      - Unused
      - TemporaryRedirect
      - PermanentRedirect
      - BadRequest
      - Unauthorized
      - PaymentRequired
      - Forbidden
      - NotFound
      - MethodNotAllowed
      - NotAcceptable
      - ProxyAuthenticationRequired
      - RequestTimeout
      - Conflict
      - Gone
      - LengthRequired
      - PreconditionFailed
      - RequestEntityTooLarge
      - RequestUriTooLong
      - UnsupportedMediaType
      - RequestedRangeNotSatisfiable
      - ExpectationFailed
      - MisdirectedRequest
      - UnprocessableEntity
      - Locked
      - FailedDependency
      - UpgradeRequired
      - PreconditionRequired
      - TooManyRequests
      - RequestHeaderFieldsTooLarge
      - UnavailableForLegalReasons
      - InternalServerError
      - NotImplemented
      - BadGateway
      - ServiceUnavailable
      - GatewayTimeout
      - HttpVersionNotSupported
      - VariantAlsoNegotiates
      - InsufficientStorage
      - LoopDetected
      - NotExtended
      - NetworkAuthenticationRequired
      type: string
    SortDirection:
      enum:
      - Ascending
      - Descending
      type: string
    BulkJobResultResponse:
      type: object
      properties:
        State:
          $ref: '#/components/schemas/JobState'
        BatchId:
          type:
          - string
          - 'null'
          description: BatchId
        FileName:
          type:
          - string
          - 'null'
          description: FileName
        FileContent:
          type:
          - string
          - 'null'
          description: FileContent
          format: byte
      additionalProperties: false
      description: Bulk Job result
    APIResponseError:
      type: object
      properties:
        Success:
          type: boolean
          description: The state of the API response
        Data:
          type:
          - string
          - 'null'
          description: Generic data to return
        Warnings:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/WarningDetail'
          description: Warning detail list for non-blocking issues
        Errors:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/ErrorDetail'
          description: Error detail list in case of failure
      additionalProperties: false
      description: API Response Error Class
    JobState:
      enum:
      - Queued
      - InProgress
      - Completed
      - Failed
      type: string
    AllowedTemplateDocumentFormats:
      enum:
      - csv
      - xlsx
      type: string
    JobAPIResponse:
      type: object
      properties:
        Success:
          type: boolean
          description: The state of the API response
        Data:
          $ref: '#/components/schemas/Job'
        Warnings:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/WarningDetail'
          description: Warning detail list for non-blocking issues
        Errors:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/ErrorDetail'
          description: Error detail list in case of failure
      additionalProperties: false
      description: API Response Class
    BulkImportResponseQueryResponse:
      type: object
      properties:
        StatusCode:
          $ref: '#/components/schemas/HttpStatusCode'
        RecordCount:
          type:
          - integer
          - 'null'
          format: int64
        Data:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/BulkImportResponse'
        HasMoreRecords:
          type:
          - boolean
          - 'null'
        NextCursor:
          type:
          - string
          - 'null'
      additionalProperties: false
    SortInfo:
      type: object
      properties:
        FieldName:
          type:
          - string
          - 'null'
          description: Field name on which records will be sorted
        Direction:
          $ref: '#/components/schemas/SortDirection'
      additionalProperties: false
      description: Sorting Information for Fields
    BulkImportResponse:
      type: object
      properties:
        JobId:
          type:
          - string
          - 'null'
          description: Job Id
        Id:
          type:
          - string
          - 'null'
          description: Batch Id
        Name:
          type:
          - string
          - 'null'
          description: File Name
        State:
          type:
          - string
          - 'null'
          description: Job Status
        ContentType:
          type:
          - string
          - 'null'
          description: Content Type
        CreatedBy:
          $ref: '#/components/schemas/LookupObject'
        CreatedDate:
          type: string
          description: Created Date
          format: date-time
        ModifiedBy:
          $ref: '#/components/schemas/LookupObject'
        ModifiedDate:
          type: string
          description: Modified Date
          format: date-time
        StartTime:
          type: string
          description: Start Time
          format: date-time
        EndTime:
          type: string
          description: End Time
          format: date-time
        ExternalId:
          type:
          - string
          - 'null'
          description: External Id
        TotalRecordCount:
          type: integer
          description: Total Record Count
          format: int32
        SuccessRecordCount:
          type: integer
          description: Success Record Count
          format: int32
        FailedRecordCount:
          type: integer
          description: Failed Record Count
          format: int32
      additionalProperties: false
      description: Bulk job Details
    LookupObject:
      type: object
      properties:
        Id:
          type:
          - string
          - 'null'
        Name:
          type:
          - string
          - 'null'
      additionalProperties: false
    CustomQuery:
      type: object
      properties:
        Limit:
          type:
          - integer
          - 'null'
          description: Number of the records to be fetched
          format: int32
        Skip:
          type:
          - integer
          - 'null'
          description: Number of the records to be skipped
          format: int32
        SortInfo:
          $ref: '#/components/schemas/SortInfo'
        CriteriaExpression:
          type:
          - string
          - 'null'
          description: Criteria Expression to filter the records
        Distinct:
          type: boolean
          description: Whether to fetch only distinct records
        Fields:
          type:
          - array
          - 'null'
          items:
            type: string
          description: The list of fields to be fetched
        GroupBy:
          type:
          - array
          - 'null'
          items:
            type: string
          description: Group Field name if the result to be grouped
        IncludeTotalCount:
          type: boolean
          description: Whether to include total count in the query response. Defaults to true.
      additionalProperties: false
      description: Custom Query
    FileResultAPIResponse:
      type: object
      properties:
        Success:
          type: boolean
          description: The state of the API response
        Data:
          type:
          - string
          - 'null'
          description: Generic data to return
          format: binary
        Warnings:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/WarningDetail'
          description: Warning detail list for non-blocking issues
        Errors:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/ErrorDetail'
          description: Error detail list in case of failure
      additionalProperties: false
      description: API Response Class
    ErrorDetail:
      type: object
      properties:
        Id:
          type:
          - string
          - 'null'
          description: Error ID
        Message:
          type:
          - string
          - 'null'
          description: Error message
      additionalProperties: false
      description: Error detail class
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT