The Blueshift REST API: 81 operations across 21 resource groups covering customer profiles and privacy operations (create/update, bulk, merge, forget/unforget, delete), event ingestion (single, bulk, summary, history, debug), product and content catalogs, segments and segment membership counts, custom user lists, campaign lifecycle (create, schedule, launch, pause, archive, trigger, bulk trigger) and campaign reporting, email/push/SMS templates and test sends, shared assets, external fetch templates, promotions, interest alerts, subscription groups, iOS Live Activities, adapters, tags and email validation. HTTP Basic authentication with an API key as the username and an empty password; two key classes (Event API key and User API key) split the surface.
Blueshift REST API declares
2 security schemes
for authenticating requests.
It accepts HTTP basic authentication (user_api_auth).
It accepts HTTP basic authentication (event_api_auth).
Paths & Operations 81
Across 72 paths, the API surfaces 81 operations — 2 DELETE, 31 GET, 3 PATCH, 28 POST, 17 PUT. They span 21 resource areas, including Adapters, Event, Campaigns, Catalog, Custom user lists, Customer, Customer groups, Search, and 13 more. Each is listed below with its method, path, parameters, and response codes.
Adapters 1
Adapters are entities that provide integration to various services with Blueshift. For example, we provide adapters for various services such as Mailgun, Sendgrid, and Sparkpost f…
GET
/api/v1/account_adapters
List adapters
2 params→ 200400401403404409413422
Event 6
Use the event APIs to send events from your servers.
A catalog is a list of items which may include content or products.
GET
/api/v1/catalogs
Get list of catalogs
→ 200400401403404409413422
POST
/api/v1/catalogs
Create a catalog
body→ 200400401403404422429500
GET
/api/v1/catalogs/{catalog_uuid}.json
Get catalog details
1 param→ 200400401403404413422429
PUT
/api/v1/catalogs/{catalog_uuid}.json
Add items to a catalog
2 paramsbody→ 200400401404413422429500
Custom user lists 8
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.
Blueshift hosts 360 degree customer profile for each of your users to represent all of their demographic, behavioral and engagement activity.
POST
/api/v1/customer_attributes/trigger_import
Trigger customer import
body→ 200401404405429500502503
GET
/api/v1/customers
Search customer
1 param→ 200400401403404409413422
POST
/api/v1/customers
Create or update customer
body→ 200400401403404409413422
POST
/api/v1/customers/bulk
Bulk create/update customer
body→ 200400401403404409413422
POST
/api/v1/customers/delete
Delete a customer
1 parambody→ 200400401403404409413422
POST
/api/v1/customers/forget
Stop tracking a customer
body→ 200400401403404409413422
POST
/api/v1/customers/merge
Merge customers
body→ 200400401403404409413422
POST
/api/v1/customers/unforget
Start tracking a customer
body→ 200400401403404409413422
GET
/api/v1/customers/{uuid}
Get customer
1 param→ 200400401403404409413422
Customer groups 2
Customer groups link multiple customer profiles to a common parent entity with shared attributes. Use these endpoints to delete a group or remove a user from a group.
You can use the customersearch API to search for events associated with a customer.
GET
/api/v1/customer_search/show_events
Get customer events
1 param→ 200400401403404409422429
Email template 5
Email template lifecycle management
GET
/api/v1/email_templates.json
List email templates
5 params→ 200400401403404422429500
POST
/api/v1/email_templates.json
Create email template
body→ 200400401403404422429500
POST
/api/v1/email_templates/test_send.json
Send a test mail
body→ 200400401403404422429500
GET
/api/v1/email_templates/{TEMPLATE_UUID}.json
Get template details
1 param→ 200400401403404422429500
PUT
/api/v1/email_templates/{TEMPLATE_UUID}.json
Update email template
1 parambody→ 200400401403404422429500
Email validation 2
Validate single or bulk email addresses to assess deliverability and risk.
POST
/api/v1/emails/bulk_validate
Validate multiple email addresses
body→ 200400401403404413429500
GET
/api/v1/emails/validate
Validate a single email address
1 param→ 200400401403404413429500
External fetch 3
External fetch is a Blueshift capability that lets you include dynamic content from external servers that is fetched “just in time” before sending a message.
GET
/api/v1/external_fetches.json
List external fetch templates
2 params→ 200400401403404422429500
POST
/api/v1/external_fetches.json
Create an external fetch template
body→ 200400401403404422429500
PUT
/api/v1/external_fetches/{template_uuid}
Update an external fetch template
1 parambody→ 200400401403404422429500
Interest alerts 2
Interest alerts store information about users' interests. When an event occurs in an area or topic in which multiple users are interested, you can trigger a single API call to sen…
POST
/api/v1/interests/alert
Update or alert customers
body→ 200400401403404422429500
GET
/api/v1/interests/user_subscriptions
Get customer subscriptions
5 params→ 200400401403404422429500
Live Activities 2
POST
/api/v1/live_activity/start
Start a Live Activity
body→ 200400401403404413422429
POST
/api/v1/live_activity/update
Update a Live Activity
body→ 200400401403404413422429
Live content 2
Use the Live content API endpoint to insert content recommendations in your website and mobile apps.
GET
/api/v1/onsite_slots.json
List live content slots
3 params→ 200400401403404422429500
POST
/live
Live content
body→ 200400401403404422429500
Promotions 2
Promotions allows you to manage promo codes that you may wish to send to your customers through Blueshift Campaigns
A segment is a list of users that satisfy a criteria. For example, you can create a segment for users who are located in the San Francisco area and run campaigns for them.
Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.
Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.
MCP tools for apis
4 tools reach this content
search_api_evangelistSearch every content type across the network at once.
find_relatedThe shared-tag relevance graph — what else covers this.
get_tagEverything one tag labels, across all content types.
guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
A second provider on the same verified email joins the account you already have.
Your account
ⓘWhere this information came from
This is an independent, third-party profile of Blueshift REST API, published by
API Evangelist. We do not operate, host, resell, or
support these APIs, and we are not affiliated with or endorsed by the company unless stated above.
Everything here is built from publicly available information — the company's own site,
developer portal, documentation, public repositories, and the specifications it publishes for public use.
Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's
public API artifacts, scored against a published rubric. They are not certifications,
endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and
you do not need to justify the request. A removed company is recorded as unrated, never scored
zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy → On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.
