How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

BlueConic Profiles API

The following methods allow you to create, modify, retrieve properties from, and delete [BlueConic Profiles](https://support.blueconic.com/hc/en-us/articles/115001671965-Overview-BlueConic-Profiles), as well as retrieve BlueConic segment information.

BlueConic Profiles API is one of 28 APIs that BlueConic publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Profiles. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a getting-started guide, and authentication docs.

This API exposes 3 operations across 2 paths, and defines 20 schemas. It is described by OpenAPI 3.0.3, at version 100.0.

Requests are made against a single base URL, https://{blueconicHostname}/rest/v2.

3 operations 2 paths 20 schemas 2 GET1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
100.0
Base URL
https://{tenantname}.blueconic.net/rest/v2
Authentication
OAuth 2.0
Contact
License
Terms of Service
Resource Areas
1

Authentication & Security 1

BlueConic Profiles API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (oauth2) using the clientCredentials and authorizationCode flows.

  • oauth2 — Authenticates a registered OAuth 2.0 client. The Authorization code flow and Client credentials flow are supported. Make sure to select the correct flow based…

Paths & Operations 3

Across 2 paths, the API surfaces 3 operations — 2 GET, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Profiles 3

The following methods allow you to create, modify, retrieve properties from, and delete [BlueConic Profiles](https://support.blueconic.com/hc/en-us/articles/115001671965-Overview-…

GET
/profiles
Search profiles
searchProfiles 2 params → 200400401408501503
PUT
/profiles
Create, update, or delete one or more profiles
createUpdateDeleteProfiles 1 param body → 200400401403413429503
GET
/profiles/{profileId}
Get one profile
getOneProfile 11 params → 200401404408503

Schemas 20

The contract defines 20 schemas that model the data the API accepts and returns. The most detailed are profile (14 properties), BulkInputEntryV2 (12 properties), event (6 properties), BulkResultBean (5 properties). Each schema is shown below with its type and property counts.

permissions
object
1 property
BulkResultBean
object
5 properties
restriction
object
The possible restriction rules when matching profiles. Only "isMemberOfSegment" is available at the moment.
1 property
ProfileProperty
object
The rules that will be executed on this profile. The following properties have a special meaning: privacylegislation: the value passed in this property should…
4 properties
AbstractBaseBean
object
List of profile IDs that matches search criteria.
1 property
matchingGroup
object
Groups that the profile is a part of and match the segment refinements.
2 properties
lifecycleStage
object
Lifecycle stages that the profile is part of.
2 properties
profiles
object
5 properties
profileSegmentBean
object
3 properties
profile
object
The profiles that are in this segment.
14 properties
Property
object
3 properties
event
object
6 properties
TimelineResultBean
object
The feedback on the given timeline events.
4 properties
ErrorRequestBean
object
3 properties
BulkInputEntryV2
object
12 properties
ErrorBean
object
2 properties
simpleObject
object
2 properties
Criterium
object
The profile properties to match (only use "Unique Identifier" properties). This is an array of arrays; the items in the outer array have an "OR" relation, the…
2 properties
group
object
Groups that the profile is a part of.
5 properties
property
object
A property consisting of an ID and a list of values.
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

blueconic-profiles-api-openapi.yml Raw ↑

Other APIs BlueConic publishes across the network.

BlueConic Audit Events API
BlueConic Channels API
BlueConic Connections API
BlueConic Dialogues API
BlueConic Group Types API
BlueConic Groups API
BlueConic Interaction events API
BlueConic Interactions API
BlueConic Lifecycles API
BlueConic Listeners API
BlueConic Models API
BlueConic Notebooks API
Where this information came from

This is an independent, third-party profile of BlueConic Profiles 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.