Blueshift

Blueshift Custom user lists API

A custom user list contains information about the users of your site such as name, email, phone number, and location. You can use this list as a segment and run campaigns for them.

Documentation GitHub OpenAPI

Business capability

Customer Segmentation Management BC-420.20

Operations 8

PUT /api/v1/custom_user_lists/add_user_to_list/{list_id} Add user to list #

PUT /api/v1/custom_user_lists/bulk_add_users_to_list/{list_id} Bulk add users to list #

PUT /api/v1/custom_user_lists/bulk_remove_users_from_list/{list_id} Bulk remove users from list #

POST /api/v1/custom_user_lists/create Create empty list #

GET /api/v1/custom_user_lists/id/{custom_user_list_id} Get customer list details #

PUT /api/v1/custom_user_lists/overwrite_list/{list_id} Overwrite users in a list #

PUT /api/v1/custom_user_lists/remove_user_from_list/{list_id} Remove user from list #

GET /api/v1/custom_user_lists/seed_lists Get seed lists from your account #

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/blueshift-custom-user-lists-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  description: These APIs will help you manage different workflows in Blueshift. Our powerful REST APIs provide an easy way to integrate your data and third party applications with Blueshift.
  version: 1.0.0
  title: Blueshift Custom user lists API
  contact:
    email: support@getblueshift.com
servers:
- url: https://api.getblueshift.com
- url: https://api.eu.getblueshift.com
tags:


# --- truncated at 32 KB (40 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/blueshift/refs/heads/main/openapi/blueshift-custom-user-lists-api-openapi.yml

Blueshift Custom user lists API

Operations 8

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification