---
title: "Import audience members"
method: POST
path: "/v1/audiences/{audienceId}/memberships/import"
tags: ["Audiences"]
---

# Import audience members

`POST /v1/audiences/{audienceId}/memberships/import`

## Request

- Base URL: `https://yourbaseurl.talon.one`
- URL: `https://yourbaseurl.talon.one/v1/audiences/{audienceId}/memberships/import`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `Authorization`
- TypeScript: <https://skmtc.dev/talon/apis/management-api/docs/v1/audiences/:audienceId/memberships/import/post.ts> (a function with typed inputs; its response is checked against the schema)

> [!note] Management API endpoints are **not** meant to be used in real-time integrations that directly serve your end users. Rate limit: 3 requests per second.

Upload a CSV file containing the integration IDs of the members you want to
add to an audience.

The file should be sent as multipart data and should contain only the
following column (required):

- `profileintegrationid`: The integration ID of the customer profile.

The import **replaces** the previous list of audience members.

> [!note] We recommend limiting your file size to 500 MB.

## Example

```text
profileintegrationid
charles
alexa
```

## Path parameters

- `audienceId` integer, required

## Request body `multipart/form-data`

- object
  - `upFile` string, binary: The CSV file containing the data that is being imported.

## Response `200`

OK

- Import
  - `id` integer, required: The internal ID of this entity.
  - `created` string, date-time, required: The time this entity was created.
  - `accountId` integer, required: The ID of the account that owns this entity.
  - `userId` integer, required: The ID of the user associated with this entity.
  - `entity` string, required: The name of the entity that was imported.
  - `amount` integer, required: The number of values that were imported.

## Other responses

- `400`: Bad request
- `401`: Unauthorized - Invalid API key
- `404`: Not found

---

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