# API Campagnes

## createCampaign

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

Crée une campagne push au sein de l'application.

#### Request Body

| Nom | Type | Description |
| --- | --- | --- |
| auth\* | string | [Token d'accès API](/fr/developer/api-reference/api-identifiers/#api-access-token) depuis le Control Panel Pushwoosh. |
| application\* | string | [Code d'application Pushwoosh](/fr/developer/api-reference/api-identifiers/#application-code) |
| name\* | string | Nom de la campagne. |
| description | string | Description de la campagne. |

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

```
{
  "request": {
    "auth": "yxoPUlwqm…………pIyEX4H",       // required. API access token from Pushwoosh Control Panel
    "application": "XXXXX-XXXXX",         // required. Pushwoosh application code
    "name": "CAMPAIGN_NAME",              // required.
    "description": "CAMPAIGN_DESCRIPTION" // optional.
  }
}
```

## deleteCampaign

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

Supprime une campagne spécifique.

#### Request Body

| Nom | Type | Description |
| --- | --- | --- |
| auth\* | string | [Token d'accès API](/fr/developer/api-reference/api-identifiers/#api-access-token) depuis le Control Panel Pushwoosh. |
| campaign\* | string | [Code d'une campagne](/fr/developer/api-reference/api-identifiers/#campaign-code) à supprimer. |

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

```json title="Example"
{
  "request": {
    "auth": "yxoPUlwqm…………pIyEX4H", // required. API access token from Pushwoosh Control Panel
    "campaign": "XXXXX-XXXXX"       // required. ID of a campaign to delete
  }
}
```

## getCampaigns

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

Récupère la liste des campagnes pour l'application.

#### Request Body

| Nom | Type | Description |
| --- | --- | --- |
| auth\* | string | [Token d'accès API](/fr/developer/api-reference/api-identifiers/#api-access-token) depuis le Control Panel Pushwoosh. |
| application\* | string | [Code d'application Pushwoosh](/fr/developer/api-reference/api-identifiers/#application-code) |
| cursor | string | Indique la dernière campagne récupérée lors de la requête précédente. |
| limit | integer | Le nombre maximum de campagnes pour une seule réponse. |

<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",   // required. API access token from Pushwoosh Control Panel
    "application": "XXXXX-XXXXX",          // required. Pushwoosh application code
    "cursor": "+4PxJPhhwITD4PFsiKui1BA==", // optional. Indicates the last campaign retrieved in the previous request.
    "limit": 100                           // optional. The max number of campaigns
                                           //           for a single response.
  }
}
```