> ## Documentation Index
> Fetch the complete documentation index at: https://docs.buzzkit.dev/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> BuzzKit is an open source notification orchestration layer. Send mobile push from a backend with one POST to /v1/messages, targeting a subscriber id, a topic, a saved segment or an inline expression. Subscribers are addressed by the caller's own user ids. Authenticate with a bearer API key from the dashboard; workspace keys pick a tenant with the BuzzKit-Tenant header. Every response is the envelope { success, data, error, metadata } and errors carry a stable snake_case code. iOS is the supported client SDK. The machine-readable API description is at https://buzzkit.dev/openapi.json.

# Export from Pushwoosh

> Export a Pushwoosh segment to CSV with push tokens, then map the columns in BuzzKit.

Pushwoosh exports segments as CSV with the push token and the device type on every row, which is everything a migration needs.

## From the dashboard

1. Open **Audience**, then **Segments**.
2. Open the segment to export. To export everyone, use a segment with no conditions.
3. Choose **Refresh & Export to CSV**. The file holds one row per device with the tag values, the push token and the device type.

## From the Segmentation API

The [Segmentation API](https://docs.pushwoosh.com/developer/api-reference/segmentation-filters-api/) exports the same data for larger audiences. Ask for `csv` as the format and include the push tokens and the user ids in the exported data:

```json theme={null}
{
  "request": {
    "auth": "YOUR_API_TOKEN",
    "application": "YOUR_APP_CODE",
    "format": "csv",
    "exportData": ["push_tokens", "users", "hwids", "tags"],
    "includeWithoutTokens": false
  }
}
```

The response points at a file to download.

## Map it in BuzzKit

The import asks for the columns, since Pushwoosh names them by tag:

| Pick                             | Column                                                                                                  |
| -------------------------------- | ------------------------------------------------------------------------------------------------------- |
| External id                      | The user id column (`user_id` or the tag you set user ids with)                                         |
| Token or address                 | The push token column                                                                                   |
| Column contents                  | Apple or Android device tokens. Export Apple and Android as two segments when the file mixes platforms. |
| Keep other columns as attributes | On, to carry the tag values over                                                                        |

Rows without a user id are skipped, since Pushwoosh's hardware id is not something the app can identify a user with later.