REST API updates made
Q2-2024
Groups REST APIs now public
Groups REST APIs are now accessible to all customers, allowing you to seamlessly perform CRUD (Create, Read, Update, Delete) operations on groups. The BlueConic REST API v2 site was updated to include documentation on these Public Groups REST APIs.
To learn more about our groups capacity, review the article Creating and managing groups.
Group refinement capabilities introduced in the REST API
Group refinement capabilities were added to the REST API, providing filtering capabilities for group retrieval. This allows you to target subsets of groups based on attributes like last modified date or group properties. Using these capabilities, you can now efficiently access specific groups from external data warehouses and align group and profile API features.
For more information, review the Get groups for group type section of the BlueConic REST API v2 documentation site.
Segment refinement capabilities introduced in the REST API
To enhance performance and reduce data volume, segment refinement capabilities were added to the REST API. This includes:
The ability to retrieve only updated profiles within a specific segment, ensuring that your outreach or analysis is always based on the latest information. It also saves time and improves efficiency by preventing the need to sift through outdated data.
The introduction of IS_EMPTY and NOT_CONTAINS_ANY filters, helping to quickly identify gaps in data collection and allowing for targeted data enrichment efforts. This can greatly enhance the quality of the data insights you derive.
The ability to apply Objective filters to only retrieve data from customers who have consented, therefore respecting user privacy and adhering to data protection regulations. This enhances your organization's reputation and reduces the risk of legal issues.
The ability to identify profiles with UNKNOWN consent status and proactively seek consent. This helps expand the profiles you can actively engage with, while also complying with consent requirements.
For more information, review the Get profiles in segment section of the BlueConic REST API v2 documentation site.
Channels and domains now retrievable through the REST API
Through the REST API, you can now make GET requests to retrieve all channels and domains (and their respective aliases), as well as channel-specific information given a channel ID. These enhancements provide a streamlined way to link back channel and domain data already configured in a tenant with data insights captured by BlueConic listeners into your custom dashboards.
For more information, review the BlueConic REST API v2 site or the article Adding channels in BlueConic.
BlueConic REST API documentation site enhanced
Various sections of the BlueConic REST API v2 documentation site at https://rest.apidoc.blueconic.com were updated to include additional explanation, examples, and article links to the BlueConic Knowledge Base. For instance, under Create, update, or delete one or more profiles, messaging and examples were added for deleting a single profile and updating objectives for a single profile.