# API de Campañas

## createCampaign

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

Crea una campaña push dentro de la aplicación.

#### Request Body

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| auth\* | string | [Token de acceso a la API](/es/developer/api-reference/api-identifiers/#api-access-token) del Panel de Control de Pushwoosh. |
| application\* | string | [Código de aplicación de Pushwoosh](/es/developer/api-reference/api-identifiers/#application-code) |
| name\* | string | Nombre de la campaña. |
| description | string | Descripción de la campaña. |

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

```
{
  "request": {
    "auth": "yxoPUlwqm…………pIyEX4H",       // requerido. Token de acceso a la API del Panel de Control de Pushwoosh
    "application": "XXXXX-XXXXX",         // requerido. Código de aplicación de Pushwoosh
    "name": "CAMPAIGN_NAME",              // requerido.
    "description": "CAMPAIGN_DESCRIPTION" // opcional.
  }
}
```

## deleteCampaign

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

Elimina una campaña específica.

#### Request Body

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| auth\* | string | [Token de acceso a la API](/es/developer/api-reference/api-identifiers/#api-access-token) del Panel de Control de Pushwoosh. |
| campaign\* | string | [Código de una campaña](/es/developer/api-reference/api-identifiers/#campaign-code) para eliminar. |

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

```json title="Ejemplo"
{
  "request": {
    "auth": "yxoPUlwqm…………pIyEX4H", // requerido. Token de acceso a la API del Panel de Control de Pushwoosh
    "campaign": "XXXXX-XXXXX"       // requerido. ID de una campaña para eliminar
  }
}
```

## getCampaigns

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

Recupera la lista de campañas para la aplicación.

#### Request Body

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| auth\* | string | [Token de acceso a la API](/es/developer/api-reference/api-identifiers/#api-access-token) del Panel de Control de Pushwoosh. |
| application\* | string | [Código de aplicación de Pushwoosh](/es/developer/api-reference/api-identifiers/#application-code) |
| cursor | string | Indica la última campaña recuperada en la solicitud anterior. |
| limit | integer | El número máximo de campañas para una sola respuesta. |

<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="Ejemplo"
{
  "request": {
    "auth": "jLbec2UW........ztFSOf5Za",   // requerido. Token de acceso a la API del Panel de Control de Pushwoosh
    "application": "XXXXX-XXXXX",          // requerido. Código de aplicación de Pushwoosh
    "cursor": "+4PxJPhhwITD4PFsiKui1BA==", // opcional. Indica la última campaña recuperada en la solicitud anterior.
    "limit": 100                           // opcional. El número máximo de campañas
                                           //           para una sola respuesta.
  }
}
```