> For the complete documentation index, see [llms.txt](https://docs.tnid.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tnid.com/api-reference/002_company/001_companies/002__invite_company_to_join_platform.md).

# Invite Company To Join Platform

GraphQL endpoint: `/company`

Use the `createB2bInvite` mutation to invite other companies to join the platform.

## Query

```graphql
mutation (
  $company: CompanyInput!
  $representatives: [InviteUserInput!]!
  $connectionType: B2bConnectionType!
) {
  createB2bInvite (
    company: $company
    representatives: $representatives
    connectionType: $connectionType
  ) {
    id
    status
    type
    insertedAt
    respondedAt
    updatedAt
    company {
      id
    }
    user {
      id
    }
    invitedCompany {
      id,
      profileName
    }
  }
}

```

## Variables

```json
{
  "company": {
    "aboutUs": "we are a nice company",
    "addresses": [
      {
        "city": "nice city",
        "country": "United States",
        "state": "Alabama",
        "street": "nice street",
        "types": [
          "SUPPORT"
        ],
        "zipCode": "123"
      }
    ],
    "brandName": "2brand-name",
    "legalName": "1legal-name",
    "yearFounded": 1900
  },
  "connectionType": "PARTNER",
  "representatives": [
    {
      "email": "test1@email.com",
      "firstName": "3john",
      "lastName": "4doe",
      "sendInviteEmail": true,
      "telephoneNumber": "2"
    }
  ]
}
```

## Response

```json
{
  "data": {
    "createB2bInvite": {
      "company": {
        "id": "00000000-0000-4000-8000-000000000001"
      },
      "id": "00000000-0000-4000-8000-000000000002",
      "insertedAt": "2026-01-15T09:00:00",
      "invitedCompany": {
        "id": "00000000-0000-4000-8000-000000000003",
        "profileName": "1legal-name-jtjh"
      },
      "respondedAt": null,
      "status": "PENDING",
      "type": "PARTNER",
      "updatedAt": "2026-01-15T09:00:00",
      "user": null
    }
  }
}
```