> ## Documentation Index > Fetch the complete documentation index at: https://developers.usewave.co/llms.txt > Use this file to discover all available pages before exploring further. # Upload Manual Audience CSV > Upload a CSV of Instagram usernames or profile links to create a manual audience list, with optional per-lead icebreaker personalization. ## OpenAPI ````yaml POST /api/v1/audiences/upload-csv openapi: 3.1.0 info: title: Wave Docs description: >- ### Developer Documentation Full developer documentation is available at [developers.usewave.co](https://developers.usewave.co). ### Authentication All public endpoints require a valid API Key provided via header: * **Authorization:** `Bearer wave_live_...` ### Access Control API access is tied directly to your Wave subscription. An active or trialing subscription is required. Inactive subscriptions will receive a `403 Forbidden` error. ### Rate Limiting Requests are limited per API key using a 60-second sliding window. Tiers: **Paid** Subscription get 60 requests/min, **Trial** Subscription get 30 requests/min. Every authenticated response carries `X-RateLimit-Limit`, `X-RateLimit-Remaining`, and `X-RateLimit-Reset` headers. Exceeding the limit returns `429 Too Many Requests` with a `Retry-After` header indicating the seconds to wait. license: name: Proprietary url: https://app.usewave.co/ version: 1.0.0 servers: - url: https://api.usewave.co description: Production security: [] paths: /api/v1/audiences/upload-csv: post: tags: - Audiences summary: Upload Manual Audience CSV description: >- Uploads a CSV file to create a manual audience list. The CSV format matches the client standard: - Column 1: Instagram username or profile link - Column 2 (optional): icebreaker text personalization Automatically deduplicates leads and kicks off background lead detail enrichment and filtration. operationId: upload_audience_csv requestBody: content: multipart/form-data: schema: $ref: '#/components/schemas/Body_upload_audience_csv' required: true responses: '201': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/PublicAudienceDetailResponse' '400': description: Bad Request - Invalid parameters or input payload content: application/json: schema: $ref: '#/components/schemas/ErrorMessageResponse' '401': description: Unauthorized - Missing or invalid API key content: application/json: schema: $ref: '#/components/schemas/ErrorMessageResponse' '403': description: Forbidden - Active subscription required content: application/json: schema: $ref: '#/components/schemas/ErrorMessageResponse' '404': description: >- Not Found - The resource does not exist or belongs to another account content: application/json: schema: $ref: '#/components/schemas/ErrorMessageResponse' '422': description: Unprocessable Entity - Schema validation failed content: application/json: schema: $ref: '#/components/schemas/ErrorMessageResponse' '429': description: Rate Limit Exceeded - Request quota exceeded content: application/json: schema: $ref: '#/components/schemas/ErrorMessageResponse' '500': description: Internal Server Error - Unexpected server error content: application/json: schema: $ref: '#/components/schemas/ErrorMessageResponse' security: - HTTPBearer: [] components: schemas: Body_upload_audience_csv: properties: file: type: string contentMediaType: application/octet-stream title: File description: CSV file with username (col 1) and optional icebreaker (col 2) name: type: string maxLength: 300 minLength: 1 title: Name description: Audience list name desc: anyOf: - type: string maxLength: 1000 - type: 'null' title: Desc description: Optional audience description type: object required: - file - name title: Body_upload_audience_csv PublicAudienceDetailResponse: properties: id: type: string format: uuid title: Id description: Audience list ID name: type: string title: Name desc: anyOf: - type: string - type: 'null' title: Desc type: type: string title: Type max_scrape_count: anyOf: - type: integer - type: 'null' title: Max Scrape Count parentUsernames: anyOf: - items: type: string type: array - type: 'null' title: Parentusernames default: [] parentLinks: anyOf: - items: $ref: '#/components/schemas/PublicParentLink' type: array - type: 'null' title: Parentlinks description: >- Parent Instagram post or reel URLs used to seed a POSTS audience (with like/comment filters) default: [] raw_audience: type: integer title: Raw Audience description: Total raw leads extracted from Instagram default: 0 filtered_audience: type: integer title: Filtered Audience description: Total leads that passed the filter criteria default: 0 filters: items: $ref: '#/components/schemas/FilterConfigSchema' type: array title: Filters description: Configured filter rules default: [] created_at: anyOf: - type: string format: date-time - type: 'null' title: Created At updated_at: anyOf: - type: string format: date-time - type: 'null' title: Updated At type: object required: - id - name - type title: PublicAudienceDetailResponse description: Full detail of an audience list including filter configurations. ErrorMessageResponse: properties: status: type: integer title: Status description: HTTP status code example: 400 error: type: string title: Error description: HTTP status phrase or category example: Bad Request message: type: string title: Message description: Human-readable explanation of the error example: Invalid request parameters. details: anyOf: - {} - type: 'null' title: Details description: Granular validation failure details or contextual information type: object required: - status - error - message title: ErrorMessageResponse description: Standardized public error response structure modeled after Dripify. PublicParentLink: properties: link: type: string title: Link description: >- Instagram post or reel URL. Posts: https://www.instagram.com/p// — Reels: https://www.instagram.com/reel// example: https://www.instagram.com/p/DavbHluTbBw/ likes: type: boolean title: Likes description: Scrape accounts that liked this post default: false comments: type: boolean title: Comments description: Scrape accounts that commented on this post default: false type: object required: - link title: PublicParentLink description: >- A single parent Instagram post or reel URL used to seed a POSTS audience. The booleans configure which audiences to scrape from the post/reel: ``likes`` → accounts that liked, ``comments`` → accounts that commented. At least one must be true. FilterConfigSchema: properties: type: $ref: '#/components/schemas/ListFiltersType' description: >- Filter type: FOLLOWERS_COUNT, POST_COUNT, HAS_PROFILE_PICTURE, IS_VERIFIED, IS_PUBLIC, ACCOUNT_TYPE, HAS_KEYWORDS example: FOLLOWERS_COUNT min_value: anyOf: - type: integer - type: 'null' title: Min Value description: Minimum numeric threshold example: 500 max_value: anyOf: - type: integer - type: 'null' title: Max Value description: Maximum numeric threshold example: 50000 bool_value: anyOf: - type: boolean - type: 'null' title: Bool Value description: Boolean match (e.g. for HAS_PROFILE_PICTURE, IS_VERIFIED, IS_PUBLIC) example: true account_type: anyOf: - type: string enum: - BOTH - BUSINESS - PERSONAL - type: 'null' title: Account Type description: 'Account category to match: BOTH (any), BUSINESS, or PERSONAL' example: BUSINESS include: anyOf: - items: type: string type: array - type: 'null' title: Include description: Keywords that must be present in user bio default: [] exclude: anyOf: - items: type: string type: array - type: 'null' title: Exclude description: Keywords that must NOT be present in user bio default: [] type: object required: - type title: FilterConfigSchema description: Filter rule to filter scraped leads. ListFiltersType: type: string enum: - FOLLOWERS_COUNT - POST_COUNT - HAS_PROFILE_PICTURE - IS_VERIFIED - IS_PUBLIC - ACCOUNT_TYPE - HAS_KEYWORDS title: ListFiltersType securitySchemes: HTTPBearer: type: http description: 'Enter your API key: `wave_live_`' scheme: bearer ````