---
title: Müşteri etiketleri
description: Müşteri etiketlerini yönetin.
full: true
---

## CustomerTag nesnesi [#CustomerTag]

**`CustomerTag`** (v1 · v2)

| Alan | Tip | Açıklama |
| --- | --- | --- |
| `createdAt` | `Timestamp` | Kaydın oluşturulma zamanı (milisaniye cinsinden Unix zaman damgası). |
| `deleted` | `Boolean!` | Kaydın silinmiş olup olmadığı. |
| `id` | `String!` | Kaydın ID değeri. |
| `name` | `String!` |  |
| `updatedAt` | `Timestamp` | Kaydın son güncellenme zamanı (milisaniye cinsinden Unix zaman damgası). |

Örnek (temsili):

```json
{
  "createdAt": 1735725600000,
  "deleted": false,
  "id": "0f9d2c3e-6b1a-4c7e-9a52-3d8e1f4b7c21",
  "name": "Örnek",
  "updatedAt": 1735725600000
}
```

## Müşteri etiketlerini listele [#listCustomerTag]

**`listCustomerTag`** (query, v1 · v2)

Parametreler:

| Alan | Tip | Açıklama |
| --- | --- | --- |
| `id` | `StringFilterInput` | Kaydın ID değeri. |
| `name` | `StringFilterInput` |  |
| `search` (yalnızca v2) | `String` | Serbest metin araması. |
| `updatedAt` | `DateFilterInput` | Kaydın son güncellenme zamanı (milisaniye cinsinden Unix zaman damgası). |
| `includeDeleted` (yalnızca v1) | `Boolean` | `true` gönderilirse silinmiş kayıtlar da listelenir. |

Dönen değer: `[CustomerTag!]!`

Örnek istek - Müşteri etiketlerini listeleme (`POST https://api.myikas.com/api/v2/admin/graphql`):

Etiket adına göre arama yaparak eşleşen müşteri etiketlerini döndürür.

```graphql
query ListCustomerTag($search: String) {
  listCustomerTag(search: $search) {
    id
    name
    createdAt
    updatedAt
  }
}
```

```json
{
  "search": "VIP"
}
```

Örnek yanıt (temsili):

```json
{
  "data": {
    "listCustomerTag": [
      {
        "id": "0f9d2c3e-6b1a-4c7e-9a52-3d8e1f4b7c21",
        "name": "Örnek",
        "createdAt": 1735725600000,
        "updatedAt": 1735725600000
      }
    ]
  }
}
```

## Müşteri etiketi oluştur [#createCustomerTag]

**`createCustomerTag`** (mutation, v2)

CustomerTag oluşturan mutation.

Yalnızca v2 endpoint'inde: `https://api.myikas.com/api/v2/admin/graphql`

Parametreler:

| Alan | Tip | Açıklama |
| --- | --- | --- |
| `input` (zorunlu) | `CreateCustomerTagInput!` | İşlemin girdi nesnesi. |

Dönen değer: `CustomerTag!`

Örnek istek - Müşteri etiketi oluşturma (`POST https://api.myikas.com/api/v2/admin/graphql`):

Müşterileri segmentlere ayırmak için yeni bir etiket oluşturur; örneğin bir sadakat uygulaması üyelerini işaretlemek için.

```graphql
mutation CreateCustomerTag($input: CreateCustomerTagInput!) {
  createCustomerTag(input: $input) {
    id
    name
    createdAt
  }
}
```

```json
{
  "input": {
    "name": "VIP"
  }
}
```

Örnek yanıt (temsili):

```json
{
  "data": {
    "createCustomerTag": {
      "id": "0f9d2c3e-6b1a-4c7e-9a52-3d8e1f4b7c21",
      "name": "Örnek",
      "createdAt": 1735725600000
    }
  }
}
```

## Müşteri etiketini güncelle [#updateCustomerTag]

**`updateCustomerTag`** (mutation, v2)

CustomerTag güncelleyen mutation.

Yalnızca v2 endpoint'inde: `https://api.myikas.com/api/v2/admin/graphql`

Parametreler:

| Alan | Tip | Açıklama |
| --- | --- | --- |
| `input` (zorunlu) | `UpdateCustomerTagInput!` | İşlemin girdi nesnesi. |

Dönen değer: `CustomerTag!`

Örnek istek - Müşteri etiketi güncelleme (`POST https://api.myikas.com/api/v2/admin/graphql`):

Mevcut bir müşteri etiketinin adını değiştirmek için kullanılır.

```graphql
mutation UpdateCustomerTag($input: UpdateCustomerTagInput!) {
  updateCustomerTag(input: $input) {
    id
    name
    updatedAt
  }
}
```

```json
{
  "input": {
    "id": "2fd03b37-0ff3-444b-9aad-a4204ff07bbe",
    "name": "VIP Müşteri"
  }
}
```

Örnek yanıt (temsili):

```json
{
  "data": {
    "updateCustomerTag": {
      "id": "0f9d2c3e-6b1a-4c7e-9a52-3d8e1f4b7c21",
      "name": "Örnek",
      "updatedAt": 1735725600000
    }
  }
}
```

## Müşteri etiketi kaydet [#saveCustomerTag]

**`saveCustomerTag`** (mutation, v1)

CustomerTag kaydeden mutation.

Yalnızca v1 endpoint'inde: `https://api.myikas.com/api/v1/admin/graphql`. v2 karşılığı: `createCustomerTag`, `updateCustomerTag`.

Parametreler:

| Alan | Tip | Açıklama |
| --- | --- | --- |
| `input` (zorunlu) | `CustomerTagInput!` | İşlemin girdi nesnesi. |

Dönen değer: `CustomerTag!`

Örnek istek - Müşteri etiketi kaydetme (`POST https://api.myikas.com/api/v1/admin/graphql`):

```graphql
mutation SaveCustomerTag($input: CustomerTagInput!) {
  saveCustomerTag(input: $input) {
    id
    name
    createdAt
  }
}
```

```json
{
  "input": {
    "name": "Toptan Alıcı"
  }
}
```

Örnek yanıt (temsili):

```json
{
  "data": {
    "saveCustomerTag": {
      "id": "0f9d2c3e-6b1a-4c7e-9a52-3d8e1f4b7c21",
      "name": "Örnek",
      "createdAt": 1735725600000
    }
  }
}
```

## Müşteri etiketlerini sil [#deleteCustomerTagList]

**`deleteCustomerTagList`** (mutation, v1 · v2)

CustomerTag silen mutation.

Parametreler:

| Alan | Tip | Açıklama |
| --- | --- | --- |
| `idList` (zorunlu) | `[String!]!` | İşlem yapılacak kayıtların ID listesi. |

Dönen değer: `Boolean!`

Örnek istek - Müşteri etiketlerini silme (`POST https://api.myikas.com/api/v2/admin/graphql`):

```graphql
mutation DeleteCustomerTagList($idList: [String!]!) {
  deleteCustomerTagList(idList: $idList)
}
```

```json
{
  "idList": [
    "bfdd11e0-1b95-4b3d-aaf0-8df34e8c1678",
    "ecc9d023-a4bb-4928-9675-07cc670a2377"
  ]
}
```

Örnek yanıt (temsili):

```json
{
  "data": {
    "deleteCustomerTagList": true
  }
}
```