Unified.to unified API

openapi: 3.2.0
info:
  contact:
    email: hello@unified.to
    url: https://unified.to/contact
  description: One API to Rule Them All
  termsOfService: https://unified.to/tos
  title: .to Unified API
  version: '1.0'
servers:
- description: North American data region
  url: https://api.unified.to
- description: European data region
  url: https://api-eu.unified.to
- description: Australian data region
  url: https://api-au.unified.to
security:
- jwt: []
tags:
- name: unified
paths:
  /unified/apicall:
    get:
      operationId: listUnifiedApicalls
      parameters:
      - in: query
        name: limit
        required: false
        schema:
          type: number
      - in: query
        name: offset
        required: false
        schema:
          type: number
      - description: Return only results whose updated date is equal or greater to this value (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
        in: query
        name: updated_gte
        required: false
        schema:
          type: string
      - in: query
        name: sort
        required: false
        schema:
          type: string
      - in: query
        name: order
        required: false
        schema:
          type: string
      - description: Filter the results to only those integrations for your user referenced by this value
        in: query
        name: external_xref
        required: false
        schema:
          type: string
      - description: Filter the results to just this integration
        in: query
        name: integration_type
        required: false
        schema:
          type: string
      - description: Filter the results for API Calls with errors
        in: query
        name: error
        required: false
        schema:
          type: boolean
      - description: Filter the results to just this integration
        in: query
        name: connection_id
        required: false
        schema:
          type: string
      - in: query
        name: env
        required: false
        schema:
          type: string
      - description: Filter the results to just this webhook
        in: query
        name: webhook_id
        required: false
        schema:
          type: string
      - description: Filter the results to just this type
        in: query
        name: type
        required: false
        schema:
          type: string
      - description: Filter the results for only billable API Calls
        in: query
        name: is_billable
        required: false
        schema:
          type: boolean
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiCalls'
          description: Successful
      security:
      - jwt: []
      summary: Returns Api Calls
      tags:
      - unified
  /unified/apicall/{id}:
    get:
      operationId: getUnifiedApicall
      parameters:
      - description: ID of the Apicall
        in: path
        name: id
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiCall'
          description: Successful
      security:
      - jwt: []
      summary: Retrieve Specific Api Call by Its Id
      tags:
      - unified
  /unified/connection:
    get:
      operationId: listUnifiedConnections
      parameters:
      - in: query
        name: limit
        required: false
        schema:
          type: number
      - in: query
        name: offset
        required: false
        schema:
          type: number
      - description: Return only results whose updated date is equal or greater to this value (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
        in: query
        name: updated_gte
        required: false
        schema:
          type: string
      - in: query
        name: sort
        required: false
        schema:
          type: string
      - in: query
        name: order
        required: false
        schema:
          type: string
      - description: Filter the results to only those integrations for your user referenced by this value
        in: query
        name: external_xref
        required: false
        schema:
          type: string
      - description: Filter the results on these categories
        in: query
        name: categories
        required: false
        schema:
          items:
            enum:
            - passthrough
            - hris
            - ats
            - auth
            - crm
            - enrich
            - martech
            - ticketing
            - uc
            - accounting
            - storage
            - commerce
            - payment
            - genai
            - messaging
            - kms
            - task
            - scim
            - lms
            - repo
            - metadata
            - calendar
            - verification
            - ads
            - forms
            - shipping
            - assessment
            - signing
            type: string
          type: array
      - in: query
        name: env
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Connections'
          description: Successful
      security:
      - jwt: []
      summary: List All Connections
      tags:
      - unified
    post:
      description: Used only to import existing customer credentials; use "Authorize new connection" instead
      operationId: createUnifiedConnection
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Connection'
        description: A connection represents a specific authentication of an integration.
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Connection'
          description: Successful
      security:
      - jwt: []
      summary: Create Connection
      tags:
      - unified
  /unified/connection/{id}:
    delete:
      operationId: removeUnifiedConnection
      parameters:
      - description: ID of the Connection
        in: path
        name: id
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Successful
        default:
          content: {}
          description: Successful
          headers:
            Content-Type:
              required: false
              schema:
                type: string
      security:
      - jwt: []
      summary: Remove Connection
      tags:
      - unified
    get:
      operationId: getUnifiedConnection
      parameters:
      - description: ID of the Connection
        in: path
        name: id
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Connection'
          description: Successful
      security:
      - jwt: []
      summary: Retrieve Connection
      tags:
      - unified
    patch:
      operationId: patchUnifiedConnection
      parameters:
      - description: ID of the Connection
        in: path
        name: id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Connection'
        description: A connection represents a specific authentication of an integration.
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Connection'
          description: Successful
      security:
      - jwt: []
      summary: Update Connection
      tags:
      - unified
    put:
      operationId: updateUnifiedConnection
      parameters:
      - description: ID of the Connection
        in: path
        name: id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Connection'
        description: A connection represents a specific authentication of an integration.
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Connection'
          description: Successful
      security:
      - jwt: []
      summary: Update Connection
      tags:
      - unified
  /unified/environment:
    get:
      operationId: listUnifiedEnvironments
      parameters: []
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Environments'
          description: Successful
      security:
      - jwt: []
      summary: Returns All Environments
      tags:
      - unified
    post:
      operationId: createUnifiedEnvironment
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Environments'
        description: A list of environments in the workspace.
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Environments'
          description: Successful
      security:
      - jwt: []
      summary: Create New Environments
      tags:
      - unified
  /unified/environment/{env}:
    delete:
      operationId: removeUnifiedEnvironment
      parameters:
      - in: path
        name: env
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Environments'
          description: Successful
      security:
      - jwt: []
      summary: Remove an Environment
      tags:
      - unified
  /unified/integration:
    get:
      operationId: listUnifiedIntegrations
      parameters:
      - in: query
        name: limit
        required: false
        schema:
          type: number
      - in: query
        name: offset
        required: false
        schema:
          type: number
      - in: query
        name: updated_gte
        required: false
        schema:
          type: string
      - description: Filter the results on these categories
        in: query
        name: categories
        required: false
        schema:
          items:
            enum:
            - passthrough
            - hris
            - ats
            - auth
            - crm
            - enrich
            - martech
            - ticketing
            - uc
            - accounting
            - storage
            - commerce
            - payment
            - genai
            - messaging
            - kms
            - task
            - scim
            - lms
            - repo
            - metadata
            - calendar
            - verification
            - ads
            - forms
            - shipping
            - assessment
            - signing
            type: string
          type: array
      - in: query
        name: summary
        required: false
        schema:
          type: boolean
      - description: Filter the results for only the workspace's active integrations
        in: query
        name: active
        required: false
        schema:
          type: boolean
      - in: query
        name: env
        required: false
        schema:
          type: string
      - description: Filter the results for only this integration type
        in: query
        name: type
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Integrations'
          description: Successful
      security:
      - jwt: []
      summary: Returns All Integrations
      tags:
      - unified
  /unified/integration/auth/{workspace_id}/{integration_type}:
    get:
      description: Returns an authorization URL for the specified integration.  Once a successful authorization occurs, a new connection is created.
      operationId: getUnifiedIntegrationAuth
      parameters:
      - description: The URL where you want the user to be redirect to after a successful authorization.  The connection ID will be appended with (id=<connectionId>) to this URL, as will the state that was provided.
        in: query
        name: success_redirect
        required: false
        schema:
          type: string
      - description: The URL where you want the user to be redirect to after an unsuccessful authentication. An "error" variable will be appended.
        in: query
        name: failure_redirect
        required: false
        schema:
          type: string
      - description: Extra state to send back to your success URL
        in: query
        name: state
        required: false
        schema:
          type: string
      - description: Your user identifier to associate with the new Integration
        in: query
        name: external_xref
        required: false
        schema:
          type: string
      - in: query
        name: scopes
        required: false
        schema:
          items:
            type: string
          type: array
      - in: query
        name: redirect
        required: false
        schema:
          type: boolean
      - in: query
        name: env
        required: false
        schema:
          type: string
      - description: 'Language: en, fr, es, it, pt, zh, hi'
        in: query
        name: lang
        required: false
        schema:
          type: string
      - description: Optional tenant domain or subdomain for integrations that require it to build the authorize, token, or API URL. Depending on the integration, this may be a bare subdomain or a full domain/URL.
        in: query
        name: subdomain
        required: false
        schema:
          type: string
      - description: The ID of the workspace
        in: path
        name: workspace_id
        required: true
        schema:
          type: string
      - description: Type of the supported integration
        in: path
        name: integration_type
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            text/plain:
              schema:
                type: string
          description: Successful
      summary: Authorize New Connection
      tags:
      - unified
  /unified/integration/workspace/{workspace_id}:
    get:
      description: No authentication required as this is to be used by front-end interface
      operationId: listUnifiedIntegrationWorkspaces
      parameters:
      - in: query
        name: limit
        required: false
        schema:
          type: number
      - in: query
        name: offset
        required: false
        schema:
          type: number
      - in: query
        name: updated_gte
        required: false
        schema:
          type: string
      - description: Filter the results on these categories
        in: query
        name: categories
        required: false
        schema:
          items:
            enum:
            - passthrough
            - hris
            - ats
            - auth
            - crm
            - enrich
            - martech
            - ticketing
            - uc
            - accounting
            - storage
            - commerce
            - payment
            - genai
            - messaging
            - kms
            - task
            - scim
            - lms
            - repo
            - metadata
            - calendar
            - verification
            - ads
            - forms
            - shipping
            - assessment
            - signing
            type: string
          type: array
      - in: query
        name: summary
        required: false
        schema:
          type: boolean
      - description: Filter the results for only the workspace's active integrations
        in: query
        name: active
        required: false
        schema:
          type: boolean
      - in: query
        name: env
        required: false
        schema:
          type: string
      - description: The ID of the workspace
        in: path
        name: workspace_id
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Integrations'
          description: Successful
      summary: Returns All Activated Integrations in a Workspace
      tags:
      - unified
  /unified/issue:
    get:
      operationId: listUnifiedIssues
      parameters:
      - in: query
        name: limit
        required: false
        schema:
          type: number
      - in: query
        name: offset
        required: false
        schema:
          type: number
      - description: Return only results whose updated date is equal or greater to this value (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
        in: query
        name: updated_gte
        required: false
        schema:
          type: string
      - in: query
        name: sort
        required: false
        schema:
          type: string
      - in: query
        name: order
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Issues'
          description: Successful
      security:
      - jwt: []
      summary: List Support Issues
      tags:
      - unified
  /unified/issue/{id}:
    get:
      operationId: getUnifiedIssue
      parameters:
      - description: ID of the Issue
        in: path
        name: id
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Issue'
          description: Successful
      security:
      - jwt: []
      summary: Retrieve Support Issue
      tags:
      - unified
  /unified/webhook:
    get:
      operationId: listUnifiedWebhooks
      parameters:
      - in: query
        name: limit
        required: false
        schema:
          type: number
      - in: query
        name: offset
        required: false
        schema:
          type: number
      - description: Return only results whose updated date is equal or greater to this value (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
        in: query
        name: updated_gte
        required: false
        schema:
          type: string
      - in: query
        name: sort
        required: false
        schema:
          type: string
      - in: query
        name: order
        required: false
        schema:
          type: string
      - description: Filter the results for webhooks for only this object
        in: query
        name: object
        required: false
        schema:
          type: string
      - description: Filter the results to just this integration
        in: query
        name: integration_type
        required: false
        schema:
          type: string
      - description: Filter the results to just this integration
        in: query
        name: connection_id
        required: false
        schema:
          type: string
      - description: Return only results whose created date is equal or less to this value
        in: query
        name: created_lte
        required: false
        schema:
          type: string
      - in: query
        name: env
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Webhooks'
          description: Successful
      security:
      - jwt: []
      summary: Returns All Registered Webhooks
      tags:
      - unified
    post:
      description: The data payload received by your server is described at https://docs.unified.to/unified/overview. The `interval` field can be set as low as 1 minute for paid accounts, and 60 minutes for free accounts.
      operationId: createUnifiedWebhook
      parameters:
      - description: When set, all of the existing data will sent back to your server.
        in: query
        name: include_all
        required: false
        schema:
          type: boolean
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Webhook'
        description: A webhook is used to POST new/updated information to your server.
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Webhook'
          description: Successful
      security:
      - jwt: []
      summary: Create Webhook Subscription
      tags:
      - unified
  /unified/webhook/{id}:
    delete:
      operationId: removeUnifiedWebhook
      parameters:
      - description: ID of the Webhook
        in: path
        name: id
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Successful
        default:
          content: {}
          description: Successful
          headers:
            Content-Type:
              required: false
              schema:
                type: string
      security:
      - jwt: []
      summary: Remove Webhook Subscription
      tags:
      - unified
    get:
      operationId: getUnifiedWebhook
      parameters:
      - description: ID of the Webhook
        in: path
        name: id
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Webhook'
          description: Successful
      security:
      - jwt: []
      summary: Retrieve Webhook by Its Id
      tags:
      - unified
    patch:
      operationId: patchUnifiedWebhook
      parameters:
      - description: ID of the Webhook
        in: path
        name: id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Webhook'
        description: A webhook is used to POST new/updated information to your server.
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Webhook'
          description: Successful
      security:
      - jwt: []
      summary: Update Webhook Subscription
      tags:
      - unified
    put:
      operationId: updateUnifiedWebhook
      parameters:
      - description: ID of the Webhook
        in: path
        name: id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Webhook'
        description: A webhook is used to POST new/updated information to your server.
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Webhook'
          description: Successful
      security:
      - jwt: []
      summary: Update Webhook Subscription
      tags:
      - unified
  /unified/webhook/{id}/trigger:
    patch:
      operationId: patchUnifiedWebhookTrigger
      parameters:
      - description: ID of the Webhook
        in: path
        name: id
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Successful
        default:
          content: {}
          description: Successful
          headers:
            Content-Type:
              required: false
              schema:
                type: string
      security:
      - jwt: []
      summary: Trigger Webhook
      tags:
      - unified
    put:
      operationId: updateUnifiedWebhookTrigger
      parameters:
      - description: ID of the Webhook
        in: path
        name: id
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Successful
        default:
          content: {}
          description: Successful
          headers:
            Content-Type:
              required: false
              schema:
                type: string
      security:
      - jwt: []
      summary: Trigger Webhook
      tags:
      - unified
components:
  schemas:
    property_Connection_permissions:
      items:
        enum:
        - accounting_account_read
        - accounting_account_write
        - accounting_transaction_read
        - accounting_transaction_write
        - accounting_journal_read
        - accounting_journal_write
        - accounting_invoice_read
        - accounting_invoice_write
        - accounting_bill_read
        - accounting_bill_write
        - accounting_creditmemo_read
        - accounting_creditmemo_write
        - accounting_contact_read
        - accounting_contact_write
        - accounting_expense_read
        - accounting_expense_write
        - accounting_taxrate_read
        - accounting_taxrate_write
        - accounting_organization_read
        - accounting_order_read
        - accounting_order_write
        - accounting_purchaseorder_read
        - accounting_purchaseorder_write
        - accounting_salesorder_read
        - accounting_salesorder_write
        - accounting_report_read
        - accounting_report_write
        - accounting_trialbalance_read
        - accounting_trialbalance_write
        - accounting_profitloss_read
        - accounting_profitloss_write
        - accounting_balancesheet_read
        - accounting_balancesheet_write
        - accounting_category_read
        - accounting_category_write
        - payment_payment_read
        - payment_payment_write
        - accounting_cashflow_read
        - accounting_cashflow_write
        - payment_payout_read
        - payment_refund_read
        - payment_link_read
        - payment_link_write
        - payment_subscription_read
        - payment_subscription_write
        - commerce_item_read
        - commerce_item_write
        - commerce_collection_read
        - commerce_collection_write
        - commerce_inventory_read
        - commerce_inventory_write
        - commerce_location_read
        - commerce_location_write
        - commerce_review_read
        - commerce_review_write
        - commerce_saleschannel_read
        - commerce_saleschannel_write
        - commerce_itemvariant_read
        - commerce_itemvariant_write
        - commerce_reservation_read
        - commerce_reservation_write
        - commerce_availability_read
        - commerce_availability_write
        - verification_package_read
        - verification_request_read
        - verification_request_write
        - assessment_package_read
        - assessment_package_write
        - assessment_order_write
        - ats_activity_read
        - ats_activity_write
        - ats_application_read
        - ats_application_write
        - ats_applicationstatus_read
        - ats_candidate_read
        - ats_candidate_write
        - ats_interview_read
        - ats_interview_write
        - ats_job_read
        - ats_job_write
        - ats_company_read
        - ats_company_write
        - ats_document_read
        - ats_document_write
        - ats_scorecard_read
        - ats_scorecard_write
        - crm_company_read
        - crm_company_write
        - crm_contact_read
        - crm_contact_write
        - crm_deal_read
        - crm_deal_write
        - crm_event_read
        - crm_event_write
        - crm_lead_read
        - crm_lead_write
        - crm_pipeline_read
        - crm_pipeline_write
        - martech_list_read
        - martech_list_write
        - martech_member_read
        - martech_member_write
        - martech_campaign_read
        - martech_campaign_write
        - martech_report_read
        - martech_report_write
        - ticketing_customer_read
        - ticketing_customer_write
        - ticketing_ticket_read
        - ticketing_ticket_write
        - ticketing_note_read
        - ticketing_note_write
        - ticketing_category_read
        - ticketing_category_write
        - hris_employee_read
        - hris_employee_write
        - hris_group_read
        - hris_group_write
        - hris_payslip_read
        - hris_payslip_write
        - hris_timeoff_read
        - hris_timeoff_write
        - hris_timeshift_read
        - hris_timeshift_write
        - hris_company_read
        - hris_company_write
        - hris_location_read
        - hris_location_write
        - hris_device_read
        - hris_device_write
        - hris_deduction_read
        - hris_deduction_write
        - hris_benefit_read
        - hris_benefit_write
        - hris_bankaccount_read
        - hris_bankaccount_write
        - uc_call_read
        - uc_contact_read
        - uc_contact_write
        - uc_comment_read
        - uc_comment_write
        - uc_recording_read
        - storage_file_read
        - storage_file_write
        - webhook
        - genai_model_read
        - genai_prompt_read
        - genai_prompt_write
        - genai_embedding_read
        - genai_embedding_write
        - messaging_message_read
        - messaging_message_write
        - messaging_channel_read
        - messaging_event_read
        - messaging_event_write
        - kms_space_read
        - kms_space_write
        - kms_page_read
        - kms_page_write
        - kms_comment_read
        - kms_comment_write
        - task_project_read
        - task_project_write
        - task_task_read
        - task_task_write
        - task_change_read
        - task_comment_read
        - task_comment_write
        - scim_users_read
        - scim_users_write
        - scim_groups_read
        - scim_groups_write
        - lms_course_read
        - lms_course_write
        - lms_class_read
        - lms_class_write
        - lms_student_read
        - lms_student_write
        - lms_instructor_read
        - lms_instructor_write
        - lms_content_read
        - lms_content_write
        - lms_collection_read
        - lms_collection_write
        - lms_activity_read
        - lms_activity_write
        - repo_organization_read
        - repo_organization_write
        - repo_repository_read
        - repo_repository_write
        - repo_branch_read
        - repo_branch_write
        - repo_commit_read
        - repo_commit_write
        - repo_pullrequest_read
        - repo_pullrequest_write
        - metadata_metadata_read
        - metadata_metadata_write
        - calendar_calendar_read
        - calendar_calendar_write
        - calendar_event_read
        - calendar_event_write
        - calendar_busy_read
        - calendar_link_read
        - calendar_link_write
        - calendar_recording_read
        - calendar_recording_write
        - calendar_webinar_read
        - calendar_webinar_write
        - enrich_person_read
        - enrich_company_read
        - ads_ad_read
        - ads_ad_write
        - ads_campaign_read
        - ads_campaign_write
        - ads_group_read
        - ads_group_write
        - ads_report_read
        - ads_organization_read
        - ads_organization_write
        - ads_creative_read
        - ads_creative_write
        - ads_insertionorder_read
        - ads_insertionorder_write
        - ads_target_read
        - ads_promoted_read
        - forms_form_read
        - forms_form_write
        - forms_submission_read
        - forms_submission_write
        - shipping_shipment_read
        - shipping_shipment_write
        - shipping_label_read
        - shipping_label_write
        - shipping_tracking_read
        - shipping_rate_read
        - shipping_carrier_read
        - signing_document_read
        - signing_document_write
        - signi

# --- truncated at 32 KB (79 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/unified-to/refs/heads/main/openapi/unified-to-unified-api-openapi.yml