Create B2C connection request

GraphQL endpoint: /company

Sends a connection request from a company to a user (person). The connection type specifies the nature of the relationship (e.g., CUSTOMER, PARTNER, VENDOR). The invited user receives a notification and can accept or reject the request. The request stays PENDING until the user responds.

Query

mutation (
  $invitedUserId: ID!
  $connectionType: B2cConnectionType!
) {
  createB2cConnectionRequest (
    invitedUserId: $invitedUserId
    connectionType: $connectionType
  ) {
    id
    status
    type
    insertedAt
    respondedAt
    updatedAt
    company {
      id
    }
    user {
      id
    }
    invitedUser {
      id
    }
  }
}

Variables

{
  "connectionType": "CUSTOMER",
  "invitedUserId": "00000000-0000-4000-8000-000000000003"
}

Response

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