Preview

importCompanyFromPsaForOnboarding is in Preview status and is subject to change without notice. For more information about Preview status, see the GraphQL API policy.

importCompanyFromPsaForOnboarding

Onboarding-specific company import for Magical Onboarding. Reuses the createCompany composition model in one atomic boundary:

  1. Fetches company details from ConnectWise using the company ID
  2. Creates the company in AppDirect using the createAccount API
  3. Creates the PsaCompanyMapping (phase 1 COMPANY_SYNC)
  4. Persists company_import_records audit

This page contains

    Authorization Rules

    This request requires authorization with at least one of the following scopes:

    Scopes

    ROLE_CHANNEL_ADMIN

    ROLE_CHANNEL_SUPPORT

    ROLE_PARTNER

    ROLE_SALES_SUPPORT

    ROLE_RESELLER

    ROLE_RESELLER_MANAGER

    Arguments

    input ImportCompanyFromPsaForOnboardingInput! PREVIEW

    ImportCompanyFromPsaForOnboardingInput fields

    psaCompanyIds [Int!]!

    List of PSA company IDs to import (supports single or multiple)

    mor PsaMorInput! PREVIEW

    Merchant of record

    defaultCountryCode String

    Default country code to use when PSA company does not have country information (e.g., US, CA, IN). This is typically the marketplace country code.

    Return Fields

    results [OnboardingCompanyImportResult!] PREVIEW

    Results for each onboarding company import

    success Boolean

    Overall success status

    userErrors [ImportCompanyFromPsaForOnboardingError!] PREVIEW

    Error details (for backward compatibility)

    Interactive example

    This is an example mutation query. Use the embedded interactive tool below to edit the query.

    Hint: use Ctrl + Space for autocompleting fields.