# Campaigns API

## createCampaign

`POST` `https://api.pushwoosh.com/json/1.3/createCampaign`

Создает push-кампанию в приложении.

#### Тело запроса

| Name | Type | Описание |
| --- | --- | --- |
| auth\* | string | [API access token](/ru/developer/api-reference/api-identifiers/#api-access-token) из Pushwoosh Control Panel. |
| application\* | string | [Pushwoosh application code](/ru/developer/api-reference/api-identifiers/#application-code) |
| name\* | string | Имя кампании. |
| description | string | Описание кампании. |

<Tabs>
<TabItem label="200">
```json
{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "campaign": "XXXXX-XXXXX"
  }
}
```
</TabItem>
</Tabs>

```
{
  "request": {
    "auth": "yxoPUlwqm…………pIyEX4H",       // обязательно. API access token из Pushwoosh Control Panel
    "application": "XXXXX-XXXXX",         // обязательно. Pushwoosh application code
    "name": "CAMPAIGN_NAME",              // обязательно.
    "description": "CAMPAIGN_DESCRIPTION" // необязательно.
  }
}
```

## deleteCampaign

`POST` `https://api.pushwoosh.com/json/1.3/deleteCampaign`

Удаляет определенную кампанию.

#### Тело запроса

| Name | Type | Описание |
| --- | --- | --- |
| auth\* | string | [API access token](/ru/developer/api-reference/api-identifiers/#api-access-token) из Pushwoosh Control Panel. |
| campaign\* | string | [Код кампании](/ru/developer/api-reference/api-identifiers/#campaign-code) для удаления. |

<Tabs>
<TabItem label="200">
```json
{
  "status_code": 200,
  "status_message": "OK",
  "response": null
}
```
</TabItem>
</Tabs>

```json title="Example"
{
  "request": {
    "auth": "yxoPUlwqm…………pIyEX4H", // обязательно. API access token из Pushwoosh Control Panel
    "campaign": "XXXXX-XXXXX"       // обязательно. ID кампании для удаления
  }
}
```

## getCampaigns

`POST` `https://api.pushwoosh.com/json/1.3/getCampaigns`

Получает список кампаний для приложения.

#### Тело запроса

| Name | Type | Описание |
| --- | --- | --- |
| auth\* | string | [API access token](/ru/developer/api-reference/api-identifiers/#api-access-token) из Pushwoosh Control Panel. |
| application\* | string | [Pushwoosh application code](/ru/developer/api-reference/api-identifiers/#application-code) |
| cursor | string | Указывает на последнюю кампанию, полученную в предыдущем запросе. |
| limit | integer | Максимальное количество кампаний в одном ответе. |

<Tabs>
<TabItem label="200">
```json
{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "campaigns": [{
      "code": "7CFF3-63A7B",
      "name": "CAMPAIGN_NAME_1",
      "description": "DESCRIPTION1"
    }, {
      "code": "C284C-33DD3",
      "name": "CAMPAIGN_NAME_2",
      "description": "DESCRIPTION2"
    }],
    "limit": 100,
    "cursor": "+4PxJPhhwITD4PFsiKui1BA=="
  }
}
```
</TabItem>
</Tabs>

```json title="Example"
{
  "request": {
    "auth": "jLbec2UW........ztFSOf5Za",   // обязательно. API access token из Pushwoosh Control Panel
    "application": "XXXXX-XXXXX",          // обязательно. Pushwoosh application code
    "cursor": "+4PxJPhhwITD4PFsiKui1BA==", // необязательно. Указывает на последнюю кампанию, полученную в предыдущем запросе.
    "limit": 100                           // необязательно. Максимальное количество кампаний
                                           //           в одном ответе.
  }
}
```