> 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/001_user/004_telephone_number/001__create_user_telephone_number.md).

# Create User Telephone Number

GraphQL endpoint: `/user`

Creates a new telephone number for the user. The telephone number will be added to the user's profile with the specified types and visibility settings. The telephone number starts as unverified.

## Query

```graphql
mutation (
  $number: String!
  $countryCode: String!
  $types: [UserTelephoneNumberType!]
  $visibility: [UserVisibilityType!]
) {
  createUserTelephoneNumber (
    number: $number
    countryCode: $countryCode
    types: $types
    visibility: $visibility
  ) {
    id
    number
    types
    visibility
  }
}

```

## Variables

```json
{
  "countryCode": "1",
  "number": "1",
  "types": [
    "HOME"
  ],
  "visibility": [
    "FAMILY"
  ]
}
```

## Response

```json
{
  "data": {
    "createUserTelephoneNumber": {
      "id": "00000000-0000-4000-8000-000000000001",
      "number": "11",
      "types": [
        "HOME"
      ],
      "visibility": [
        "FAMILY"
      ]
    }
  }
}
```