Net-new company request

Steps

1. Collect what you know about the company: DUNS number, name, website, or country.
2. Call createCompanyRequests with one CompanyRequestInput per company.
3. Store companyRequests[].id from the response.
4. Poll companyRequest(id) until status is COMPLETED. See Report chain for the full flow.

Sample request

mutation CreateCompanyRequests {
  createCompanyRequests(
    input: {
      idempotencyKey: "order-2026-09-02-001"
      companyRequests: [
        {
          subscriptionSetIds: ["<subscription-set-id>"]
          duns: "123456789"
          companyName: "Example Industries GmbH"
          website: "https://example.com"
          country: "DE"
        }
      ]
    }
  ) {
    companyRequests {
      id
      status
      createdAt
    }
    errors {
      __typename
      ... on Error {
        message
      }
    }
  }
}

Sample response

{
  "data": {
    "createCompanyRequests": {
      "companyRequests": [
        {
          "id": "<company-request-id>",
          "status": "REQUESTED",
          "createdAt": "2026-09-02T09:00:00Z"
        }
      ],
      "errors": []
    }
  }
}

Next call: use companyRequests[0].id in companyRequest(id) to read the status. Possible values of status: REQUESTED, NEEDS_ACTION, PROCESSING, COMPLETED, COMPANY_CLOSED, RETIRED.

Error example

The batch fails as a whole. companyRequests is empty and errors lists the cause.

{
  "data": {
    "createCompanyRequests": {
      "companyRequests": [],
      "errors": [{ "__typename": "ValidationError", "message": "country must be an ISO 3166-1 alpha-2 code" }]
    }
  }
}