> 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/007_b2c_subscriptions/004__create_b2c_subscription_request.md).

# Create B2C Subscription Request

GraphQL endpoint: `/company`

Sends a subscription request to a user asking for their consent to receive communications of the given type (EMAIL, SMS, VOICE). The request stays PENDING until the user responds. If the user accepts, a B2C subscription is created. If they reject, the request is marked as rejected and no subscription is created.

## Query

```graphql
mutation (
  $invitedUserId: ID!
  $type: B2cSubscriptionType!
  $subscriptionTopicIds: [ID!]
) {
  createB2cSubscriptionRequest (
    invitedUserId: $invitedUserId
    type: $type
    subscriptionTopicIds: $subscriptionTopicIds
  ) {
    id
    status
    type
    insertedAt
    updatedAt
    respondedAt
    company {
      id
    }
    user {
      id
    }
    invitedUser {
      id
    }
  }
}

```

## Variables

```json
{
  "invitedUserId": "00000000-0000-4000-8000-000000000003",
  "type": "EMAIL"
}
```

## Response

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