DELETE /api/lists/{id}/relationships/profiles
Remove a profile from a list with the given list ID.
The provided profile will no longer receive marketing from this particular list once removed.
Removing a profile from a list will not impact the profile's consent status or subscription status in general. To update a profile's subscription status, please use the Unsubscribe Profiles endpoint.
This endpoint accepts a maximum of 1000 profiles per call.
Rate limits:
Burst: 10/s
Steady: 150/m
Scopes:
lists:write
profiles:write
Servers
- https://a.klaviyo.com
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
id |
String | Yes |
Request headers
| Name | Type | Required | Description |
|---|---|---|---|
revision |
String | Yes |
API endpoint revision (format: YYYY-MM-DD[.suffix]) Default value: "2025-04-15" |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.