Overwrite users in a list

put

https://api.getblueshift.com/api/v1/custom_user_lists/overwrite_list/{list_id}

Use this endpoint to overwrite all users in a custom list.

Try the endpoint

Add the User API key as the Username and leave the Password field blank.
Click the Base URL dropdown and select the API endpoint URL for your Blueshift region.
Click Try It.

You can also try the API using Blueshift's API collection in Postman.

Behavior

If all records in the uploaded file are invalid, the list status changes to fail.
This prevents the list from remaining in a processing state and allows you to retry the overwrite with a valid file.

🚧
S3 file path
This API currently only accepts file uploaded in Blueshift S3 bucket. It is recommended to upload the file under import/custom_lists path within the Blueshift S3 bucket assigned to your Blueshift account.

Language

Credentials

Basic

base64

URL

Click Try It! to start a request and see the response here!