TSGGLOBAL Support sign in
Skip to page content
Browse TNID API docs

TNID API documentation Company B2B connections Create B2B connection request

Create B2B connection request

On this page

GraphQL endpoint: /company

Sends a business-to-business connection request to another company. The connection type specifies the relationship (e.g., PARTNER, VENDOR, CUSTOMER). The request stays PENDING until the invited company accepts or rejects it.

Query

mutation (
  $invitedCompanyId: ID!
  $connectionType: B2bConnectionType!
) {
  createB2bConnectionRequest (
    invitedCompanyId: $invitedCompanyId
    connectionType: $connectionType
  ) {
    id
    status
    type
    insertedAt
    respondedAt
    updatedAt
    company {
      id
    }
    user {
      id
    }
    invitedCompany {
      id
    }
  }
}

Variables

{
  "connectionType": "PARTNER",
  "invitedCompanyId": "00000000-0000-4000-8000-000000000003"
}

Response

{
  "data": {
    "createB2bConnectionRequest": {
      "company": {
        "id": "00000000-0000-4000-8000-000000000001"
      },
      "id": "00000000-0000-4000-8000-000000000002",
      "insertedAt": "2026-01-15T09:00:00.000000",
      "invitedCompany": {
        "id": "00000000-0000-4000-8000-000000000003"
      },
      "respondedAt": null,
      "status": "PENDING",
      "type": "PARTNER",
      "updatedAt": "2026-01-15T09:00:00.000000",
      "user": null
    }
  }
}