---
title: "Create bulk send audience"
method: POST
path: "/api/bulk/{platform_name}"
tags: ["Bulk Sending"]
---

# Create bulk send audience

`POST /api/bulk/{platform_name}`

## Request

- Base URL: `https://go.urbanairship.com`
- URL: `https://go.urbanairship.com/api/bulk/{platform_name}`
- Auth: one of:
  - HTTP basic
  - HTTP bearer
- TypeScript: <https://skmtc.dev/airship/apis/airship-api/docs/api/bulk/:platform_name/post.ts> (a function with typed inputs; its response is checked against the schema)

Upload a CSV to obtain a `bulk_id` for sending messages. The CSV can contain:
- Channel IDs for Upload and Send endpoints: [Send message with bulk ID](/developer/rest-api/ua/operations/bulk-sending/#bulksendpush) or [Schedule message with bulk ID](/developer/rest-api/ua/operations/bulk-sending/#schedulebulksendpush)
- Email addresses, phone numbers, or open channel addresses for Create and Send endpoints: [Create and Send a message](/developer/rest-api/ua/operations/bulk-sending/#createandsend) or [Schedule a Create and Send message](/developer/rest-api/ua/operations/bulk-sending/#schedulecreateandsendoperations)

See [Bulk sending](/guides/messaging/bulk-sending/) for CSV formatting requirements.

## Request body `text/csv`

- string: A CSV of channel IDs, email addresses, MSISDNs, or open channel addresses. See [Bulk sending](/guides/messaging/bulk-sending/) for CSV formatting requirements.

## Response `200`

The CSV was uploaded successfully and is now being processed.

- UploadCsvResponse: The upload CSV response.
  - `bulk_id` string, uuid: A unique string that identifies the audience provided in the CSV for bulk sending.
  - `field_names` string[]: A list of the field names found in the CSV.
  - `ok` boolean: Success.

## Other responses

- `400`: Bad Request. Parsing or validating the request failed.
- `401`: Authentication information (the app key and secret or bearer token) was either incorrect or missing.

## Changes

- **2025-11-19** `43eb86d7e2d0`: 2 info
  - api tag `Bulk Sending` added
  - api tag `Create and Send` removed
  - …this revision’s changelog is incomplete

[Operation history](https://skmtc.dev/airship/apis/airship-api/changes/api/bulk/:platform_name/post.md)

---

[API](https://skmtc.dev/airship/apis/airship-api.md) - [All operations](https://skmtc.dev/airship/apis/airship-api/llms.txt) - [OpenAPI document](https://skmtc.dev/airship/apis/airship-api/revisions/bd6ab947117a?raw)